Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Deixe o Claude responder aos seus clientes do WhatsApp

O Claude pode responder aos clientes do WhatsApp Business através da API oficial da Meta: uma automação envia a mensagem recebida, as suas instruções e a conversa recente para a API da Anthropic, com a sua chave, e a resposta do Claude sai do seu número. Cria a chave na Claude Console, escolhe um id de modelo Claude e continua a usar a app WhatsApp Business no seu telemóvel.

A easyCoexistence executa a automação que põe o Claude no seu número WhatsApp Business: a sua chave Anthropic, o seu modelo Claude e as suas Instructions, com o histórico da conversa, os limites de resposta e a pausa quando responde a partir do telemóvel já incluídos.

sk-ant-

Como começa uma chave da API Claude; a Console mostra-a por inteiro só uma vez, quando é criada.

Separate bill

Um plano de chat Claude pago e a API Claude são faturados separadamente, embora Max, Ultra e Team incluam alguns créditos mensais de API.

400

A resposta da Anthropic quando uma chave não associada a um espaço de trabalho chama a API sem o cabeçalho do ID do espaço de trabalho.

402

O billing_error da Anthropic: um problema de faturação ou pagamento na conta, à parte do 401 para uma chave errada ou expirada.

max_tokens

Os tokens de raciocínio contam para este limite, pelo que uma passagem de raciocínio longa pode esgotar o orçamento antes de o texto da resposta acabar.

45 seconds

O tempo máximo que um passo Reply with AI espera pelo modelo antes de essa execução falhar.

Como é que o Claude responde a um cliente do WhatsApp?

Através de um passo Reply with AI cujo Provider é Anthropic. Um cliente escreve, a Meta entrega a mensagem à easyCoexistence pela Cloud API, a automação correspondente chama a Messages API da Anthropic com a sua chave e o modelo escolhido, e o texto do Claude é enviado de volta na mesma conversa a partir do seu número WhatsApp Business. A resposta também aparece na app no seu telemóvel.

A própria app Claude não tem qualquer papel nisto, e ninguém tem de manter uma conversa aberta. O Claude pode continuar a criar a automação por si através do conector easyCoexistence no Claude, que chama create_automation e depois test_automation, mas responder aos clientes corre com a chave API que guardou.

1Customer writesThe message reaches your number
2Automation matchesKeyword, first message, after hours or catch-all
3Claude answersAnthropic API, your key, your model id
4Reply on the chatSent from your number, visible in the app

Que chave da Anthropic funciona, e como se cria uma?

Uma chave API Claude, da Claude Console, e não um início de sessão em claude.ai. Abra a página de chaves API em platform.claude.com/settings/keys, clique em Create key, dê-lhe um nome, escolha uma validade e uma conta associada, e copie a chave que começa por sk-ant-: a Console nunca a volta a mostrar. Adicione créditos nas definições de faturação da Console antes de os clientes dependerem dela.

Duas escolhas na criação decidem se as respostas continuam a funcionar. Limite a chave a um só espaço de trabalho: a automação envia apenas a chave, sem cabeçalho de espaço de trabalho, e a Anthropic recusa os pedidos de uma chave sem âmbito com um erro 400. Escolha uma validade longa ou Never, porque uma chave expirada devolve 401 e pausa as suas automações Claude. Depois, na página Automations, abra AI keys, clique em Add key ao lado de Anthropic, cole a chave e clique em Test and save. A verificação lê a lista de modelos da Anthropic, não gasta tokens e preenche o seletor Model.

Que modelo Claude deve responder?

O campo Model lista os modelos que a Anthropic devolve para a sua chave, e também pode escrever um id. A Anthropic descreve a sua gama atual por função e velocidade, o que encaixa bem nas respostas de chat: um cliente à espera no WhatsApp repara em segundos. Cada id Claude é um snapshot fixo, por isso um modelo mantém o mesmo comportamento até a Anthropic o retirar; depois da retirada, a Anthropic responde 404 e essas execuções falham até escolher um id mais recente.

