21 Dec Receive an Inbound SMS Message

 

If a short code or a long number has been purchased and inbound messages are required then a CallBack URL for inbound messages must be setup in order for Telintel to send a request for each mobile originated (MO) message. Account Administrators can log into their Telintel Managed Messaging Platform account and add an Inbound SMS Message Callback URL in the “My Profile > Settings” section.

 

4.1 HTTP Methods

The request parameters are sent via a GET (default) to your Callback URL and Telintel will be expecting a 200 OK response, or it will either keep retrying for up to 24 hours or until the maximum amount of retry attempts are reached (up to 10 retry attempts).

4.2 Request Parameters

In the header of the request for “messageId

Parameter Name

messageId

Description

The unique message ID reference assigned to each submitted SMS.

Variable Type

String

Mandatory?

YES

 

In the header of the request for “dlrDeliverInitTStamp

Parameter Name

dlrDeliverInitTStamp

Description

Timestamp of when the delivery receipt is initially sent, used in the following format:
yyyy-MM-dd HH:mm:ss.SSS-z
Example:

 

Variable Type

String (Date)

Mandatory?

YES

 

In the header of the request for “mblNetworkReceiveTStamp

Parameter Name

mblNetworkReceiveTStamp

Description

Timestamp where the message was received from the mobile network, used in the following format:
yyyy-MM-dd HH:mm:ss.SSS-z
Example:

 

Variable Type

String (Date)

Mandatory?

YES

 

In the header of the request for “senderId

Parameter Name

senderId

Description

The destination number entered into the mobile handset / address for the SMS.

Variable Type

String

Mandatory?

YES

 

In the header of the request for “recipentNumber

Parameter Name

recipentNumber

Description

The mobile handset number where the request was made / where the message originated. The Source address may be numeric or alphanumeric (ex: Telintel).

Variable Type

String

Mandatory?

YES

 

In the header of the request for “messageKeyword

Parameter Name

messageKeyword

Description

The first word in the message body, matching an approved campaign in the account.

Variable Type

String

Mandatory?

NO

 

In the header of the request for “messageText

Parameter Name

messageText

Description

The body of the incoming message.

Variable Type

String

Mandatory?

YES

 

In the header of the request for “concatInfo

Parameter Name

concatInfo

Description

A JSON object for:

  • concatPar (the part number of this message within the set (beginning with 1)
  • concatTotal  (the total number of parts in this concatenated message set)
  • concatRefid (the reference ID number (all of themessage parts share the same reference ID)

yyyy-MM-dd HH:mm:ss.SSS-z
Example:


If the message is not concatenated-type, this object will be null.

Variable Type

String

Mandatory?

YES

The request body will contain a JSON object.