Actions6
- Contato Actions
- Tag Actions
- Template WhatsApp Actions
- Kanban Actions
Overview
This node integrates with the ChatFunnel API to send pre-approved WhatsApp message templates to contacts. It allows users to specify the contact either by phone number or by a previously registered contact ID, select a WhatsApp template by its ID, optionally associate a tag with the message, and provide parameters to customize the template content.
Common scenarios include automated customer notifications, marketing campaigns, appointment reminders, or any situation where standardized WhatsApp messages need to be sent programmatically with dynamic content.
For example, a business could use this node to send a personalized order confirmation template to customers by providing their phone number and order details as template parameters.
Properties
| Name | Meaning |
|---|---|
| Método de Identificação do Contato | How to identify the contact for sending the template. Options: "Por Número de Telefone" (by phone number), "Por ID do Contato" (by contact ID). |
| Número do Contato | The contact's phone number in international format (e.g., +5545999999999). Used if identification method is by phone number. |
| ID do Contato | The unique ID of a previously registered contact. Used if identification method is by contact ID. |
| ID do Template | The ID of the pre-approved WhatsApp template to send. This is required. |
| ID da Tag (opcional) | Optional tag ID to associate with the message sending event. |
| Parâmetros do Template | A collection of key-value pairs representing template parameters to customize the message. Required if the contact does not have custom fields set. Each parameter has: - Nome: Parameter name (e.g., nome, empresa) - Valor: Parameter value |
Output
The node outputs JSON data containing the response from the ChatFunnel API after attempting to send the WhatsApp template message. The structure depends on the API response but generally includes information about the success or failure of the message sending operation.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the ChatFunnel API.
- The node makes HTTP requests to
https://api.chatfunnel.com.brendpoints. - Proper configuration of the API key credential in n8n is necessary for successful operation.
Troubleshooting
- Missing or invalid API key: If the API key is not configured or incorrect, the node will fail to authenticate. Ensure the API key credential is correctly set up.
- Invalid contact identification: If neither a valid phone number nor contact ID is provided according to the selected identification method, the request will fail. Verify that the contact information matches the chosen method.
- Template ID required: The node requires a valid WhatsApp template ID. Omitting this will cause errors.
- Parameter mismatch: If the template requires parameters and none are provided (and the contact lacks custom fields), the message may not send correctly. Provide all required parameters.
- API errors: The node logs the request URL and body before sending. Use these logs to debug issues related to malformed requests or unexpected API responses.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.
Links and References
- ChatFunnel API Documentation (assumed base URL; consult official docs for detailed API usage)
- WhatsApp Business API Template Messaging Guidelines (for understanding template requirements)