Nó Conversations

O nó Conversations (whatsapp_fetch_chats) lista, recupera, atualiza ou transfere conversas WhatsApp (chats). Update suporta tags, estado de arquivamento e delegação a um membro da empresa. Transfer atribui o chat a um membro da equipe e pode pausar o agente de IA conforme configurações da empresa.

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

Figura 1: Nó Conversations — operação update com tags e delegação

O que faz

Operação: List conversations (chat_op_list)

Endpoint: GET /chats/fetch

Operação: Get conversation (chat_op_get)

Endpoint: GET /chats/get

Retorna um único objeto conversation na saída.

Operação: Update conversation (chat_op_update)

Endpoint: PUT /chats/update

Operação: Transfer (chat_op_transfer)

Endpoint: POST /chats/transfer

O comportamento de pausa do agente de IA depende da configuração em Settings → Advanced → AI Agents.

Dicas e boas práticas

• Get antes de update quando precisar das tags atuais — update substitui tags ao passar tags; omita o campo para preservar tags existentes.
• Use nomes de tags separados por vírgula, não arrays JSON, em tags.
• Transfer vs delegate: Transfer é a operação explícita de handoff com semântica focada no responsável; delegate-member-name no update define atribuição durante atualização mais ampla de metadados.
• List com search para busca aproximada quando só tiver telefone parcial ou nome do cliente no webhook.
• Archive (is_archived: true) após resolver tickets em fluxos totalmente automatizados para manter inboxes limpos.

Exemplos de uso

Exemplo 1 — Etiquetar leads VIP de webhook

Trigger: Webhook — plan: enterprise.

Fluxo:

1. Conversations — Update
   • contact_number: {{trigger.body.phone}}
   • tags: vip, enterprise
2. CRM — upsert do card na coluna "Enterprise"

Exemplo 2 — Escalar para agente humano

Trigger: Webhook — confiança da IA baixa.

Fluxo:

1. Conversations — Transfer
   • assignee: {{trigger.body.team_lead_email}}
2. Send — Text: "A specialist will join you shortly."

Exemplo 3 — Arquivar chats resolvidos à noite

Trigger: Schedule — diário às 23:00.

Fluxo:

1. Conversations — List, is_archived: false, filtro de tag resolved via list + loop
2. Loop — por chat → Update is_archived: true

FAQ

Por que não encontro a conversa?

Get/Update/Transfer exigem ambos instance_id e contact_number. List é mais flexível.

O que acontece se passar tags vazias?

Todas as tags são removidas da conversa.

Posso delegar com variável?

Sim — {{trigger.body.responsavel}} ou {{company.members[0].user.name}} em delegate-member-name / assignee.

A transferência para o agente de IA?

Depende das configurações de IA da empresa — confira Settings → Advanced → AI Agents.

Artigos relacionados

• Nó Messages
• Nó AI Agent
• Nó CRM