Twilio WhatsApp

Twilio WhatsApp sends WhatsApp messages from your Twilio number: text, images, audio, documents or videos, and approved templates. It also fetches a sent message, lists messages and deletes one.

When to use it

• Replying to a customer on WhatsApp with what an agent answers.
• Sending an appointment reminder with an approved template.
• Sending a document, such as an invoice, on WhatsApp.

Configuration

The Operation field decides what the component does: Send Message (default), Send Template, Fetch Message, List Messages or Delete Message.

You need a Twilio WhatsApp Integration credential with your Twilio account details and your WhatsApp number. See Credentials.

Field	What it does
Credential (required)	The Twilio WhatsApp Integration credential.
Operation	What the component does.
Type Operation	When sending, who the message goes to. Basic (default): the person who wrote to the flow on WhatsApp. Advanced: To appears to type the recipient; use it also when testing from the playground.
To	The recipient’s number in the format whatsapp:+34600000000.
Message (required)	With Send Message, the message text.
Media URL	With Send Message, the public address of an image, audio file, document or video to attach.
Template Name	With Send Template, the approved WhatsApp template.
Template Parameters (JSON)	With Send Template, the values of the template’s variables, for example {"1": "Ana", "2": "12345"}.
Sample Of The Template	With Send Template, a sample of the template text.
Message SID	With Fetch Message, the message ID.
Filter: To (Optional)	With List Messages, filters by recipient. Together with Filter: From (Optional), Page Size and Only Inbound? (received messages only).
Message SID To Delete	With Delete Message, the ID of the message to delete.

Advanced options

Field	What it does
Silent Errors	When sending, if it fails, it is logged without stopping the flow. Off by default.

Output

The Data output holds the message sent or fetched, the list of messages or confirmation of the deletion.

In tool mode, an agent can use the component by itself. See Tool Mode.

Example

A clinic replies to its patients on WhatsApp.

1. A Twilio WhatsApp Webhook receives the message and an agent prepares the reply.
2. Add Twilio WhatsApp with Send Message, leave Type Operation as Basic to reply to whoever wrote and connect the agent’s reply to Message.

Good practices

• WhatsApp only lets you write freely to people who have messaged you in the last 24 hours; outside that window use Send Template.

Related components

• Twilio WhatsApp Webhook: receives the messages.