claude-haiku-5-5Anthropic: for high-volume, latency-sensitive tasks; comparative latency Fastest
claude-sonnet-5-5Anthropic: the best combination of speed and intelligence; latency Fast
claude-opus-5-5Anthropic: for long-running agentic coding and knowledge work; latency Moderate

Porque é que uma resposta Claude precisa de mais espaço em Longest reply?

Porque os modelos Claude atuais pensam antes de responder, e esse raciocínio usa o mesmo orçamento de tokens que a resposta. A Anthropic indica o raciocínio como sempre ativo no Claude Opus 5.5 e ativo por predefinição no Claude Sonnet 5.5 e no Claude Haiku 5.5. O passo Reply with AI não envia qualquer definição de raciocínio ou de esforço, pelo que se aplica o valor predefinido do próprio modelo, e Longest reply (tokens) passa a ser o limite para o raciocínio mais o texto.

Com o valor predefinido de 600, uma pergunta que leve o modelo a pensar muito pode deixar a resposta cortada a meio de uma frase, ou vazia; nesse caso a execução falha com "The model returned an empty reply" e recebe um email. Para um modelo que pensa, defina Longest reply entre 1,000 e 2,000 e limite o tamanho da resposta nas Instructions, por exemplo "responda em 1 a 3 frases curtas". Os tokens de raciocínio aparecem na contagem out de cada execução e são faturados pela Anthropic.

O que recebe o Claude da conversa?

Um prompt de sistema e uma conversa curta. O prompt de sistema são as suas Instructions, até 20,000 caracteres, com {{first_name}}, {{name}}, {{message}} e {{phone}} preenchidos, seguidas de cinco linhas que a easyCoexistence acrescenta: escrever uma mensagem curta em texto simples, na língua do cliente; dizer que uma pessoa responderá em breve quando for pedido ou quando houver um impasse; nunca inventar preços, stock, datas ou políticas; e dizer que é o assistente automático da empresa quando lhe perguntam, o que a primeira resposta depois de um dia sem atividade faz sem ser pedido.

A conversa tem até 20 mensagens anteriores da conversa, conservadas durante os dias que escolher em Conversations (30, 90 ou 365), 10 por predefinição, terminando na nova. As mensagens dos clientes tornam-se turnos user, e as respostas do seu número, escritas no telemóvel ou enviadas por uma automação, tornam-se turnos assistant. Mensagens consecutivas do mesmo lado juntam-se num só turno, e as mensagens da empresa no início são descartadas, pois alguns fornecedores recusam uma conversa que comece pelo assistente. As fotos chegam como um marcador, como "[image]". Uma nota de voz é transcrita como "[voice message]" seguido das palavras apenas quando também tem uma chave OpenAI ou OpenRouter, pois a Anthropic não transcreve fala; sem chave, fica "[voice message]".

O que acontece quando a Anthropic devolve um erro?

Depende do código de estado, e o registo de execução guarda a mensagem da Anthropic em qualquer caso. Os códigos que apontam para a conta pausam todas as automações da sua conta que usam a Anthropic, porque nenhuma resposta pode ter sucesso até os corrigir. Os códigos que apontam para um pedido concreto falham apenas essa execução: os limites de pedidos e as sobrecargas têm primeiro uma nova tentativa rápida, e uma execução falhada envia-lhe um email, no máximo uma vez por automação a cada 6 horas, para poder responder a esse cliente pessoalmente.

401 or 403Bad, revoked, expired or unauthorized key: Claude automations pause, one email
402 billing_errorPayment problem: also pauses them, shown as a refused key; fix billing, then Test and save again
400Unscoped key, or a spend limit you set in the Console: that run fails, email sent
404Model id unknown or retired: that run fails until you pick another model
429 or 529Rate limit, tier spend cap or overload: that run fails, email sent

O Claude pode configurar isto por si?

Sim, assim que a sua chave Anthropic estiver guardada no painel, pois nenhuma ferramenta aceita uma chave. No Claude, com o conector easyCoexistence ativado, descreva o assistente que quer e peça que fique desligado para poder testar primeiro. O Claude chama list_numbers, depois create_automation com provider anthropic, e depois test_automation com uma pergunta de exemplo. Sem uma chave guardada, create_automation recusa o passo com "save your anthropic API key on the Automations page first".

