EntrarComeçar teste grátis
Meta Tech Provider

Como proteger suas automações do WhatsApp: chaves, webhooks e assinaturas

Proteja uma automação do WhatsApp em quatro pontos: a chave de IA, armazenada criptografada e usada somente para respostas de IA; o webhook que a automação chama, que deve verificar uma assinatura HMAC antes de confiar em uma requisição; o encaminhamento das mensagens recebidas, assinado com um segredo que você pode rotacionar; e as pessoas e assistentes com acesso, limitados ao que precisam.

A easyCoexistence armazena suas chaves de IA criptografadas e nunca mais as exibe, assina cada requisição do Call my webhook e cada mensagem encaminhada com X-EC-Signature usando um segredo que só você tem, e recusa endereços de webhook que não sejam HTTPS públicos.

AES-256-GCM

Criptografia usada em repouso para as chaves de IA salvas, os segredos de assinatura e o token de acesso da Meta do número.

Last 4

Tudo o que você volta a ver de uma chave de IA salva: "ending in" seguido dos seus últimos quatro caracteres.

192 bits

Aleatoriedade em cada segredo de assinatura: whsec_ seguido de 24 bytes aleatórios, um por automação e um por número com encaminhamento.

HTTPS only

As URLs de Call my webhook e de Forward precisam ser HTTPS públicas; endereços privados e internos são recusados ao salvar e antes de cada envio.

5 minutes

Limite sugerido para a idade do valor t da assinatura, para recusar requisições reenviadas (replay).

O que precisa ser protegido em uma configuração de automação do WhatsApp?

Cinco credenciais, cada uma com seu lugar e com o que fazer se vazar. Duas pertencem às próprias automações: a chave de IA e o segredo de assinatura do Call my webhook; o segredo de encaminhamento pertence ao número; o token de acesso e o login do seu assistente pertencem à conta. Saber qual é qual indica o que rotacionar quando algo der errado.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

Como as chaves de IA são armazenadas e usadas?

Somente pelo painel: o botão AI keys na página Automations, depois Test and save. A chave é verificada primeiro em um endpoint gratuito do provedor, que não consome tokens, e uma chave recusada pelo provedor é descartada sem ser salva. Uma chave válida é criptografada em repouso com AES-256-GCM, descriptografada somente para chamar esse provedor nas suas etapas de IA e agentes, e para transcrever mensagens de voz em uma chave da OpenAI ou OpenRouter, e, depois disso, exibida apenas como "ending in 1234". Nenhuma ferramenta MCP aceita ou devolve uma chave, então ela nunca passa por um chat com seu assistente.

Cada conta tem uma chave por provedor, e salvar uma nova substitui a antiga. Crie no provedor uma chave exclusiva para as automações, com limite de gastos quando o provedor oferecer, para poder revogá-la sem quebrar seus outros apps. Se o provedor passar a recusá-la, as automações que a usam aparecem como Paused e você recebe um único e-mail; salvar uma chave que funcione as reativa automaticamente.

Como verificar se uma requisição do Call my webhook é legítima?

Verifique a assinatura antes de ler qualquer outra coisa. Cada requisição traz X-EC-Signature: t=<segundos unix>,v1=<HMAC-SHA256 em hex de "<t>.<corpo bruto>">, calculado com o Signing secret daquela automação, que você copia da etapa no editor depois de salvar. Recalcule o HMAC sobre os bytes brutos, compare em tempo constante e recuse um t com mais de 5 minutos de diferença do seu relógio. O corpo também traz duas informações que pedem ação. dry_run é true quando a requisição vem do Try it, então pule tudo o que for irreversível, como criar um pedido. E run_id é único em cada execução, então guarde os que você já processou e recuse requisições reenviadas. Responda em até 20 segundos; {"reply": "..."} é enviado ao cliente exatamente como escrito, então nunca repasse texto do cliente sem verificação.

A Call my webhook request: headers and body
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>

