Actions6
- Contato Actions
- Tag Actions
- Template WhatsApp Actions
- Kanban Actions
Overview
This node integrates with the ChatFunnel API to manage tags associated with contacts. Specifically, the "Adicionar Tag ao Contato" operation allows users to add one or more tags to an existing contact by specifying the contact's unique ID and the tag IDs.
Common scenarios where this node is useful include:
- Organizing contacts by categorizing them with relevant tags for marketing segmentation.
- Automating workflows that require tagging contacts based on interactions or status changes.
- Enhancing CRM data by programmatically updating contact tags from other systems or triggers.
For example, after a lead completes a form, you could use this node to add tags like "New Lead" or "Interested in Product A" to their contact record automatically.
Properties
| Name | Meaning |
|---|---|
| ID do Contato | The unique identifier (UUID) of the contact to which tags will be added. |
| IDs das Tags | Comma-separated list of tag UUIDs to add to the specified contact. |
Output
The node outputs JSON data representing the response from the ChatFunnel API after attempting to add tags to the contact. This typically includes confirmation of the operation's success or details about the updated contact-tag associations.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the ChatFunnel API.
- The node makes HTTP POST requests to the endpoint
https://api.chatfunnel.com.br/webhook/add_contact_tagwith the API key included as a query parameter. - Proper configuration of the API key credential within n8n is necessary for successful execution.
Troubleshooting
- Missing Tag IDs: If no tag IDs are provided, the node throws an error indicating that at least one tag ID must be supplied. Ensure the "IDs das Tags" property contains valid UUIDs separated by commas.
- Invalid Contact ID: Providing an incorrect or non-existent contact ID may result in API errors or no effect. Verify the contact ID before running the node.
- API Authentication Errors: If the API key is invalid or missing, requests will fail. Confirm that the API key credential is correctly set up in n8n.
- Network Issues: Connectivity problems can cause request failures. Check network access to
api.chatfunnel.com.br. - Error Handling: If the node is configured to continue on failure, errors will be returned in the output JSON under an "error" field for each failed item.
Links and References
- ChatFunnel API Documentation (general reference; specific endpoints used by the node)
- n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)