MTC Send Message REST Service

Description

The MTC Send Message REST Service allows authorized third parties to send messages to Mobile Text Connect conversations. This is for consumer to agent messages. If no conversation exists then one is created.

SendMessage

Format: JSON
Method: POST

URI (regionally defined):

  • North America : https://api.contactatonce.com/api/v1.0/MTC/SendMessage
  • Australia : https://api.contactatonce.com.au/api/v1.0/MTC/SendMessage
  • Europe : https://api.contactatonce.co.uk/api/v1.0/MTC/SendMessage

Request   
ParameterTypeRequiredDescription
FromPhoneNumberStringRequiredThe Consumer's mobile phone number.
FromPhoneNumberCountryCodeStringOptional, if included in the FromPhoneNumberThe origination country of the Consumer's mobile phone number.
ToPhoneNumberStringRequiredThe Mobile Text Connect number assigned to the account.
ToPhoneNumberCountryCodeStringOptional, if included in the ToPhoneNumberThe origination country of the Mobile Text Connect number assigned to the account.
MessageTextStringRequiredMessage to be sent.
MessageIdStringRequiredUnique Id assigned by the third party to the Message.
MediaUrlsString ArrayOptionalLink(s) to media to be sent.

Response  
ParemeterTypeDescription
StatusBoolean
  • 0 - Success
  • 1 - Failure

FailureDescriptionStringNullable. Descriptive text that describes user exceptions.

Sample Header- JSON

Authorization: Basic {YOUR_API_KEY}
Accept: version=2; 

Sample POST- JSON

{
"ToPhoneNumber":"7704508432",
"FromPhoneNumberCountryCode":"1",
"FromPhoneNumber":"7708534076",
"ToPhoneNumberCountryCode":"1",
"MessageText":"Hey, did you see new Batmobile commercial",
"MessageId":"12633881",
"MediaUrls":[
"https://www.youtube.com/watch?v=H-VDkFZsb1Y",
"https://www.youtube.com/watch?v=KhGdSzc3Hgk"
]
}

Sample JSON Response

{
    "Status": 0,
    "FailureDescription": null
}

Back to Top

If you require assistance, please click on the Chat button below, call 1 (678) 648-6961 or email us at support@contactatonce.com.