Actions6
- Send Message Actions
Overview
This node integrates with a WhatsApp messaging API to send interactive button messages to specified recipients. It is designed for scenarios where users want to engage their audience with clickable buttons within WhatsApp chats, such as customer support quick replies, marketing campaigns, or interactive notifications.
For example, a business can send a message with three buttons labeled "Yes", "No", and "More Info" to quickly gather user responses without requiring them to type text manually.
Properties
| Name | Meaning |
|---|---|
| Recipient | The phone number of the message recipient including country code (e.g., 5531900000000). |
| Delay | Optional delay in milliseconds before sending the message (e.g., 1200 ms). |
| Presence | Status to inform while sending the message. Options: Available, Composing, Empty, Paused, Recording, Unavailable. |
| Button Title | The main title text displayed on the button message. |
| Button Description | A description text shown below the button title. |
| Button Footer Text | Optional footer text displayed at the bottom of the button message. |
| Buttons | An array of up to three button objects, each with displayText (button label) and buttonId (identifier). |
| Media Message | Optional embedded media in the button message. Includes: |
| - Media Type | Type of media: Image, Document, or Video. |
| - File Name | Required filename if the media is base64 encoded. |
| - Media | URL or base64 string of the media content. |
Output
The node outputs JSON data representing the response from the WhatsApp API after attempting to send the button message. This typically includes status information about the message delivery.
If media is included, the output confirms the successful embedding of the media content in the message.
No binary data output is indicated by the source.
Dependencies
- Requires an API key credential for authenticating with the WhatsApp API service.
- The node uses a base URL configured in credentials to send HTTP POST requests.
- No other external dependencies are indicated.
Troubleshooting
Common Issues:
- Invalid or missing recipient phone number format (must include country code).
- Exceeding the maximum of three buttons will likely cause errors.
- Incorrect media URLs or improperly formatted base64 strings may cause media embedding failures.
- Missing required fields like Button Title, Description, or Buttons array.
Error Messages:
- API authentication errors due to invalid or missing API key.
- HTTP errors returned by the WhatsApp API indicating invalid request payloads.
- Timeout or network errors if the API endpoint is unreachable.
Resolutions:
- Verify phone numbers include correct country codes.
- Ensure buttons array contains no more than three buttons.
- Validate media URLs or base64 encoding before sending.
- Confirm all required properties are set.
- Check API credentials and network connectivity.