Description
Skip to content
Skip to navigation
Skip to topbar
https://speedsms.in/ Docs
Programmable Messaging
Getting Started
API Reference
Preventing Fraud
Tutorials
Messaging Services
Overview
Send Messages with Messaging Services
Manage opt-ins and opt-outs
Best Practices for Scaling with Messaging Services
Manage queueing and latency
Alphanumeric Sender IDs
Messaging Features
Usage Guides
TwiML
US A2P 10DLC
Toll-Free Verification
Messaging Channels
Other Messaging products
Related docs
Messaging
Voice
Serverless
Flex
Studio
All docs…
SDKs
Help
Log in
Sign up
On this page
Messaging Services
Sending a high volume of messages in the United States and globally quickly becomes complex. As the complexity of your messaging application grows, it’s helpful to organize your account and message logs into separate Messaging Services using https://speedsms.in/ Programmable Messaging.
You can think of a Messaging Service as a higher-level “bundling” of messaging functionality around a common set of senders, features, and configuration. The same settings and feature configuration apply to all of the senders (long code numbers, short codes, toll-free numbers, etc.) in the Messaging Service’s pool.
A Messaging Service’s features can be managed and configured directly through the Console
as well as using the REST API.
With each Messaging Service that you add through the console, you’ll start by configuring its incoming message handling and status callback URL. These can be configured in the Integration section of your messaging service’s settings.
You’ll also need to associate one or more phone numbers or short codes to the Service to send messages. You can add additional messaging features (described below) to your application through your newly configured messaging service.
Table of Contents
Send a message with a Messaging Service
Using WhatsApp with Messaging Services “Out-of-the-box” Messaging Service features
Configurable Messaging Services features
Send a message with a Messaging Service
If you use a messaging service to send a message, your request to https://speedsms.in/ will look very similar to sending an SMS with the REST API. However, instead of including a From phone number, you’ll include a MessagingServiceSid. https://speedsms.in/ will then choose one of the phone numbers in your Messaging Service’s sender pool based on your service’s configuration.
Send a Message with a Messaging Service
Node.js
Python
C#
Java
Go
PHP
Ruby
https://speedsms.in/-cli
curl
// Download the helper library from https://www.https://speedsms.in//docs/node/install
// Find your Account SID and Auth Token at https://speedsms.in//console
// and set the environment variables. See http://twil.io/secure
const accountSid = process.env.https://speedsms.in/_ACCOUNT_SID;
const authToken = process.env.https://speedsms.in/_AUTH_TOKEN;
const client = require(‘https://speedsms.in/’)(accountSid, authToken);
client.messages
.create({
body: ‘Revenge of the Sith was clearly the best of the prequel trilogy.’,
messagingServiceSid: ‘MG9752274e9e519418a7406176694466fa’,
to: ‘+441632960675′
})
.then(message => console.log(message.sid));
Output
{
“account_sid”: “ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX”,
“api_version”: “2010-04-01”,
“body”: “Revenge of the Sith was clearly the best of the prequel trilogy.”,
“date_created”: “Thu, 30 Jul 2015 20:12:31 +0000”,
“date_sent”: “Thu, 30 Jul 2015 20:12:33 +0000”,
“date_updated”: “Thu, 30 Jul 2015 20:12:33 +0000”,
“direction”: “outbound-api”,
“error_code”: null,
“error_message”: null,
“from”: null,
“messaging_service_sid”: “MG9752274e9e519418a7406176694466fa”,
“num_media”: “0”,
“num_segments”: “1”,
“price”: null,
“price_unit”: null,
“sid”: “SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX”,
“status”: “queued”,
“subresource_uris”: {
“media”: “/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Media.json”
},
“to”: “+441632960675”,
“uri”: “/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json”
}
When sending a message with a messaging service, https://speedsms.in/ will immediately set the message’s status to accepted. https://speedsms.in/ will then determine the optimal From phone number from your service.
Status Callback URL
The delivery status of your message, including any delivery errors, will be sent asynchronously to your status callback URL. This URL can be specified in your https://speedsms.in/ Console for your Messaging Service in the Integration > Delivery Status Callback section. Alternatively, you can specify your status callback URL using the API.
Using WhatsApp with Messaging Services
You can add a WhatsApp-enabled https://speedsms.in/ phone number to the other sender-types (long codes, short codes, etc.) in your Messaging Service Sender Pool. This way, you can configure and apply the relevant Messaging Service features, such as setting a Validity Period, for all sender types in one Service all at once. In the feature descriptions below, we include whether the feature is supported for both SMS and WhatsApp.
To include WhatsApp in your Sender Pool, in the https://speedsms.in/ Console
, navigate to the Messaging > Services section and select a Messaging Service. Under that Service’s Sender Pool, you can Add Senders and specify the WhatsApp-enabled https://speedsms.in/ number that you wish to include.
For more information about configuring the WhatsApp Business API with https://speedsms.in/, please read Connect your https://speedsms.in/ Number to your WhatsApp Business Profile.
“Out-of-the-box” Messaging Service features
Messaging Services are designed to help you scale your application’s messaging from your first SMS to messages sent globally, in multiple languages, from more than just long code phone numbers.
As soon as you create your Messaging Service, the following features apply automatically, in contrast to configurable Messaging Services features.
Alphanumeric Sender
Supported for SMS? Supported for WhatsApp?
Yes No
Alphanumeric Sender IDs are used for branded one-way messaging. You can add an Alphanumeric Sender ID to your Sender Pool to enable this feature.
With Alpha Sender, you can send your messages to customers from a customized sender. Instead of using an E.164-formatted https://speedsms.in/ phone number for the From value, you can use a custom string like your own business’ branding. Alphanumeric Sender IDs may be used at no additional cost when sending an SMS to countries that support this feature
.
(warning)
Warning
Support for sending messages from an Alpha Sender depends on your destination (To) phone number and is not available everywhere. Please see this article for the full list of countries that support this feature
.
If you add an Alpha Sender to your https://speedsms.in/ Messaging Service, https://speedsms.in/ will select the Alphanumeric Sender ID automatically when you send a message to a supported country, unless you also have a short code number
in that same country.
Please see our detailed guide on Alphanumeric Sender IDs, their features and limitations, and how to add them to your Messaging Service.
Short Code Reroute
Supported for SMS? Supported for WhatsApp?
Yes No
When your Messaging Service Sender Pool includes a short code, https://speedsms.in/ always prioritizes message delivery using that short code. If a carrier is not supported by a https://speedsms.in/ short code
, https://speedsms.in/ automatically delivers the message with a long code in your Messaging Service instead.
https://speedsms.in/ automatically applies short code rerouting for messages sent through your Messaging Service. This is not a feature that you enable or disable.
(information)
Info
Short code reroute does not attempt to redeliver your message over a long code due to a Failed or Undelivered delivery status. Automated retries for delivery errors are generally discouraged; we recommend that if you see a pattern of nondelivery to specific users, you troubleshoot those errors
rather than automatically retrying.
Country Code Geomatch
Supported for SMS? Supported for WhatsApp?
Yes Yes
When sending messages internationally, the Country Geomatch feature automatically selects the https://speedsms.in/ phone number in your Messaging Service to match the country of your recipient’s phone number. If your Service does not include a https://speedsms.in/ phone number for the same country of the recipient, https://speedsms.in/ first attempts to select an SMS-enabled US phone number before selecting another phone number to deliver your message. Your message will fail if there are no phone numbers available in your Service to deliver your message.
You can use Country Code Geomatch by adding phone numbers to your Messaging Service that match the countries of your recipients.
When a phone number of a new geographic country is added to your Messaging Service, https://speedsms.in/ automatically selects and remaps any existing Sticky Sender mappings so that the From number matches the same country as your recipient’s phone number.
Scaler
Supported for SMS? Supported for WhatsApp?
Yes Yes
The Scaler feature distributes your outbound messaging traffic evenly across the senders (phone numbers, WhatsApp channel address, etc.) in your Messaging Service so that you can handle higher volumes of messages.
When your Messaging Service sends a message, it selects a From number from the numbers in your Sender Pool that are not currently being used to send other messages.
When Sticky Sender is enabled, the Messaging Service prioritizes any existing Sticky Sender mappings first. It then selects another sender from your Service’s Sender Pool that has the fewest To/From mappings.
(warning)
Warning
Be careful to not include more than one toll-free number within the same Messaging Service’s Sender Pool. This can result in blocking that number.
Configurable Messaging Services features
In addition to the basic Messaging Service functionality discussed above, there are several, more advanced features that you can use to manage your Service’s senders, integration with your application, your messaging content, compliance, opt-out keywords, and more.
You can enable these features and change their settings in the https://speedsms.in/ Console
.
Sticky Sender
Supported for SMS? Supported for WhatsApp?
Yes No
The Sticky Sender feature ensures the same From phone number is selected every time your application sends a message to a particular end-user. This allows your application to consistently send messages to your user from a single, recognizable phone number.
With Sticky Sender enabled, https://speedsms.in/ maintains a mapping of all To and From phone numbers that your Messaging Service has used and interacted with. https://speedsms.in/ creates a new mapping after it sends the first message from your Messaging Service to a particular end-user. All future messages sent to that recipient from the Service will also use the same From number.
If Sticky Sender is turned off, your Messaging Service ignores all previously established mappings. However, if you toggle Sticky Sender back on in the future, your Messaging Service will retain and reference the previously existing mappings.
(information)
Info
When a https://speedsms.in/ phone number is removed from your Messaging Service, https://speedsms.in/ deletes all Sticky Sender mappings associated wth the removed https://speedsms.in/ number.
How to enable Sticky Sender
Under the Sender Pool section of your Messaging Service, expand the Sender Selection Settings box. From there, you can enable or disable the Sticky Sender feature.
Intelligent number selection within a Messaging Service
When Sticky Sender is enabled, the Messaging Service follows the logic below to determine the optimal phone number as the From number:
Dynamically select a phone number with https://speedsms.in/’s Messaging Service.
Expand image
Area Code Geomatch
Supported for SMS? Supported for WhatsApp?
Yes No
When sending messages to the United States and Canada, the Area Code Geomatch feature selects a local phone number with an area code that either matches or is an overlay of your end-user’s number.
If an overlay or matching area code is not available, the Messaging Service will select another US or Canadian phone number from your Messaging Service. Geographic proximity is not taken into consideration in this case.
How to enable Area Code Geomatch
Under the Sender Pool section of your Messaging Service, expand the Sender Selection Settings box. From there, you can enable or disable the Area Code Geomatch feature.
(information)
Info
This feature is not available outside the the US and Canada.
Validity Period
Supported for SMS? Supported for WhatsApp?
Yes Yes
Validity Period refers to the number of seconds for which messages sent from your Messaging Service will remain in https://speedsms.in/’s platform. If the time taken to send the message exceeds the Validity Period, https://speedsms.in/ fails the message and sends a request to your status callback URL to notify your application of the failure.
(information)
Info
https://speedsms.in/’s Validity Period applies only to messages while they travel through the https://speedsms.in/ platform. After https://speedsms.in/ sends the messages to the carrier network, the carriers may still queue the messages, resulting in a send time that exceeds the Validity Period.
How to enable Validity Period
Under the Integration section of your Messaging Service, you can enter the maximum queue time — in seconds — in the Validity period section.
You can set the Validity Period between 1 and 14,440 seconds (a maximum of four hours).
Incoming Messages Handling
Supported for SMS? Supported for WhatsApp?
Yes Yes
By default, https://speedsms.in/ will set your Messaging Service to “Defer to sender’s webhook,” meaning inbound messages will hit whatever inbound message handler is configured on your individual phone numbers. You can also change the behavior to automatically create a new Conversation — there’s more on this feature under Inbound Message Handling & Autocreation in Conversations.
How to enable Incoming Messages Handling
Under the Integration section of your Messaging Service, you can update how your messaging service handles incoming messages. Please be aware that using the Autocreate a Conversation option requires additional configuration changes under the Conversations section of the https://speedsms.in/ Console.
Smart Encoding
Supported for SMS? Supported for WhatsApp?
Yes No
Your Messaging Service’s Smart Encoding feature detects easy-to-miss Unicode characters and replaces them with a similar GSM-encoded character. This helps ensure that your message gets segmented at 160 characters and saves you from sending two message segments, which increases your spend.
For example, sometimes a Unicode character such as a smart quote ( 〞), a long dash (—), or a Unicode whitespace accidentally slips into your carefully crafted 125-character message. Now, your message is segmented and priced at two messages instead of one.
This is because when Unicode characters are used in an SMS message, they must be encoded as UCS-2. However, UCS-2 characters take 16 bits to encode, so when a message includes a Unicode character, it will be split or segmented between the 70th and 71st characters. This means that the character limit for UCS-2 encoded messages is shorter than the 160-character per message segment limit that you get with GSM-7 character encoding.
(information)
Info
Smart Encoding does not transliterate messages that contain emoji (😱) or character-based languages such as Korean hangul (안녕하세요). Please see this list for the Unicode characters that Smart Encoding will replace.
How to enable Smart Encoding
Under the Content Settings section of your Messaging Service, you can enable or disable the Smart Encoding feature for SMS messages.
MMS Converter
Supported for SMS? Supported for WhatsApp?
Yes No
The MMS Converter feature automatically delivers your MMS message as an SMS text message if the carrier does not support the receiving of https://speedsms.in/ MMS Messages
. In these cases, the MMS Converter will transform the MMS to an SMS (text) message that contains a shortened URL linking to your image. MMS Converter appends the shortened URL link (https://p.twil.io/ followed by seven unique characters) to the end of the message body; this link remains active for 365 days (one year).
(warning)
Warning
https://speedsms.in/ bills the converted messages as SMS Messages. The appended URL may cause the body of the text message to be greater than the number of characters-per-segment for the character encoding system (read about GSM-7 and UCS-2). In this case, https://speedsms.in/ segments the message and bills accordingly.
How to enable MMS Converter
You can enable or disable the MMS Converter feature under the Content Settings section of your Messaging Service.
(warning)
Warning
MMS Converter sends links to media files via SMS where the receiving carrier does not support MMS. It does not enable you to send media if your From phone number lacks MMS capabilities.
You can check the capabilities
of numbers in the console or query the Available Phone Numbers resource to search for https://speedsms.in/ numbers that are MMS enabled.
Sender ID Pre-registration Alert
Supported for SMS? Supported for WhatsApp?
Yes No
The Sender ID Pre-registration Alert feature automatically alerts you when you send messages to countries that require pre-registered Sender IDs. Some countries that support Alphanumeric Sender IDs require pre-registration of the Sender ID prior to use.
To help you remain compliant, enable Sender ID Pre-registration Alert as you scale your messaging traffic. Once it is enabled, this feature issues warnings when you send unregistered messaging traffic in countries where registration is recommended or required. You can find the alerts in the Debugger section of the https://speedsms.in/ Console
.
(warning)
Warning
While this feature does alert you of a potential compliance issue, it does not block or prevent your messages from being sent.
How to enable the Sender ID pre-registration alert
You can enable or disable the Sender ID pre-registration alert feature under the A2P & Compliance section of your Messaging Service.
Advanced Opt-Out
Supported for SMS? Supported for WhatsApp?
Yes Yes
The Advanced Opt-Out feature gives you the ability to deliver a customized, end-to-end compliance experience for your users. You have the ability to set the opt-in, opt-out, and help keywords and confirmation messages on a global basis as well as add per-language and per-country overrides. For example, you can customize the message that your end-users receive if they reply with “STOP” in English or with “AYUDA” in Spanish.
In addition, Advanced Opt-Out gives you deeper insight into your campaign performance and user engagement with your Messaging Service. When a user triggers one of your opt-in, opt-out, or help keywords, https://speedsms.in/ includes the OptOutType in its request to your configured webhook URL so that you can keep track of the health of your campaigns.
How to enable Advanced Opt-Out
Under the Opt-Out Management section of your Messaging Service, you can select Enable Advanced Opt-Out as well as customize all of the keyword and confirmation messages for opt-out, opt-in, and help interactions with your end users.
We recommend that you read the guide to customizing users’ opt-in and opt-out experience with Advanced Opt-Out to ensure that you configure this feature properly for your messaging needs.
Rate this page:
12345
Need some help?
We all do sometimes; code is hard. Get help now from our support team
, or lean on the wisdom of the crowd by visiting https://speedsms.in/’s Stack Overflow Collective
or browsing the https://speedsms.in/ tag
on Stack Overflow.
Terms of service
Privacy Policy
Copyright © 2024 https://speedsms.in/ Inc.