ChatFunnel icon

ChatFunnel

Interagir com a API do ChatFunnel

Actions6

Overview

This node integrates with the ChatFunnel API to manage contacts and related entities. Specifically, for the Contato (Contact) - Criar (Create) operation, it allows users to create a new contact in the ChatFunnel system by providing essential details such as email, phone number, and name, along with optional tags and custom fields.

Common scenarios where this node is beneficial include:

  • Automating the addition of new leads or customers into ChatFunnel from other systems.
  • Enriching contact data with custom fields and tags for better segmentation and targeting.
  • Integrating contact creation into workflows that involve marketing automation or customer support.

Practical example:

  • When a new user signs up on a website, this node can be used to automatically create a corresponding contact in ChatFunnel with their email, phone, and name, tagging them appropriately and adding any custom information collected during signup.

Properties

Name Meaning
Email Email address of the contact to be created (required).
Telefone Phone number of the contact in international format with country code (e.g., +5511999999999) (required).
Nome Full name of the contact to be created (required).
Detalhes do Contato Additional contact details including:
- IDs das Tags Comma-separated list of tag IDs to associate with the contact (e.g., uuid1,uuid2,uuid3).
- Campos Customizados Custom fields configured in the account; each field has a label (name) and a value.

Output

The node outputs JSON data representing the response from the ChatFunnel API after creating the contact. This typically includes details about the newly created contact such as its unique ID, assigned tags, custom fields, and confirmation of the stored data.

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/create_contact with the API key passed as a query parameter.
  • Proper configuration of the API key credential in n8n is necessary for successful execution.

Troubleshooting

  • Missing required fields: If email, phone, or name are not provided, the API may reject the request. Ensure all required properties are filled.
  • Invalid phone format: The phone number must be in international format with country code (e.g., +5511999999999). Incorrect formatting may cause errors.
  • Tag IDs format: Tag IDs should be comma-separated UUID strings without spaces. Improper formatting might lead to tags not being associated.
  • API key issues: Invalid or missing API key will result in authentication errors. Verify the API key credential is correctly set.
  • Network errors: Connectivity issues or API downtime will cause request failures. Check network status and API availability.
  • Error messages: Errors returned by the API are included in the node's output if "Continue On Fail" is enabled; otherwise, they stop execution. Review error messages for clues and adjust input accordingly.

Links and References

Discussion