Overview
This node sends interactive WhatsApp messages using buttons or lists via the WhatsApp Business API. It is useful for automating customer engagement, providing quick reply options, or presenting menu selections directly within WhatsApp conversations.
Typical use cases include:
- Sending quick reply buttons to customers for fast responses (e.g., "Yes", "No", "More Info").
- Presenting a list menu with multiple selectable options (e.g., product categories, service choices).
- Enhancing customer support workflows by guiding users through predefined interactive options.
Properties
| Name | Meaning |
|---|---|
| Phone Number ID | The WhatsApp Business phone number ID used to send the message. |
| Numéro De Téléphone Destinataire | Recipient's phone number in international format (e.g., +33123456789). |
| Type De Message | Type of interactive message: either "Boutons De Réponse Rapide" (quick reply buttons) or "Liste Interactive" (dropdown list). |
| Texte Du Header | Optional header text displayed at the top of the message. |
| Texte Du Body | Main body text content of the message. |
| Texte Du Footer | Optional footer text displayed at the bottom of the message. |
| Boutons | For "button" message type only: up to 3 quick reply buttons, each with a unique ID and title (max 20 characters). |
| Texte Du Bouton De Liste | For "list" message type only: text shown on the button that opens the interactive list. |
| Options De Liste | For "list" message type only: one or more sections containing options; each option has an ID, title (max 24 characters), and optional description (max 72 characters). |
Output
The node outputs an array of JSON objects, each representing the result of sending a message:
success: Boolean indicating if the message was sent successfully.messageId: The unique ID of the sent WhatsApp message (present if successful).to: The recipient phone number.messageType: The type of interactive message sent ("button" or "list").response: The full response data from the WhatsApp API.error: If sending failed, contains error details or message.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the WhatsApp Business API.
- Uses the WhatsApp Cloud API endpoint (
https://graph.facebook.com/v21.0/{phoneNumberId}/messages). - Requires network access to Facebook's Graph API.
- The node expects the credential to provide an access token for authorization.
Troubleshooting
- Error: "Au moins un bouton est requis" — Occurs if no buttons are provided when message type is "button". Fix by adding at least one button.
- Error: "Maximum 3 boutons autorisés" — More than 3 buttons were added. Limit buttons to 3 maximum.
- Error: "Au moins une section avec des options est requise" — When using "list" message type, at least one section with options must be defined.
- Invalid phone number format — Ensure the recipient phone number is in international format without spaces or special characters.
- Authentication errors — Verify the API key credential is valid and has proper permissions.
- API rate limits or network issues — Check connectivity and API usage quotas.
If continueOnFail is enabled, the node logs errors and continues processing other items; otherwise, it throws exceptions immediately.