Skip to main content

Configure the SMS interface

The SMS interface specifies how and where to forward SMS from devices under this service policy. SMS interfaces are managed in the Device Policies section of the emnify Portal.

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​

  1. In Service Policies, choose the policy you want to update and expand the policy details.

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

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

  4. In the SMS console list, select Webhook.

  5. 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.

  6. 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​

  1. In Service Policies, choose the policy you want to update and expand the policy details.
  2. In SMS, find the SMS interface section with the Webhook badge.
  3. Click Edit to open the SMS console settings configuration modal.
  4. 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.
  5. 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​

  1. In Service Policies, choose the policy you want to update and expand the policy details.
  2. In SMS, find the SMS interface section. By default, the badge next to the section title reads Web Portal.
  3. Click Edit to open the SMS console settings configuration modal.
  4. In the SMS console list, select SMPP. When you select SMPP, you're given a SMPP Server, Workspace ID, and SMPP Password.
  5. 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​

  1. In Service Policies, choose the policy you want to update and expand the policy details.
  2. In SMS, find the SMS interface section with the SMPP badge.
  3. Click Edit to open the SMS console settings configuration modal.
  4. In SMPP details, click Reset next to SMPP Password.
  5. Review and select Save changes.
warning

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

Last updated on