Configure the SMS interface

The SMS interface specifies how and where to forward SMS from devices under this service policy.

The following connections are available:

• Web Portal (default) - Access SMS directly in the emnify Portal
• Webhook - Configure a URL to receive SMS sent from your device
• SMPP - Set up a direct SMPP connection to emnify

Webhook

You can use the SMS webhook to receive SMS and delivery notifications in your application.

Add webhook

Follow these steps to configure the webhook as your SMS interface.

Default

1. Log in to your emnify account.

2. Navigate to your Device Policies.

3. Under Service Policies, choose the policy you want to update and click Details.

4. Find the SMS interface section. Select Webhook, then click Configure Webhook.

   

5. Provide the URL for your webhook. Optionally, you can provide a secret key to prevent unauthorized access. Then, click Add Webhook.

   

Beta

1. Log in to your emnify account.

2. Navigate to your Device Policies.

3. Under Service Policies, choose the policy you want to update and expand the policy details.

4. In SMS, find the SMS interface section. By default, the badge next to the section title reads Web Portal.

5. Click Edit to open the SMS console settings configuration modal.

6. In the SMS console list, select Webhook.

7. In Add Webhook to forward SMS to, provide the following:

   • In the URL field, enter the public URL of your server to receive API requests.
   • In the Secret key field, enter a key to prevent unauthorized access and your server can decline requests if the key is incorrect.

8. Review your configuration, then click Add Webhook.

   warning

   The secret key isn't displayed after you add the webhook. Keep this key in a safe place.

info

When you want to send an SMS from the device to your application, your device should send the SMS to an invalid MSISDN with seven digits or less.

Delivery notification as received in Make (Integromat) webhook for SMS with ID: 46638644

Mobile originated SMS from the device as received in Integromat webhook

Edit webhook

Default

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and click Details.
4. Find the SMS interface section.
5. Click Edit to change the URL or delete the secret key.
6. Review your changes, then click Save webhook.

Beta

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and expand the policy details.
4. In SMS, find the SMS interface section with the Webhook badge.
5. Click Edit to open the SMS console settings configuration modal.
6. In Add Webhook to forward SMS to, edit the URL or remove the Secret key. You can also click Reset all to clear both fields.
7. Review and select Save changes.

SMPP

Short Message Peer-to-Peer (SMPP) is a protocol that the telecommunication industry uses to exchange SMS messages between short message service centers (SMSC) and external short messaging entities (ESME). Telematics platforms, SMS services, and operators often use SMPP to enable sending SMS to and from devices.

Configure SMPP as your SMS interface

Default

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and click Details.
4. Find the SMS interface section and select SMPP.

When you select SMPP as your SMS interface, you're given a System ID and Password to access the emnify SMPP Server.

Beta

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and expand the policy details.
4. In SMS, find the SMS interface section. By default, the badge next to the section title reads Web Portal.
5. Click Edit to open the SMS console settings configuration modal.
6. In the SMS console list, select SMPP. When you select SMPP, you're given a SMPP Server, Workspace ID, and SMPP Password.
7. Review and select Add SMPP.

warning

The SMPP Password isn't displayed again, so store it in a safe place.

tip

For an example of integrating SMPP with a third-party application, see emnify SMS via SMPP integration with Gurtams' flespi and Wialon.

Reset the SMPP password

Default

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and click Details.
4. In the SMS interface section under SMPP, click Reset Password.

Beta

1. Log in to your emnify account.
2. Navigate to your Device Policies.
3. Under Service Policies, choose the policy you want to update and expand the policy details.
4. In SMS, find the SMS interface section with the SMPP badge.
5. Click Edit to open the SMS console settings configuration modal.
6. In SMPP details, click Reset next to SMPP Password.
7. Review and select Save changes.

warning

The SMPP password isn't displayed again, so store it in a safe place.