Send SMS applet

The Send SMS applet sends one or more SMS messages when a call is routed through the applet using Vonage's Messages API.

For information about using the Send SMS applet, see Sending SMS messages from Vonage Contact Center.

API credentials

FieldOptionsDescription
Vonage API KeyTextThe API key created in your Vonage's API dashboard.
Vonage API SecretTextThe API secret created in your Vonage's API dashboard.

Vonage's API dashboard

For information about creating a key and secret in Vonage's API dashboard, see Using the Vonage Dashboard for Account management.

SMS options

FieldOptionsDescription
From numberText

The phone number or name from which the SMS message appears to be sent. You can use a combination of text, digits and data sources. The resulting value in the From number field can contain a maximum of 11 characters or 20 digits.

The data sources are placeholders for the data sources' values at run time. Vonage Contact Center replaces the placeholders with values before sending the SMS.

Use the following format to specify a placeholder for a data source:

$(DataSource)

For example, "02072068888" or "XYZ Ltd" or "$(CompanyName)" or "From $(CLID)".

 10 DLC guidelines

To send SMS messages from a 10 digit long code number into US networks, you must set up and register the number with Vonage. Messages sent from unregistered numbers will be blocked.

Examples of 10 DLC numbers

+44 1234 567890

01234 567890
+1 123 456 7890
(123) 456 7890

To register a number, go to Important 10 DLC guidelines for US customers or contact your account manager.

To number(s)Destination numbers

One or more numbers to which the SMS is sent. You can specify numbers in local and international formats.

You can send an SMS to a maximum of 100 destination numbers. If you specify more than 100 numbers, the SMS applet sends an SMS message to the first 100. Separate multiple values with a comma. The numbers must all have the same destination country.

You can use a combination of digits and data sources.

The data sources are placeholders for the data sources' values at run time. Vonage Contact Center replaces the placeholders with values before sending the SMS.

Use the following format to specify a placeholder for a data source:

$(DataSource)

For example, "02072068888, 00442072068888, +442072068888, $(CustomerPhoneNumber)".

Dynamic destination countrySelect or clear

Determines whether you use a dynamic or static destination country.

Select the Dynamic destination country check box to use a data source to define the destination country for the SMS message or messages at run time.

Clear the Dynamic destination country check box to use a static destination country for the SMS message or messages.

Destination country

List of available countries

A list of all supported destination countries.

Click the destination country for the SMS message or messages.

If you select a destination country, Vonage Contact Center uses the value to validate all non-placeholder To number(s) when you save the applet. If any numbers are invalid, an error appears and Vonage Contact Center does not save the applet.

Vonage Contact Center re-validates the numbers at run time.

Destination country data sourceList of available data sources

A list of all available data sources.

Click the data source that will contain the destination country at run time.

The data source must contain the appropriate three character ISO country code for the destination country at run time.

For ISO codes, see https://www.iso.org/obp/ui/#search/code.

At run time, before sending an SMS message or messages, Vonage Contact Center uses the value in the data source to validate the values in the To number(s).

MessageText

The content of the SMS. The message can contain a maximum of 255 characters.

You can include one or more data sources in the Message field. The data sources are placeholders for the data sources' values at run time. Vonage Contact Center replaces the placeholders with values before sending the SMS.

Use the following format to specify a placeholder for a data source:

$(DataSource)

For example, "The balance for account number $(AccountNumber) is $(AccountBalance)."

Next applet

FieldOptionsDescription
Next appletList of available appletsThe applet that Vonage Contact Center routes the call to after sending the SMS.


Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.