Actions29
- Mensagem Actions
- Ticket Actions
- Contato Actions
- API Oficial Actions
- API Plus Actions
Overview
This node integrates with the WhatMaster API to send WhatsApp messages and perform related operations. Specifically, for the API Plus resource with the Enviar Lista operation, it allows sending WhatsApp messages that include interactive lists, enhancing user engagement by providing selectable options within the message.
Common scenarios where this node is beneficial include:
- Customer support workflows where users can select from a list of predefined options.
- Marketing campaigns that require interactive message elements.
- Automating responses with structured choices to guide users through menus or services.
Practical example: Sending a WhatsApp message to a customer with a list of product categories they can choose from, enabling quick navigation and response.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The recipient's WhatsApp number in international format (e.g., 5511999999999). |
| Mensagem | The text content of the message to be sent. |
| External Key | An optional external identifier to track or correlate the message externally. |
Output
The node outputs a JSON object representing the response from the WhatMaster API after attempting to send the message. This typically includes status information about the message delivery or any errors returned by the API.
If the message involves media (files, stickers, locations), the output JSON will reflect the API's acknowledgment or error details accordingly.
No binary data output is produced by this node.
Dependencies
- Requires configuration of WhatMaster API credentials including:
- A Bearer token for authorization.
- An external code identifier used in the API endpoint URL.
- Uses the
form-dataandfsNode.js modules internally for file uploads. - The node makes HTTP POST requests to the WhatMaster API endpoint at
https://back.whatmaster.com.br/v1/api/external/{externalCode}.
Troubleshooting
- Missing Credentials: Errors like "No credentials found" or missing Bearer token/external code indicate that the API credentials are not properly configured. Ensure the API key and external code are set up in n8n credentials.
- Required Fields Missing: If the WhatsApp number or message body is empty, the node throws an error indicating these fields are mandatory.
- File Upload Issues: For sending files, the file path must be valid and accessible; otherwise, the request will fail.
- Unsupported Operations: Attempting operations not implemented for the selected resource will result in errors stating the operation is not supported.
- API Errors: Any errors returned by the WhatMaster API will be included in the node output JSON under an error field if "Continue On Fail" is enabled.
Links and References
- WhatMaster API Documentation (Assumed official docs, replace with actual if available)
- WhatsApp Business API Interactive Messages (For understanding list messages conceptually)