Actions29
- Mensagem Actions
- Ticket Actions
- Contato Actions
- API Oficial Actions
- API Plus Actions
Overview
This node integrates with the WhatMaster API to manage WhatsApp contacts, messages, tickets, and other related resources. Specifically, for the Contato (Contact) resource with the Definir Tag (Set Tag) operation, it allows users to assign a tag to an existing WhatsApp contact by specifying the contact's ID and the desired tag.
This functionality is useful in scenarios where you want to categorize or label contacts for segmentation, filtering, or CRM purposes. For example, tagging contacts as "VIP", "Support", or "Prospect" can help automate workflows based on these labels.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The WhatsApp number in international format (e.g., 5511999999999). Required for most operations involving contacts. |
| External Key | An optional external key that can be used for integration or tracking purposes. |
| ID do Contato | The unique identifier of the contact to which the tag will be assigned. |
| Tag | The tag string to assign to the contact. |
Output
The node outputs JSON data representing the response from the WhatMaster API after attempting to set the tag on the specified contact. The exact structure depends on the API response but generally includes confirmation of the tag assignment or error details if the operation failed.
No binary data output is produced by this operation.
Dependencies
- Requires configuration of WhatMaster API credentials, including:
- A Bearer Token for authentication.
- An External Code used as part of the API endpoint URL.
- The node makes HTTP requests to the WhatMaster API endpoint:
https://back.whatmaster.com.br/v1/api/external/{externalCode}
Troubleshooting
Missing Credentials:
Error message: "No credentials found. Please configure the WhatMaster API credentials."
Solution: Ensure the WhatMaster API credentials are properly configured in n8n with both the token and external code.Missing Bearer Token or External Code:
Error messages:- "Bearer Token is required. Please configure it in the credentials."
- "External Code is required. Please configure it in the credentials."
Solution: Verify that both the token and external code fields are filled in the credential settings.
Required Parameters Missing:
If the WhatsApp number, contact ID, or tag is missing or empty, the node will throw an error indicating the missing field. Make sure all required inputs are provided.Unsupported Operation or Resource:
If an unsupported operation or resource is selected, the node throws an error indicating this. Confirm that the resource is "contact" and the operation is "setTag".
Links and References
- WhatMaster API Documentation (Assumed based on URL pattern; verify actual docs)
- n8n Documentation on Creating Custom Nodes