Inbound SMS

Wavecell SMS API exposes a webhook mechanism to let you receive Inbound SMS (SMS sent to your virtual numbers) on a callback URL of your choice. Whenever you receive inbound SMS, the Wavecell SMS platform sends a POST request to the endpoint of your choice with a JSON body containing the inbound SMS and the associated data.

Requirements

To use Wavecell inbound SMS capabilities, liaise with your account manager to activate the following:

  • A virtual mobile number where your user will send their SMS
  • An inbound SMS callback URL: indicate us to which URL Wavecell platform should forward the inbound messages addressed to your MO number (you can configure your callback using the POST webhook endpoint)

Inbound SMS flow

  1. A user sends an SMS to one of your virtual numbers
  2. Wavecell receives the SMS on your behalf
  3. Wavecell programmatically sends the SMS to the callback URL configured for your virtual number by sending a POST request there.
  4. The POST request body, in JSON format contains the SMS body and all associated data (UMID, source, destination, encoding, timestamp)

Webhook format

Sample of POST request body sent to your callback URL:

{
    "umid":"216F40E1-3DAA-4725-B7C6-000181A794CE",
    "type":"inbound",
    "source":"+11111111111",
    "destination":"+22222222222",
    "body":"Hello, World!",
    "encoding":"UCS2",
    "receivedAt":"2018-06-06T10:21:21.0917564Z",
    "version":2
}

Request body - Parameters description:

parameter name Description
umid Unique message ID for the inbound message
type Type of message: inbound
source Originating address of the SMS (sender number)
destination Destination address of the SMS (MO number)
body Content of the SMS
encoding Encoding used in the SMS body (GSM7 / UCS2)
receivedAt Date and time of reception (GMT)
version Version of the MO webhook: 2

NB: if the request you receive has a different structure than the sample above, please contact support@wavecell.com to activate the latest format for your account.