Vonage Messages integration

What it does

The Vonage Messages integration lets your agency run a client's messaging from inside a workflow. Connect a client's Vonage API key and secret once, and your workflows can send SMS through the SMS API, send WhatsApp, MMS, RCS, Viber, and Facebook Messenger messages through the Messages API, mark WhatsApp messages as read, look up delivery records, list the account's numbers, and check balance and pricing. Four triggers react when a customer messages you or when Vonage reports a delivery status.

Connect a Vonage account

1. In the workflow editor, add a Vonage Messages node and choose to add a connection.
2. In a new tab, sign in to the Vonage Dashboard as the client, or as your agency if the client has shared access.
3. Open API Settings and copy the API key and the API secret.
4. Paste both values into TaskJuice and save the connection.

TaskJuice sends the key and secret as HTTP Basic credentials on every call. The API key is also Vonage's account id, which the Reports API needs, so TaskJuice keeps a copy of it in the connection details. If you connected Vonage before October 2026, reconnect once so Get Message Record and List Message Records can read it.

To rotate the secret, open API Settings, create a new secret, and update the TaskJuice connection.

Point Vonage at TaskJuice

All four triggers share one inbound URL. Copy it from any Vonage trigger in TaskJuice, then paste it into Vonage:

1. In the Vonage Dashboard, open API Settings.
2. Paste the URL into the Inbound SMS webhook URL and the Delivery receipts webhook URL.
3. Any of the GET, POST, and POST-JSON callback methods works.
4. For WhatsApp, RCS, Messenger, and Viber, open Applications, edit the application your sender is linked to, and paste the same URL into the Inbound URL and Status URL of the Messages capability.

The Default SMS setting in API Settings decides which format Vonage uses for inbound SMS. With SMS API, inbound SMS fire Incoming SMS. With Messages API, they fire Inbound Message. Delivery updates for Send SMS fire Delivery Receipt. Status updates for the Messages API send actions fire Message Status.

TaskJuice does not register this URL for you. Vonage keeps one inbound URL and one delivery receipt URL per account, so an automatic registration would overwrite any URL your client already uses.

Triggers

• vonage-sms/incoming-sms fires when an inbound SMS reaches one of your Vonage numbers in the SMS API format. It carries the sender (msisdn), your number (to), the text, keyword, message id, and timestamp.
• vonage-sms/delivery-receipt fires when Vonage reports a delivery status for a message sent with Send SMS: delivered, expired, failed, rejected, accepted, buffered, or unknown.
• vonage-sms/inbound-message fires when a customer messages you through the Messages API on SMS, MMS, RCS, WhatsApp, Messenger, or Viber. It carries the channel, sender, your number or channel id, message type, and the text or media URL.
• vonage-sms/message-status fires when a Messages API message changes status: submitted, delivered, read, rejected, or undeliverable. It carries the message_uuid returned by the send action, the status, any error, and the price.

Actions

• vonage-sms/send-sms sends an SMS through the SMS API, with an optional client reference, delivery receipt URL, encoding, and TTL.
• vonage-sms/send-whatsapp-text sends a free-form WhatsApp message, optionally as a reply to an inbound message.
• vonage-sms/send-whatsapp-template sends an approved WhatsApp template with its parameters. Use it to start a conversation or to message outside the 24-hour window.
• vonage-sms/send-whatsapp-image sends a WhatsApp image from a public URL, with an optional caption.
• vonage-sms/send-whatsapp-file sends a WhatsApp document from a public URL, with an optional caption and file name.
• vonage-sms/send-mms-image sends an MMS picture message from one of your US numbers, picked from a list.
• vonage-sms/send-rcs-text sends an RCS text message from your RCS business agent.
• vonage-sms/send-viber-text sends a Viber Business Message from your Viber service id.
• vonage-sms/send-messenger-text sends a Facebook Messenger message from your linked Facebook Page.
• vonage-sms/mark-whatsapp-read marks an inbound WhatsApp message as read in its region, so the customer sees blue ticks.
• vonage-sms/search-message (Get Message Record) looks up the delivery record of one or more messages by id: status, price, network, and timing.
• vonage-sms/search-messages (List Message Records) lists message records for a time window of up to 24 hours, filtered by direction and optionally by status, sender, recipient, or country.
• vonage-sms/list-numbers lists the numbers rented on the account, with their capabilities and webhook settings.
• vonage-sms/get-balance returns the account balance in EUR.
• vonage-sms/get-pricing returns outbound SMS pricing for a country, with per-network prices.

Known limitations

• Vonage's webhook settings have no field for a custom header, and TaskJuice does not yet verify Vonage's own signatures: the optional SMS API request signature (sig) or the Messages API JWT. The inbound URL is the only credential, so treat it as a secret.
• WhatsApp delivers free-form messages only inside the 24-hour customer service window. Outside it, send a template.
• MMS works only from US numbers to US recipients.
• Message records come from the Vonage Reports API. A list request covers at most 24 hours. Pass the cursor and iv outputs back in to read the next page.
• Vonage stores each message in one region. Mark as Read needs that region (api-eu, api-us, or api-ap), which you can read from the host in the inbound message's _self.href.
• Alphanumeric sender ids are blocked in some countries, including the United States and Canada, where you need a Vonage number.
• Trial accounts can send only to verified test numbers, and add a demo notice to every SMS.