ChatFunnel icon

ChatFunnel

Interagir com a API do ChatFunnel

Actions6

Overview

This node integrates with the ChatFunnel API to manage contacts and related entities such as tags, WhatsApp templates, Kanban cards, and lists. Specifically for the Contato (Contact) resource with the Buscar (Get/Search) operation, it allows you to search for an existing contact by email, phone number, or both.

Common scenarios where this node is useful include:

  • Retrieving contact details from ChatFunnel based on known identifiers like email or phone.
  • Validating if a contact exists before performing further actions such as sending messages or updating records.
  • Automating workflows that require fetching contact information dynamically.

For example, you might use this node to:

  • Search for a contact by their email address to retrieve their profile data.
  • Look up a contact using their phone number to verify their registration status.
  • Use both email and phone to increase the chances of finding the correct contact record.

Properties

Name Meaning
Método de Busca Method to search the contact. Options: "Por Email" (by email), "Por Telefone" (by phone), "Por Email ou Telefone" (by email or phone)
Email The email address of the contact to search for. Required if searching by email or both.
Telefone The phone number of the contact to search for. Required if searching by phone or both.

Output

The node outputs JSON data representing the contact(s) found by the search query. The structure depends on the ChatFunnel API response but typically includes fields such as contact name, email, phone, tags, and custom fields.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the ChatFunnel API.
  • The base URL used for API calls is https://api.chatfunnel.com.br.
  • Proper configuration of the API key in n8n credentials is necessary.

Troubleshooting

  • Error: "É necessário fornecer pelo menos um email ou telefone para buscar o contato"
    This error occurs if neither email nor phone is provided when searching. To fix, ensure at least one identifier is supplied according to the selected search method.

  • Empty or no results returned
    Verify that the email or phone number is correctly formatted and exists in the ChatFunnel system.

  • Authentication errors
    Confirm that the API key credential is valid and has the required permissions.

  • Network or timeout issues
    Check network connectivity and ChatFunnel service status.

Links and References

Discussion