Inbound SMS

Requirements

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

  • A virtual mobile number (MO number) where your user will send their SMS
  • A MO webhook: indicate us to which URL Wavecell platform should forward the inbound messages addressed to your MO number.

Inbound SMS flow

  1. A user sends an SMS to your MO number
  2. Wavecell receives the SMS on your behalf
  3. Wavecell programmatically transmits the SMS to the callback URL configured for your MO webhook including all the information linked to the SMS (sender number, date and time, MO number, UMID, encoding)

Callback format

Sample

{
    "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
}

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 callback you receive has a different structure than the sample above, please contact support@wavecell.com to activate the latest format for your account.