ChatFunnel icon

ChatFunnel

Interagir com a API pública do ChatFunnel v1

Actions20

Kanban → Criar Card (Sempre Novo)

AI-generated

Overview

This node operation creates a new card in a specified Kanban board within the ChatFunnel platform. It is designed to always create a new card, regardless of existing cards, making it useful for tracking new tasks, contacts, or opportunities in a Kanban workflow. Practical examples include adding a new sales opportunity card with contact details, priority, and status, or creating a task card with comments and assigned moderators.

Use Case Examples

  1. Create a new Kanban card for a sales lead by specifying the Kanban board, contact ID, and additional fields like priority and status.
  2. Add a new contact card to a Kanban board by providing the contact's name and phone number, which creates the contact if it doesn't exist, and assigns the card to a specific column.

Properties

Name Meaning
Kanban Name or ID Specifies the target Kanban board where the card will be created. Can be selected from a list or provided as an ID.
Identificar Contato Por Determines how to identify or create the contact associated with the card, either by existing contact ID or by name and phone number.
ID Do Contato UUID of the existing contact, required if identifying contact by ID.
Nome Do Contato Name of the contact, required if identifying contact by name and phone number.
Telefone Do Contato Phone number of the contact, normalized by the server, required if identifying contact by name and phone number.
Campos Adicionais Additional optional fields for the card such as target column, initial comment, contact email, moderator ID, priority, opportunity status, and associated amount.

Output

JSON

  • id - Unique identifier of the created Kanban card.
  • kanbanId - Identifier of the Kanban board where the card was created.
  • columnId - Identifier of the column in the Kanban board where the card was placed.
  • contactId - Identifier of the contact associated with the card.
  • comment - Initial comment added to the card.
  • email - Email of the contact if created during the card creation.
  • moderatorId - Identifier of the moderator user assigned to the card.
  • priority - Priority level assigned to the card.
  • statusOportunity - Status of the opportunity associated with the card.
  • amount - Monetary value associated with the opportunity.

Dependencies

  • Requires an API key credential for ChatFunnel API authentication.

Troubleshooting

  • Common issues include invalid or missing Kanban ID, contact identification errors (wrong contact ID or missing name/phone), and invalid column ID for the Kanban board.
  • Error messages may indicate unsupported resource or operation if parameters are incorrect, or API errors if the server rejects the request due to invalid data.
  • To resolve errors, verify that the Kanban ID and contact details are correct, ensure the column ID exists in the specified Kanban, and check API credentials are valid.

Discussion