Nó CRM

O nó CRM (crm_cards) lê ou grava cards nos boards CRM WhatsWave: busca por telefone do contato ou coluna, upsert (criar/atualizar/mover) ou adiciona comentários com anexos opcionais.

Encontre-o na paleta WhatsWave em Automações.

Figura 1: Nó CRM — operação upsert com board, coluna e telefone

O que faz

Cards vinculam contatos (por telefone) a colunas em um board. Upsert cria card novo ou atualiza/move existente para o mesmo telefone naquele board.

Operação: Get cards (crm_op_fetch)

Endpoint: GET /crm/cards/fetch

Retorna cards daquele contato no board selecionado.

Operação: Get column cards (crm_op_fetch_column)

Endpoint: GET /crm/cards/fetch?scope=column

Lista todos os cards de uma coluna — útil para processamento em lote ou relatórios.

Operação: Upsert card (crm_op_upsert)

Endpoint: POST /crm/cards/upsert

Resolução de coluna: use column_id ou column_name. Para cards novos sem coluna, usa-se a primeira coluna.

Operação: Comment on card (crm_op_comment)

Endpoint: POST /crm/cards/comment

Dicas e boas práticas

• Upsert é idempotente por telefone + board — seguro chamar em todo webhook; atualiza title/description e move coluna quando especificado.
• Use column_name para workflows portáveis entre ambientes onde UUIDs de coluna diferem.
• Comente com author_type: ai ao registrar decisões do AI Agent na timeline do card.
• Fetch antes de upsert quando precisar preservar campos não incluídos no payload de upsert.
• Combine com Send — mover para coluna "Won" → enviar template de agradecimento.

Exemplos de uso

Exemplo 1 — Lead de webhook para pipeline

Trigger: Webhook — formulário de landing page.

Fluxo:

1. Contact — Create
2. CRM — Upsert
   • column_name: Novo lead
   • title: {{trigger.body.name}}
   • contact_phone_number: {{trigger.body.phone}}
3. Send — mensagem de boas-vindas

Exemplo 2 — Pagamento move card + comentário

Trigger: Webhook — pagamento confirmado.

Fluxo:

1. CRM — Upsert
   • column_name: Pago
   • title: Order {{trigger.body.order_id}}
2. CRM — Comment
   • card_id: {{crm_1.card.id}}
   • comment_text: Paid R$ {{trigger.body.amount}}

Exemplo 3 — Processar backlog de coluna

Trigger: Schedule — a cada hora.

Fluxo:

1. CRM — Get column cards, coluna "Follow-up due"
2. Loop — por card → Message queue lembrete usando contact_phone_number dos dados do card

FAQ

IDs legados crm_card_get, crm_card_upsert, etc.?

Todos mapeiam para crm_cards com operation templates.

Upsert vs create/update separados?

Upsert único trata ambos — chaveado por board + telefone.

Posso excluir cards?

Não via este nó — use UI do CRM ou API fora da paleta.

Por que a movimentação falhou?

column_id inválido para o board ou typo em column_name — verifique se board/column pickers correspondem.

Artigos relacionados

• Nó Contact
• Nó Conversations
• Visão geral WhatsWave