create_automation arguments for a Claude reply (example)
{
  "connection_id": "<from list_numbers>",
  "name": "Claude answers questions",
  "enabled": false,
  "trigger": { "type": "message_received", "match": "any" },
  "steps": [
    {
      "type": "ai_reply",
      "provider": "anthropic",
      "model": "claude-sonnet-5-5",
      "prompt": "You are the assistant of Bloom Cafe. Open daily 8:00 to 18:00. ...",
      "history": 10,
      "max_tokens": 1500
    }
  ],
  "settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}

Como configurar

  1. Create a Claude API keyIn the Claude Console, open API keys, click Create key, scope it to one workspace, choose a long expiration or Never, and copy the sk-ant- key.
  2. Add creditsAdd credits or a payment method in the Console's billing settings, so Anthropic accepts the replies.
  3. Save it under AI keysOn the Automations page, open AI keys, click Add key next to Anthropic, paste the key and click Test and save. It then shows as Added, ending in its last four characters.
  4. Add a Reply with AI stepClick New automation, then Start from scratch, delete the empty Reply with text step and add a Reply with AI step with the + under Say something. Set Provider to Anthropic, pick a Claude model and write your Instructions.
  5. Give thinking roomRaise Longest reply (tokens) to between 1,000 and 2,000, and ask for short answers in the Instructions.
  6. Save it Off, test, then turn it onFlip the switch to Off, click Save, then Test and Run test with real questions. Claude really answers and nothing is sent. Flip it On and save.

Erros comuns

  • Criar a chave sem espaço de trabalho. A automação não envia cabeçalho de espaço de trabalho, pelo que a Anthropic responde 400 em todas as respostas, mesmo que a chave tenha passado em Test and save.
  • Escolher uma validade de 7 ou 30 dias. Quando a chave expira, a Anthropic devolve 401, todas as automações Claude pausam e nada responde até guardar uma nova chave.
  • Deixar Longest reply em 600 num modelo que pensa. O raciocínio partilha esse orçamento, por isso perguntas longas podem acabar numa resposta cortada ou vazia.
  • Escrever, com Provider Anthropic, a forma OpenRouter de um id Claude, como anthropic/claude-sonnet-5.5. Os ids da Anthropic usam hífens, como claude-sonnet-5-5, e um id desconhecido falha com 404.
Fazer isto com a EasyCoexistence

Não cobramos pela IA nem acrescentamos qualquer margem, e as automações não têm custo extra. De US$ 9 até US$ 0.75 por número ligado por mês, a descer à medida que acrescenta números, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Posso usar o meu plano Claude Pro ou Max em vez de uma chave API?

Não. As respostas chamam a API Claude, que precisa de uma chave da Claude Console e é faturada lá. A Anthropic fatura a API separadamente dos planos de chat; Max, Ultra e Team incluem alguns créditos mensais de API que a organização da chave pode usar.

Posso chegar ao Claude através do OpenRouter?

Sim. Escolha Provider OpenRouter e escreva um id Claude do catálogo do OpenRouter, como anthropic/claude-sonnet-5.5. Os tokens são então faturados através dos seus créditos OpenRouter, em vez da sua conta Anthropic.

O Claude e um modelo da OpenAI podem responder no mesmo número?

Sim, em automações diferentes. Só uma automação responde a cada mensagem, por isso pode correr o Claude na automação de captura geral e um modelo da OpenAI numa automação por palavra-chave, cada um com a sua chave guardada.

O Claude continua a responder depois de 24 horas sem mensagem do cliente?

Não. As respostas em texto livre, incluindo as do Claude, só são enviadas nas 24 horas seguintes à última mensagem do cliente, como a Meta exige; as execuções posteriores são ignoradas como window_closed, e só um template aprovado pode chegar a esse cliente.

Continue a ler

Pronto para começar?

Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.

Começar período experimental gratuito

Verificado em