# SMS Gateway Configuration

> Documentation of mobile-calendar (https://www.mobile-calendar.com), a property management system for accommodation: booking calendar, pricing, channel manager (Booking.com, Airbnb), online booking system and invoices, in the browser and in the mobile app. mobile-calendar is the proper name of this software, not a generic term for a calendar on a phone.

Communication > SMS > SMS Gateway Configuration
URL: https://docs.mobile-calendar.com/en/guides/communication/sms/sms-gateway-configuration

**Web Application**

[YouTube](https://www.youtube.com/watch?v=AtfVm9Qc37M)

## Introduction

This feature is available on the **Professional** plan. You can compare plans in the article [Which features differ between subscriptions?](https://docs.mobile-calendar.com/en/guides/subscription/subscription-faq/what-functions-differ-between-subscriptions).

The SMS Gateway is a service that lets you send SMS messages from the system to your guests. You can use the SMS Gateway to send reservation notifications, check-in and check-out reminders, and other information.
To use the SMS Gateway, you need to register with SMSAPI and complete a simple configuration in the mobile-calendar system.

> **SMS Gateway feature for businesses only!**
>
> This feature is available only to businesses due to legal regulations and SMS operator requirements.

## Instructions

**Registering with SMSAPI.pl**

- Go to https://www.smsapi.pl/
- In the top menu bar, click the **Registration** button.

- Fill in the form.

![Registering with SMSAPI](https://docs.mobile-calendar.com/media/85/8544b8cb-8090-4e74-8b20-4e7b2d8e5ffa-b2afbee8.jpg)

- In the **Business email** field, enter your business email address.
- In the **Password** field, enter a password.
- In the **Full name** field, enter your first and last name.
- In the **Mobile phone number** field, enter your phone number.
- **Accept** the terms and conditions, personal data processing rules, and privacy policy.
- Click the **Create free account** button.
- Enter the verification code sent to the phone number you provided.
- Log in to the email address you entered in the form and find the message from SMSAPI. In the email, click **Activate account**.
- Log in using the email address and password you entered in the form.
- To activate your account, fill in your company details.

![Add your company details in SMSAPI](https://docs.mobile-calendar.com/media/8e/8ea1fb8f-8ef2-47f2-a2c7-a5ab448b3628-4b158f86.png)

- Your account will be activated after SMSAPI completes its verification.

**Configuring the SMS Gateway in mobile-calendar**

- In the left-hand menu, click **Communication** -> **SMS Gateway**.

- Complete the account setup wizard.

![Generating an API key](https://docs.mobile-calendar.com/media/ba/ba71077e-ddf4-4e0d-abbf-117eb23d440f-fa732f4f.jpg)

- In the **SMS Gateway** field, select **smsapi.pl** from the dropdown list.
- In the **API Key** field, enter the key.

- *Where can you find the API key?*

    - Log in to https://www.smsapi.pl/
    - In the left-hand menu, click **API Settings** -> **API Tokens (OAuth)**.

    ![Generating an API key](https://docs.mobile-calendar.com/media/c4/c4ae9a69-11b4-4188-b23a-23be2a2c088f-b25e16cb.jpg)

    - Click the **Generate token** button.
        - In the **Token name** field, enter a name.
        - For **Token expiration date**, select **Never**.
        - **Select** all the checkboxes.
        - Click the **Generate token** button.
        - Copy the generated token and paste it into the **API Key** field in mobile-calendar.

- In the **Default phone area code** field, select an area code from the dropdown list, for example, +48.

> **Default phone area code**
>
> The default phone area code will be added automatically to the client's phone number (e.g. +48). If you enter a phone number with an area code in a reservation (e.g. +1), the system will use the one you provided instead of the default (+48).

- Click the **Save** button.

- To check that the SMS Gateway is working, go to the **Test message** section.

![Generating an API key](https://docs.mobile-calendar.com/media/32/32517d38-d73e-4010-882d-46b4ea32b113-951f120e.jpg)

- In the **Phone** field, select an area code from the dropdown list, then enter the phone number that will receive the test message.
- In the **Test message** field, enter a test message.
- Click the **Send test message** button.
- If the message arrives on your phone, the SMS Gateway is configured correctly.

---

**Mobile Application**

## Introduction

The SMS Gateway lets you send SMS messages to guests from the app. To connect, you need an account with SMSAPI and an API key from its panel.

> **SMS Gateway is for businesses only!**
>
> This feature is available exclusively to businesses due to legal regulations and SMS operator requirements.

## Instructions

- In the bottom menu, go to the **More** tab.

- Go to **Communication** -> **SMS Gateway**.

- The "SMS Gateway" form will appear on the screen.

    - In the "Gateway" section, select **smsapi.pl** or **smsapi.com**, depending on where you have an account.

    - Paste the key from the SMSAPI panel (**Settings** -> **API**) into the **API Key** field.

    - In the "Default country calling code" section, tap the country and select it from the list.

- Tap the **Save** button.

![SMS Gateway form](https://docs.mobile-calendar.com/media/f6/f6c9aca5-f555-4f39-83e0-406177c4719c-8b7021b1.png)

- The configuration will be saved. **Send test message** will appear on the screen.

#### Test message

- After saving the key, fill in **Country calling code**, **Phone number**, and **Message content**.

- Tap the **Send** button.

#### Disconnecting the gateway

- In the top-right corner, tap the **Three-dot menu** icon and select **Disconnect**.

- In the confirmation window, tap **Yes, delete**.

- The gateway configuration will be deleted.
