Recurso em beta: pode mudar. Versão beta, em fase de testes.
Os gatilhos, limites e proteções comuns estão na visão geral dos bots.
Situação: versão beta, em fase de testes.
Para que serve?
Para um atendimento em linguagem natural, com respostas que seguem as suas instruções: tirar dúvidas, confirmar informações do pedido, fazer a triagem e passar para uma pessoa. Você define o tom e os fatos; o modelo escreve. Se o seu caso exige regras rígidas ou fluxo fixo, o Typebot ou um fluxo no n8n dão mais controle.
O que preciso?
- Uma chave de API da Anthropic (vem do console da Anthropic; é a sua conta e o seu custo).
- O nome do modelo que você quer usar. Os nomes mudam com o tempo: confira a lista atual na documentação da Anthropic em vez de copiar um nome de um tutorial antigo.
- Uma instância conectada e a chave da ProxyBox.
Como configuro?
curl -X PUT "https://proxybox.com.br/api/whatsapp/v1/integrations/bot" \
-H "apikey: SUA_CHAVE" -H "Content-Type: application/json" \
-d '{
"type": "anthropic",
"enabled": true,
"api_key": "SUA_CHAVE_DA_ANTHROPIC",
"model": "NOME_DO_MODELO",
"system_prompt": "Você atende a Clínica Exemplo pelo WhatsApp. Responda em português, em até 3 frases, sem markdown. Marque consultas apenas pedindo nome e melhor horário; nunca informe valores. Se não souber, diga que um atendente continuará a conversa.",
"history_messages": 10,
"max_tokens": 300,
"trigger": "all",
"ignore_groups": true,
"delay_seconds": 2
}'
Não existe campo url para este tipo: o endereço é sempre o da Anthropic, https://api.anthropic.com.
Quer rodar isto agora? O sandbox é grátis, não precisa de número e já vem com a chave da API.
Testar grátisO que a ProxyBox envia?
POST https://api.anthropic.com/v1/messages
x-api-key: (a sua chave)
anthropic-version: 2023-06-01
{
"model": "NOME_DO_MODELO",
"max_tokens": 300,
"system": "Você atende a Clínica Exemplo...",
"messages": [
{ "role": "user", "content": "Quero marcar uma consulta" },
{ "role": "assistant", "content": "Claro! Qual o seu nome?" },
{ "role": "user", "content": "Maria Souza" }
]
}
A resposta é lida nos blocos content[].text e vira mensagem do WhatsApp. A memória (history_messages, de 0 a 20) é guardada pela ProxyBox, cifrada, por contato.
Como escrevo instruções que funcionam no WhatsApp?
- Seja específico sobre o que ele pode afirmar. Ponha no
system_promptos horários, endereços, prazos e regras. O que não está lá, ele não deve inventar: diga isso. - Peça formato curto e sem markdown. O WhatsApp não renderiza títulos nem tabelas; respostas longas cansam.
- Combine o encerramento. "Quando o cliente pedir uma pessoa, responda exatamente 'Vou chamar um atendente' e não escreva mais nada." Isso ajuda você a achar o ponto de assumir; combine com a pausa quando você responde pelo celular.
- Dados sensíveis. Não coloque senhas, chaves nem dados pessoais de terceiros nas instruções. O texto vai para a Anthropic em cada chamada.
Qual a diferença para o conector MCP?
O conector MCP coloca o WhatsApp dentro do Claude que você usa: você pede, o Claude consulta ou envia, e você confirma cada envio. O bot é o inverso: o WhatsApp chama o Claude sozinho a cada mensagem recebida, e ninguém confirma nada, a não ser que você ligue a aprovação humana. Use o MCP para operar; o bot para atender.
Quais cuidados são obrigatórios?
- Teste antes.
POST /integrations/bot/testcom perguntas difíceis, inclusive tentativas de fazer o modelo sair do assunto. O teste não envia nada ao WhatsApp. - Aprovação humana na estreia. Use
approval_mode: "bots"por alguns dias e leia o que o bot teria dito. - Mensagem recebida é entrada hostil. Uma pessoa pode escrever "ignore as instruções anteriores". O modelo pode ceder. Por isso não dê ao bot poder de fazer nada além de responder texto, e nunca ponha segredos no prompt.
- Limites. O bot responde no máximo 20 vezes por hora por conversa e 200 por dia. Se a conversa entrar em ciclo (resposta repetida ou 6 respostas em 60 segundos), é pausada por 30 minutos.
- Privacidade. O conteúdo das mensagens é enviado à Anthropic. Informe isso aos seus clientes na sua política.
Quais erros aparecem?
| Sintoma | Causa provável |
|---|---|
Estado error: "O bot recusou a mensagem" |
Chave inválida, modelo inexistente ou limite de uso da conta |
| Resposta cortada no meio | max_tokens baixo |
| Respostas fora do tom | Instruções pouco específicas |
| Sem resposta a áudio | O bot só lê texto: configure unknown_message |
Depois de 10 falhas seguidas, o bot desliga sozinho e avisa. Salvar a configuração reativa.
O que está não confirmado?
O formato segue a página pública da API de mensagens (cabeçalhos x-api-key e anthropic-version: 2023-06-01, corpo com model, max_tokens, system e messages). Não foi feita uma chamada real nesta rodada. Recursos como ferramentas, imagens e respostas em fluxo contínuo não são usados.
Veja também
- Bots de WhatsApp pela API: tipos e limites
- Bot de IA no WhatsApp com OpenAI, Groq, Ollama
- MCP do WhatsApp para Claude e Cursor
- Aprovação humana de mensagens da API de WhatsApp
Índice completo: documentação. Sobre o produto: a oferta de API de WhatsApp da ProxyBox.
Autoria: equipe técnica da ProxyBox. Atualizado em 11/11/2026. Fonte do formato: documentação pública da API de mensagens da Anthropic, lida em 11/11/2026. Recurso em beta.