Receive an inbound message

To forward a new incoming message, tyntec makes a POST request to your $callbackURL. tyntec’s application will retry delivery every 10 seconds in case your application does not accept the inbound message (200, 201, 202 status code). Retries are paused for 10 minutes after every 100 consecutive unsuccessful delivery attempts. tyntec's application will retry for a maximum of 48 hours.

The following code block gives a basic example of how the request will look like:

Receiving messages (JSON):

curl
-X POST
-H "Content-Type: application/json"
-d
'{
"from":"+491622943176",
"to":"customer_account",
"message":"This is an example.",
"sentDate":"1454066954667",
"requestId":"12-75cfafba-8799-4f2b-8505-ece6af6abf01",
"originalRequestId":"f595e75b-2808-4def-883c-82913b7f8365",
}'
https://rest.customer.com/inboundmessages/

Parameter

Possible Values

Description

from

international phone

number

The phone number of the user sending the message

to

account name

The name of the account that you use for receiving incoming messages

message

UTF-8 encoded string

The message sent by the user

sentDate

long integer

The timestamp showing when the message was submitted by the user

requestId

UTF-8 encoded string

The unique identifier provided for each request (retries will use the same requestId as the original request for easy message tracking)

originalRequestId

UTF-8 encoded string

The unique identifier of the outbound message which generated this user reply

ott

UTF-8 encoded string

The name of the messaging app from which the message comes