{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
  "run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
  "channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
  "history": [
    { "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
    { "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
  ]
}

// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }

Como funcionam os segredos de encaminhamento e como rotacioná-los?

Um número configurado como Through easyCoexistence pode encaminhar as mensagens recebidas para o seu próprio sistema. Na primeira vez que você salva uma Forward URL, um segredo é gerado e exibido uma única vez, sob "Your signing secret, shown once. Copy it now:"; ele assina cada POST encaminhado com o mesmo esquema X-EC-Signature. O botão New secret na página do número, ou set_inbound_mode com rotate_secret definido como true, gera um substituto, também exibido uma única vez, que passa a assinar tudo, inclusive as repetições de entregas anteriores. Você também pode digitar um segredo próprio, com pelo menos 24 caracteres, que é armazenado e nunca mais exibido. Stop forwarding apaga o segredo, então salvar uma URL mais tarde começa com um segredo novo.

Rotacione quando sair da equipe alguém que tinha acesso, quando um segredo for parar em um repositório, em um ticket ou em um log, e ao trocar de hospedagem. O segredo de um Call my webhook pertence à automação e só o dono da conta o vê. Onde o editor mostra New secret, em um gatilho "Your system calls a URL", esse botão o substitui e o antigo para de funcionar na hora; em uma automação sem esse botão, crie a automação de novo, aponte seu receptor para o novo segredo e depois apague a automação antiga.

Quais endereços as automações podem chamar?

Somente endereços HTTPS públicos. Uma URL de Call my webhook ou uma Forward URL que comece com http://, aponte para localhost, para uma faixa de rede privada, para um nome .internal ou .local, ou para um endereço de metadados da nuvem é recusada ao ser salva, e verificada de novo após a resolução de DNS antes de cada requisição, para que um nome público não possa depois ser apontado para dentro de uma rede privada. Redirecionamentos não são seguidos: um 301 ou 302 faz a etapa falhar, então salve o endereço final.

Não coloque segredos na própria URL. list_automations devolve as etapas de cada automação, inclusive a URL do webhook, para qualquer assistente conectado à sua conta, então um token na query string fica legível ali. Deixe que a assinatura faça a prova.

Como manter o acesso no mínimo necessário?

Dê a cada pessoa e a cada ferramenta somente o acesso de que ela precisa para sua função, e remova o que não é mais usado. O lado do conector, com login, confirmações e ferramentas bloqueadas, é tratado na página sobre como conectar o WhatsApp a uma IA com segurança; do lado das automações, estes são os hábitos que mais importam:

  • Peça get_api_credentials somente em um chat privado: o token de acesso do número fica registrado nessa conversa.
  • Prefira Call my webhook ou uma Forward URL a entregar o token a uma ferramenta de terceiros.
  • Apague as automações que você desativou de vez; isso também elimina os segredos de assinatura delas.
  • Lembre que os logs de execução guardam mensagens e respostas dos clientes por 30 dias, e Conversations guarda as conversas pelo seu período de retenção (30, 90 ou 365 dias), ambos legíveis no painel e pelo seu assistente conectado.
  • Em um número configurado como Straight to your system, coloque um segredo longo e aleatório no caminho da URL de callback, já que ali não é possível verificar a assinatura da Meta.

Erros comuns

  • Verificar a assinatura sobre um JSON que o seu framework serializou de novo. Muitos parsers alteram espaçamento, escape ou ordem das chaves; calcule o HMAC sobre os bytes brutos da requisição sempre que sua stack os disponibilizar.
  • Executar ações com efeito real em chamadas de teste. O Try it chama seu webhook com dry_run definido como true; um pedido, reembolso ou gravação no CRM feito nesse momento é real.
  • Colar uma chave de IA em um chat com seu assistente para ganhar tempo. Nenhuma ferramenta a recebe, e ela fica registrada na conversa; use AI keys no painel.
  • Verificar um encaminhamento com o segredo do Call my webhook, ou o contrário. São segredos diferentes: um por número para encaminhamentos, um por automação para chamadas de webhook.
Fazendo isso com o EasyCoexistence

Seu número continua na Cloud API oficial da Meta por meio da Coexistência, monitorado 24/7. De R$ 29,90 até R$ 3,90 por número por mês, com o preço caindo conforme você adiciona números, e os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

A equipe ou o suporte da easyCoexistence consegue ver minha chave de IA?

A chave nunca é exibida depois que você a salva: nem no painel, nem nos resultados do MCP, nem nas informações que o assistente de suporte lê. Ela só é descriptografada pelo sistema, no momento em que chama seu provedor para gerar uma resposta de IA.

Quem pode ler os logs de execução das minhas automações?

Qualquer pessoa com login na sua conta easyCoexistence, incluindo as pessoas que você convidou, na aba Runs, e qualquer assistente conectado à conta, por meio de list_automation_runs e get_automation_run. Os logs incluem a mensagem do cliente e a resposta, e são apagados após 30 dias.

Como remover uma chave de IA com segurança?

Primeiro desative (Switch Off) as automações que a usam e qualquer agente que rode com ela, depois selecione Remove em AI keys e revogue a chave no provedor. Se você a remover enquanto automações ainda a usam, elas são pausadas na próxima resposta de IA e você recebe um e-mail.

O Try it envia dados de clientes para o meu webhook?

Envia somente o texto de exemplo que você digitou, com dry_run definido como true e um histórico vazio. Execuções reais enviam a mensagem recebida e as mensagens recentes da conversa, até 10, então trate seu endpoint como um sistema que processa dados de clientes.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em