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
- A user sends an SMS to your MO number
- Wavecell receives the SMS on your behalf
- 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.