Skip to content
Nappai Documentation

WhatsApp Message

WhatsApp Message sends WhatsApp messages from your Twilio number: a text, one or more images, audio files, documents or videos, or a mix of them. It also checks the status of a message you have already sent.

When to use it

  • Confirming an appointment or an order to a customer on WhatsApp.
  • Sending a customer the PDF invoice the flow has produced.
  • Checking whether a message sent earlier has been delivered or read.

Configuration

The component connects with your Twilio account details, which you find in your Twilio console.

FieldWhat it does
Twilio Account SID (required)The identifier of your Twilio account.
Twilio Auth Token (required)The key of your Twilio account.
Twilio WhatsApp Number (required)Your WhatsApp number in Twilio, in international format, for example +34600000000.
Recipient Phone Number (required)The recipient’s phone number in international format.
OperationWhat the component does: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media (several file types in the same message) or Get Message Status. Default: Send Text Message. Depending on the operation, the panel shows only the fields it needs.

Fields by operation

FieldWhen it appears and what it does
Message TextIn the send operations. The text of the message or, if you send files, the text that goes with them. Up to 1600 characters. Required in Send Text Message.
Media FilesIn the file operations. The web addresses of the files to send, separated by commas. Up to 10 files per message.
Validate MediaIn the file operations. Meant to check the type and size of the files. Default: on. At the moment files are always checked before sending, whether it is on or not.
Status Callback URLIn the send operations. Optional. A web address Twilio notifies when the message status changes (sent, delivered, read…).
Input MessageIn the send operations. Optional. Connect a message, for example an agent’s answer: its text is used when Message Text is empty.
Message SIDIn Get Message Status. The identifier of the message you want to check, the one the component returns when sending it.

Output

WhatsApp Message Response returns a message saying whether the operation succeeded. When sending, it includes the recipient, the sender number, the text, the files sent, the status and the Twilio message identifier (message_sid). When checking the status, it includes the information Twilio returns. If something fails, the message explains why.

Example

A dental clinic confirms appointments on WhatsApp:

  1. The flow receives the booked appointment with the patient’s name, phone number and time.
  2. An agent writes a short confirmation message.
  3. WhatsApp Message, with Operation set to Send Text Message, receives the phone number in Recipient Phone Number and the agent’s message in Input Message, and sends it to the patient.

Good practices

  • Always write phone numbers in international format, with the country code.
  • Keep the message_sid of each message if you want to check its status later.
  • For new flows, Twilio WhatsApp offers more actions, such as sending templates.