Skip to main content
Este guia mostra o caminho mais comum de uma integração: garantir o contato, abrir uma conversa num canal e enviar mensagens nela. Os exemplos usam a conta 3 e o canal 7; troque pelos seus números (veja Introdução).

Responder uma conversa que já existe

Se a conversa já existe, envie a mensagem direto nela. O número da conversa é o mesmo que aparece no app (por exemplo, #1234).
Para registrar uma nota que só a equipe vê, envie "private": true.

Começar uma conversa nova

1

Crie ou encontre o contato

Crie o contato informando o canal em que ele vai conversar:
A resposta traz o contato e, em contact_inboxes, o source_id dele nesse canal. Se o contato já existe, busque-o em GET /api/v1/accounts/3/contacts/search?q=+5584999990000.
2

Abra a conversa com a primeira mensagem

Você também pode mandar assignee_id (atendente) e team_id (time) para a conversa já nascer atribuída.

WhatsApp fora da janela de 24 horas

No WhatsApp, a empresa só envia texto livre até 24 horas depois da última mensagem do cliente. Fora dessa janela, a primeira mensagem precisa ser um modelo aprovado pela Meta (veja Modelos do WhatsApp). Envie o modelo em template_params:
processed_params preenche as variáveis do modelo, na ordem em que aparecem ({{1}}, {{2}}…). A Meta cobra cada modelo enviado conforme a categoria: no Brasil, R0,33pormensagemdeMarketingeR 0,33 por mensagem de Marketing e R 0,04 por mensagem de Utilidade.
A conversa nova por API funciona nos canais de chat do site, SMS, API, e-mail e WhatsApp. No Instagram e no Facebook, a conversa só começa quando o cliente escreve primeiro.