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 Oficial resource with the Enviar Lista operation, it allows sending a WhatsApp message that includes a list-type interactive element (a menu or selection list) to a specified phone number.
Common scenarios where this node is beneficial include:
- Automating customer support by sending interactive lists for users to choose options.
- Marketing campaigns where recipients can select from product categories or services.
- Surveys or feedback collection via WhatsApp using list messages.
Example use case: Sending a list message to a customer’s WhatsApp number offering different service packages to choose from.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The recipient's WhatsApp number in international format without "+" (e.g., 5511999999999). |
| Mensagem | The text content of the message to be sent along with the list. |
| External Key | An optional external identifier key to track or correlate the message externally. |
Output
The node outputs JSON data representing the response from the WhatMaster API after attempting to send the list message. This typically includes confirmation details such as message ID, status, or error information if the request failed.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for WhatMaster API authentication, including a bearer token and an external code.
- The node makes HTTP POST requests to the WhatMaster API endpoint
https://back.whatmaster.com.br/v1/api/external/{externalCode}. - No additional external libraries are required beyond those bundled with n8n and standard Node.js modules.
Troubleshooting
- Missing Credentials: Errors like "No credentials found" or "Bearer Token is required" indicate that the WhatMaster API credentials are not configured properly. 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 will throw errors indicating these fields are mandatory.
- Unsupported Operation: Using an operation not supported for the selected resource will cause an error.
- Network or API Errors: If the API endpoint is unreachable or returns an error, check network connectivity and API key validity.
Links and References
- WhatMaster API Documentation (Assumed URL based on endpoint; verify actual docs)
- WhatsApp Interactive Messages Guide (for understanding list messages)
Note: The provided source code shows that the actual implementation of the "Enviar Lista" operation under "API Oficial" resource is delegated to a method handleApiOficialOperation which currently throws a "not implemented" error. Therefore, while the node interface supports this operation, the execution logic for sending a list message via API Oficial is not yet implemented in the code.