Inbound Messages (MO)

When you rent or update a number, you are able to define a callback Url ("inboundSmsCallbackUrl") that will receive the inbound SMS messages.

🚧

NOTE

You can receive inbound messages from the same country the number belongs to.
Inbound messages that are originated from a country that is different from the country of the Number may not be always received.

Your service will receive the following payload:

{
  "messageId": string,
  "from": string,
  "to": string,
  "message": string,
  "parts": integer,
  "originatingService": "Sms",
  "direction": "Inbound",
  "receivedDate": string
}

KEY

DESCRIPTION

messageId

The id of the inbound message.

from

The sender of the inbound message.

to

The recipient of the inbound message (your number).

message

The body of the inbound message.

parts

The message's total parts.

originatingService

The originating service of the message (Sms)

direction

The direction of the message (Inbound)

receivedDate

The date that the inbound message was received (ISO format)

An example payload is shown below:

{
  "messageId": "700bbc09-0556-4e86-bad1-215a8020e111",
  "from": "+306999999999",
  "to": "+306911111111",
  "message": "This is the actual body of the inbound message",
  "parts": 1,
  "originatingService": "Sms",
  "direction": "Inbound",
  "receivedDate": "2018-01-17T13:02:08Z"
}

👍

Inbound Retry Policy

When Routee POSTs back to your service, an HTTP 200 OK response must be returned within 2 seconds. If Routee doesn't receive a 200 OK response within 2 seconds will drop the connection and will try to POST again (up 12 retries for 24 hours max) with the following retry policy after the initial callback attempt:

1st retry: 30 sec
2nd retry: 1 minute
3rd retry: 2 minutes
4th retry: 5 minutes
5th retry: 10 minutes
6th retry: 15 minutes
7th retry: 30 minutes
8th retry: 1 hour
9th retry: 2 hours
10th retry: 4 hours
11th retry: 8 hours
12th retry: 24 hours

📘

Your inbound messages can, also, be tracked through the SMS tracking resource.

See an example of how to use a Number with your SMS Campaign How to use a Number with your SMS Campaign


What’s Next