Como criar um atendente de IA no WhatsApp com o Claude

Dá para colocar um atendente de inteligência artificial respondendo sozinho no seu WhatsApp, usando o Claude (da Anthropic) para pensar e a API REST do Visto Azul para receber e responder. Veja a arquitetura e o passo a passo.

A ideia em uma frase

Quando um cliente manda mensagem, o Visto Azul avisa o seu sistema por webhook. Seu sistema pergunta ao Claude qual é a melhor resposta e devolve essa resposta pelo WhatsApp usando a nossa API. O cliente conversa com uma IA que fala como o seu negócio, 24 horas por dia.

O fluxo, em três passos

1. Receber: o Visto Azul faz um POST no seu endpoint sempre que chega uma mensagem.
2. Pensar: seu endpoint envia o texto do cliente para o Claude e recebe a resposta.
3. Responder: seu endpoint envia a resposta do Claude de volta pelo WhatsApp, via nossa API.

Base da API do Visto Azul: https://dashboard.vistoazul.com.br/api/v1, com o cabeçalho Authorization: Bearer SUA_API_KEY.

1. Receber a mensagem (webhook)

No painel, abra as configurações da instância (engrenagem no card do número), aba Webhook, e aponte para a URL do seu endpoint. A partir daí, cada mensagem recebida chega assim:

{
  "EventType": "messages",
  "instanceName": "vendas",
  "event": { "from": "5511999999999", "text": "Vocês entregam hoje?" }
}

Ignoramos por padrão as mensagens que a própria automação envia, para o bot não conversar com ele mesmo. Veja o formato completo em Webhooks.

2. Pensar com o Claude

Com o texto do cliente em mãos, seu servidor chama a API de mensagens da Anthropic. A chamada é simples: você envia um system prompt (a personalidade e as regras do seu atendimento) e a mensagem do cliente, e recebe a resposta.

POST https://api.anthropic.com/v1/messages
# headers: x-api-key, anthropic-version, content-type
{
  "model": "claude-sonnet-5",
  "max_tokens": 300,
  "system": "Você é o atendente da Loja X. Seja cordial e objetivo.",
  "messages": [{ "role": "user", "content": "Vocês entregam hoje?" }]
}

Para volume alto e custo menor, o Claude Haiku é rápido e barato. Para respostas mais elaboradas, use o Sonnet. Você pode incluir no system prompt as informações do seu negócio (horários, políticas, catálogo) para a IA responder com precisão.

3. Responder no WhatsApp

Pegue o texto que o Claude devolveu e mande de volta pelo mesmo número, com uma chamada à nossa API:

POST https://dashboard.vistoazul.com.br/api/v1/messages/text
# header: Authorization: Bearer SUA_API_KEY
{
  "instance": "vendas",
  "number": "5511999999999",
  "text": "Sim! Pedidos até 16h saem hoje. Quer que eu registre o seu?"
}

Pronto: o cliente recebeu uma resposta de IA que soa como a sua empresa, em segundos.

Sem escrever código

Se você não é desenvolvedor, tem dois caminhos:

• Use o atendente de IA nativo do Visto Azul, que já responde sozinho a partir da base de conhecimento do seu negócio, direto no painel.
• Monte o fluxo acima no n8n arrastando blocos, sem programar. Veja como conectar o WhatsApp ao n8n.

Boas práticas

• Limite o max_tokens para respostas curtas e diretas, do jeito que funciona no WhatsApp.
• Deixe claro no system prompt quando a IA deve passar para um humano (por exemplo, reclamações ou fechamento de venda).
• Guarde o histórico da conversa por contato para a IA manter o contexto entre mensagens.