Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Bots e IA

Claude no WhatsApp: responder clientes com a API de mensagens da Anthropic

Ligue o Claude à instância de WhatsApp com o tipo anthropic: chave, modelo, instruções, memória curta, aprovação humana e cuidados com o conteúdo.

5 min de leitura Atualizado em 14 de novembro de 2026
Resposta curta
No PUT /integrations/bot, use type: "anthropic", a sua api_key da Anthropic, o model e o system_prompt. A ProxyBox chama POST https://api.anthropic.com/v1/messages com as instruções, as últimas mensagens do contato (memória curta de até 20) e a nova, e envia o texto dos blocos de resposta pelo seu número.

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?

  1. Uma chave de API da Anthropic (vem do console da Anthropic; é a sua conta e o seu custo).
  2. 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.
  3. Uma instância conectada e a chave da ProxyBox.

Como configuro?

bash
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átis

O que a ProxyBox envia?

json
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_prompt os 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?

  1. Teste antes. POST /integrations/bot/test com perguntas difíceis, inclusive tentativas de fazer o modelo sair do assunto. O teste não envia nada ao WhatsApp.
  2. Aprovação humana na estreia. Use approval_mode: "bots" por alguns dias e leia o que o bot teria dito.
  3. 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.
  4. 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.
  5. 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

Í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.

Perguntas frequentes

O que é o conector de IA (MCP) e o que é o bot Claude?
São coisas diferentes. No MCP, uma pessoa conversa com o Claude no computador dela e o Claude usa o WhatsApp como ferramenta, com confirmação. No bot, o Claude responde sozinho às mensagens que chegam no número, sem ninguém digitando.
Quem paga o uso do Claude?
Você, com a sua chave da Anthropic. A ProxyBox não revende o modelo.
Dá para o Claude mandar mensagem que ninguém aprovou?
Só se você deixar. Com a aprovação humana em modo bots, a resposta fica pendente até uma pessoa liberar.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp