Primeiros passos

O que é a plataforma

A plataforma recebe a mensagem do cliente, guarda o histórico da conversa, pensa a resposta com inteligência artificial e envia de volta — tudo em segundos.

O caminho de uma mensagem, do começo ao fim:


Cliente no WhatsApp
   → provedor de WhatsApp (Datafy ou uazapi)
   → a plataforma recebe, agrupa e guarda
   → o agent pensa e escreve a resposta
   → a plataforma envia a resposta
   → Cliente no WhatsApp

A plataforma nunca inventa resposta. Se o agent não conseguir responder, ela prefere insistir em silêncio a mandar uma desculpa genérica ao cliente. Isso está explicado em Quando algo dá errado.

As quatro palavras que aparecem em todo lugar

Organização

É a empresa/cliente dentro da plataforma. Tudo pertence a uma organização: os agents, as chaves de acesso, os webhooks. Uma organização nunca enxerga os dados de outra.

Você cria organizações na tela inicial do painel (Organizations).

Agent

É o robô de atendimento. Um agent tem:

um nome e uma personalidade (o texto que descreve como ele deve se comportar);
credenciais do Claude, sem as quais ele não consegue pensar;
uma ou mais conexões de WhatsApp;
opcionalmente, webhooks de saída para copiar as conversas para outro sistema.

Uma organização pode ter vários agents — por exemplo, um para vendas e outro para suporte, cada um com o seu número de WhatsApp.

Conversa

É o fio de mensagens entre um cliente e um agent, em um canal. A plataforma usa o telefone do cliente como identificador da conversa.

Duas coisas importantes sobre conversa:

A plataforma espera você terminar de falar. Se o cliente manda cinco mensagens picadas (“oi”, “bom dia”, “queria saber”, “sobre o orçamento”, “de ontem”), a plataforma junta tudo num lote e só então o agent monta a resposta. Isso evita o robô responder cinco vezes coisas desencontradas.
A conversa tem memória. O histórico é guardado e mandado junto no próximo pedido, então o agent sabe o que já foi combinado.

O mesmo telefone falando pelo canal oficial e pelo não oficial conta como duas conversas diferentes — a identidade da conversa inclui o canal. Isso importa na hora de pausar o bot (veja Atendimento humano).

Provider

É o serviço por onde o WhatsApp chega até a plataforma. Existem dois, e eles não são intercambiáveis:

Provider	Nome na tela	O que é
`datafy`	WhatsApp oficial	API oficial do WhatsApp (Meta), intermediada pela Datafy. Precisa de número aprovado e de um app configurado na Meta.
`uazapi`	WhatsApp não oficial	Conexão feita lendo um QR code com o celular, como o WhatsApp Web. Mais rápido de ligar, sem aprovação.

Cada guia de conexão está aqui: oficial (Datafy) · não oficial (uazapi).

Como o painel está organizado

Ao abrir um agent, você vê um menu lateral com estas seções:

Seção	Para que serve
Profile	Nome, personalidade e contexto do agent.
Dashboard access	Credenciais de acesso ao painel técnico do próprio agent.
Integrations	Cards do WhatsApp oficial (Datafy) e não oficial (uazapi).
Environment	Variáveis de execução do agent.
Inbound channels	O vínculo que faz as mensagens do provedor chegarem neste agent.
Webhooks	Envio de cópia das conversas para outro sistema.

Ordem recomendada para colocar um cliente no ar

Criar a organização.
Criar o agent e escrever a personalidade dele.
Configurar as credenciais do Claude (senão ele não responde).
Conectar o WhatsApp (oficial ou não oficial).
Criar o canal de entrada e colar a URL no painel do provedor.
(Opcional) Cadastrar o webhook de saída para o sistema do cliente.
Mandar uma mensagem de teste pelo WhatsApp e conferir a resposta.