Actions6
- Contato Actions
- Tag Actions
- Template WhatsApp Actions
- Kanban Actions
Overview
This node integrates with the ChatFunnel API to manage Kanban cards and related contacts. Specifically, for the Kanban - Criar Card operation, it allows users to create a new card within a specified Kanban board. The card can be associated either with an existing contact by ID or with a newly created contact by providing contact details. Additional card details such as description, priority, column placement, and moderators can also be set.
This node is useful in scenarios where you want to automate task or lead management workflows by programmatically adding cards to Kanban boards based on external triggers or data sources. For example, when a new lead is captured via a form, this node can create a corresponding Kanban card linked to that lead’s contact information.
Properties
| Name | Meaning |
|---|---|
| ID do Kanban | The unique identifier of the Kanban board where the card will be created. |
| Título do Card | The title or name of the card to be created. |
| Método de Identificação do Contato | How to identify or create the contact associated with the card: • Usar ID do Contato Existente (use existing contact ID) • Criar Novo Contato (create a new contact) |
| ID do Contato | The ID of an existing contact to associate with the card (required if using existing contact method). |
| Nome do Contato | Name for the new contact to be created (required if creating a new contact). |
| Email do Contato | Email address for the new contact (required if creating a new contact). |
| Telefone do Contato | Phone number for the new contact (required if creating a new contact). |
| Detalhes do Card | Additional details for the card, including: • Descrição (description text) • Prioridade (priority: Alta, Média, Baixa) • ID da Coluna (ID of the Kanban column where the card will be placed) • IDs dos Moderadores (comma-separated list of moderator IDs) |
Output
The node outputs JSON data representing the response from the ChatFunnel API after creating the Kanban card. This typically includes details about the newly created card such as its ID, title, associated contact info, status, and other metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active API key credential for the ChatFunnel service.
- The node makes HTTP requests to the ChatFunnel API endpoint at
https://api.chatfunnel.com.br. - Proper configuration of the API key in n8n credentials is necessary for authentication.
Troubleshooting
- Missing Required Fields: If required fields like Kanban ID, card title, or contact identification details are missing, the node will throw errors. Ensure all mandatory inputs are provided.
- Invalid Contact Identification: When choosing to use an existing contact ID, ensure the ID is valid and exists in the system; otherwise, the API may return an error.
- API Key Issues: Invalid or expired API keys will cause authentication failures. Verify the API key credential is correct and has necessary permissions.
- Malformed Moderator IDs: The moderator IDs must be comma-separated UUIDs without extra spaces. Incorrect formatting may cause request failures.
- Network or API Errors: Network issues or API downtime can cause request failures. Check connectivity and ChatFunnel service status.
Links and References
- ChatFunnel API Documentation (official API base URL referenced)
- n8n Documentation on Creating Custom Nodes (for general guidance on node development)