Vonage Communication - Send an SMS message

Use the Vonage Communication - Send an SMS message action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to send an SMS message to a phone number.

For more information about Vonage Communication, go to Vonage Communication

Before you begin: 

Jump to:

Configure the Vonage Communication - Send an SMS message action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  1. Select a Connection. If you do not have a connection, see Add a connection.
  1. Specify the Phone number to send the message to.
  2. Specify the Message.
  3. Create or select a variable for the output.

Vonage Communication - Send an SMS message action fields and settings

Section

Field

Description

Variable types

(Unlabeled)

Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

The Vonage Communication connection to use to send the SMS message.

To refresh the available connections, click .

(n/a)
Phone number The number that the message should be sent to. The number must conform to the E. 164 standard. The number must contain digits split into at most 3 digits for the country code and 12 digits for the subscriber number. For example, +14253242400. The plus sign (+) indicates that the number includes the country calling code. Text, Decimal, Integer, Boolean, DateTime, Collection
  Message The body of the message being sent. Text, Decimal, Integer, Boolean, DateTime, Collection
Output Message details

Stores the result of the action as an object. The following values are returned:

  • Message count: (Text) The number of messages in the request. An SMS message can have a maximum number of 160 characters, if the message has 200 characters for example, then the message count would be 2.

  • Messages: (Collection) This is the collection of message details.

    • Status: (Text) Indicates the outcome of the request. For example, zero is success. The following table describes all status codes:

      Code

      Text

      Description
      0 Success The message was successfully accepted for delivery.
      1 Throttled You are sending SMS faster than the account limit (see What is the Throughput Limit for Outbound SMS?).
      2 Missing Parameters Your request is missing one of the required parameters: from, to, api_key, api_secret or text.
      3 Invalid Parameters The value of one or more parameters is invalid.
      4 Invalid Credentials Your API key and/or secret are incorrect, invalid or disabled.
      5 Internal Error An error has occurred in the platform whilst processing this message.
      6 Invalid Message The platform was unable to process this message, for example, an unrecognized number prefix.
      7 Number Barred The number you are trying to send messages to is on the list of barred numbers
      8 Partner Account Barred Your Vonage account has been suspended. Contact support@nexmo.com.
      9 Partner Quota Violation You do not have sufficient credit to send the message. Top-up and retry.
      10 Too Many Existing Binds The number of simultaneous connections to the platform exceeds your account allocation.
      11 Account Not Enabled For HTTP This account is not provisioned for the SMS API, you should use SMPP instead.
      12 Message Too Long The message length exceeds the maximum allowed.
      14 Invalid Signature The signature supplied could not be verified.
      15 Invalid Sender Address You are using a non-authorized sender ID in the from field. This is most commonly in North America, where a Vonage long virtual number or short code is required.
      22 Invalid Network Code The network code supplied was either not recognized, or does not match the country of the destination address.
      23 Invalid Callback URL The callback URL supplied was either too long or contained illegal characters.
      29 Non-Whitelisted Destination Your Vonage account is still in demo mode. While in demo mode you must add target numbers to your whitelisted destination list. Top-up your account to remove this limitation.
      32 Signature And API Secret Disallowed A signed request may not also present an api_secret.
      33 Number De-activated The number you are trying to send messages to is de-activated and may not receive them.
    • Phone number: (Text) The number the message was sent to.
    • Message ID: (Text) The ID of the message.
    • Network: (Text) The ID of the network of the recipient.
    • Message price: (Text) The cost of the message.
    • Remaining balance: (Text) The remaining balance of the account that sent the message.

    • Error text: (Text) If the Status is not zero, this describes the error encountered.

 Object