SMS API introduction

The SMS API enables you to send and receive text and short messages to and from SMS-capable devices over internet and cellular networks. The SMS API ensures the message is compatible for network delivery. It also notifies the sender about the message status, so that you can track if the message was delivered or not.

You can send the following requests to the SMS API:

  • MT SMS – sends a mobile terminated (MT) SMS messages to an IoT device.

    You send SMS messages to both AnyNet SIMs and third party SIMs. However, SMS messages sent to and received from third party SIMs will incur extra costs. For information about SMS API billing, see Understanding SMS charges on the CSV invoice.

  • Cancel SMS – cancels a previously send MT SMS message.

  • Status update – requests the delivery status of an SMS message.

You can receive the following messages from the SMS API:

  • MO SMS – the AnyNet Messaging Service intercepts and routes mobile originated (MO) SMS messages (sent to a specific API MSISDN) to the customer's SMS application.
  • Delivery receipts – returned to the customer's SMS application or alternatively to a different application.

Eseye will onboard you when you subscribe to SMS API.

You will need:

  • A Infinity Classic account, with all your AnyNet SIMs linked to this account.
  • SMS Allowlist – contains a list of permissible MSISDNs for mobile originated (MO) and mobile terminated (MT) messages. Messages sent to or received from these MSISDNs are processed.
  • SMS Blocklist – contains a list of banned MSISDNs for MO and MT messages. Messages sent to or received from these MSISDNs are blocked.
  • Optional server IP address Allowlist – contains a list of permissible IP addresses that can make incoming requests.
  • Mobile Originated (MO) URL – where the SMS API will post incoming MO messages.
  • Receipt URL – where the SMS API will post delivery receipts.

Eseye will provide you with the following:

  • SMS API account username.
  • SMS API account password.
  • SMS API destination MSISDN that is routed to SMS API.

Request SMS API

Eseye does not supply historic data. You must store any data you want to retain.

Sending requests to the SMS API

Send SMS API requests to the following URL:

  • https://messaging.eseye.com/<request>/index/post

    where <request> is the SMS API request.