Receive inbound SMS messages Webhook

If you want to receive SMS messages from your subscribers we can have them delivered to you in real time. When you buy a number capable of receiving SMS, set the inbound configuration for the number by specifying your endpoint and we will send inbound messages to you as soon as they are delivered to us by a mobile network operator.
Name of the default format or renderer for the inbound SMS messages is MO_JSON_2, and is documented in this section.

Learn more about the SMS channel and its use cases

post

https://{yourDomain}/your/webhook/path

Request Body schema:

application/json

collapse all -

results

Array of objects

Array

messageId

string

Unique SMS ID.

from

string

Sender ID that can be alphanumeric or numeric.

string

The recipient number.

text

string

Received message content.

cleanText

string

Text of received message without a keyword (if a keyword was sent).

keyword

string

Keyword extracted from the message text.

receivedAt

string <date-time>

Date and time when Infobip received the message.

smsCount

integer <int32>

Long SMS messages have a character limit on how much can be sent over one message.

Longer messages will be split up into multiple messages and sent separately.

This is the total count of messages one SMS was sent over.

price

object

Price of the sent SMS.

currency	string The currency in which the price is displayed.
pricePerMessage	number <double> The price per individual message.

callbackData

string

The callback data sent through the callbackData field in your fully featured SMS message.

messageCount

integer <int32>

Number of returned messages in this request.

pendingMessageCount

integer <int32>

Number of remaining new messages on Infobip servers ready to be returned in the next request.

Responses

200

Your server returns this code if it accepts the callback

Request samples

Payload

Content type

application/json

Received SMS

Copy

Collapse all


{"results": 
[
{"messageId": "817790313235066447",
"from": "385916242493",
"to": "385921004026",
"text": "QUIZ Correct answer is Paris",
"cleanText": "Correct answer is Paris",
"keyword": "QUIZ",
"receivedAt": "2016-10-06T09:28:39.220+0000",
"smsCount": 1,
"price": 
{"pricePerMessage": 0,
"currency": "EUR"
},
"callbackData": "callbackData"
}
],
"messageCount": 1,
"pendingMessageCount": 0
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products

Learn more

Service status

Privacy documents Terms of use