SMS API Frequently Asked Questions
How can replies be received through the API?How can replies be matched to the sent message?
How will the sending number be displayed?
Can outbound messages sent through the API come from one number?
How can multiple messages be sent through the API?
What is the character limit on an SMS message?
How does the API communicate with the SMS gateways?
Can messages be encrypted?
How does delivery tracking work?
Can line breaks be added to SMS messages?
Is sample code provided?
How can replies be received through the API?
There are two ways of receiving replies back to the API:
Polling the SMS Gateway
Replies are stored on the SMS Gateway until a request from the API polls for the messages. Messages can then be downloaded to the API and handled by your application.
Pushing messages
Messages can also be pushed to your application through HTTP GET variables when they’re received by the SMS Gateway.
How can replies be matched to the sent message?
Messages sent through messagemedia's APIs can be tagged with an internal message ID. This will then be attached to corresponding replies, thereby allowing your system to match the reply to the originating message.
How will the sending number be displayed?
As part of messagemedia's infrastructure, all messages sent through an API will appear to have come from a random number. This range of numbers are used as part of the process for matching replies to the relevant message.
This means a recipient will see a different sending number for most messages received from the API. However, recipients need only reply to the message - their reply will be delivered back to the original sender.
For an inbound service, a dedicated number must be allocated to your account.
Can outbound messages sent through the API come from one number?
messagemedia can provide API clients with a dedicated number that will display all messages as being received from the same number. A dedicated number will also allow you to operate an inbound service, receiving messages originated from a handset.
What is the character limit?
Messages are limited to 160 characters. However, messagemedia's APIs have the ability to split any messages over 160 characters into multiple messages. These messages include a reference that the message is continued, and messages are sent to the recipients at intervals of 30 seconds.
How can messages be sent to multiple numbers through the API?
messagemedia APIs can send messages to multiple numbers by adding phone numbers and messages to the API's internal message batch. These messages can then be sent out to all the recipients in one batch.
How does the API communicate with the SMS gateways?
The API communicates with our SMS gateways through HTTP on Port 80 (or port 443 for secure mode). Proxy servers and authentication can also be handled by the API. If your firewall requires that specific addresses be permitted access, please contact us.
How does delivery tracking work?
Delivery tracking can be used to record the exact time/date that messages are received on a recipient's handset. Delivery reports are sent to the API in the same manner as replies, but with no message text. The status of the delivery report will either be: P for pending, D for delivered or F for failed, indicating the status of the message. Messages will be marked as Pending until it is either marked as delivered or fails.
Can messages be encrypted?
Yes, the secure mode in the SMS APIs enables messages to be sent using HTTPS over port 443
Can line breaks be added to SMS messages?
New lines can be created using your operating system's standard newline character, for example: \r\n
Is sample code provided?
All APIs include sample code in the documentation or API package. Additional code examples in Visual C++, VB.NET and ASP are available for the COM API.
Contact messagemedia
Enquiries: 1-866-884-8611
Free Trial Now!
See for yourself why so many US businesses and organizations choose messagemedia.
See messagemedia
In Action!
Simply enter you phone number and select a message.