Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Proteja as suas automatizações de WhatsApp: chaves, webhooks e assinaturas

Proteja uma automatização WhatsApp em quatro pontos: a chave de IA, guardada cifrada e usada apenas para respostas de IA; o webhook que uma automatização chama, que deve verificar uma assinatura HMAC antes de confiar num pedido; o reenvio das mensagens recebidas, assinado com um segredo que pode rodar; e as pessoas e os assistentes com acesso, limitados ao que precisam.

A easyCoexistence guarda as suas chaves de IA cifradas e nunca as volta a mostrar, assina cada pedido de Call my webhook e cada mensagem reenviada com X-EC-Signature, usando um segredo que só a sua conta detém, e recusa endereços de webhook que não sejam HTTPS públicos.

AES-256-GCM

Cifragem em repouso para as chaves de IA guardadas, os segredos de assinatura e o token de acesso do número na Meta.

Last 4

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

192 bits

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

HTTPS only

Os endereços de webhook e de reenvio têm de ser HTTPS públicos; endereços privados e internos são recusados ao guardar e antes de cada envio.

5 minutes

Limite sugerido para a idade do valor t da assinatura, para recusar pedidos repetidos.

O que precisa de proteção numa automatização WhatsApp?

Cinco credenciais, cada uma com o seu lugar e a sua própria solução se for divulgada. Duas pertencem às próprias automatizações: a chave de IA e o segredo de assinatura de Call my webhook. O segredo de reenvio pertence ao número. O token de acesso e o início de sessão do seu assistente pertencem à conta. Saber qual é qual diz-lhe o que rodar quando algo corre mal.

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 são guardadas e usadas as chaves de IA?

Apenas a partir do painel: o botão AI keys na página Automations, depois Test and save. A chave é primeiro verificada num endpoint gratuito do fornecedor, que não gasta tokens, e uma chave recusada pelo fornecedor é descartada sem ser guardada. Uma chave válida é cifrada em repouso com AES-256-GCM, decifrada apenas para chamar esse fornecedor nos seus passos de IA e agentes, e para transcrever mensagens de voz com uma chave OpenAI ou OpenRouter, e depois mostrada apenas como "ending in 1234". Nenhuma ferramenta MCP aceita ou devolve uma chave, por isso ela nunca passa por uma conversa com o seu assistente.

Uma conta tem uma chave por fornecedor, e guardar uma nova substitui a antiga. Crie uma chave dedicada às automatizações no fornecedor, com limite de gastos quando o fornecedor o oferecer, para que possa ser revogada sem interromper as suas outras aplicações. Se o fornecedor alguma vez a recusar, as automatizações que a usam ficam em Paused e recebe um único email. Guardar uma chave válida volta a pô-las em funcionamento automaticamente.

Como verificar que um pedido de Call my webhook é genuíno?

Verifique a assinatura antes de ler o resto. Cada pedido traz X-EC-Signature: t=<unix seconds>,v1=<HMAC-SHA256 em hexadecimal de "<t>.<corpo bruto>">, assinado com o Signing secret dessa automatização, que copia do passo no editor depois de guardar. 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 lhe diz duas coisas que merecem ação. dry_run é true quando o pedido vem de Try it, por isso ignore tudo o que seja irreversível, como criar uma encomenda. E run_id é único em cada execução, por isso guarde os que já tratou e recuse um pedido repetido. Responda em 20 segundos. {"reply": "..."} é enviado ao cliente tal como está escrito, por isso nunca passe texto do cliente sem o verificar.

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 reenvio e como são rodados?

Um número configurado como Through easyCoexistence pode reenviar as mensagens recebidas para o seu próprio sistema. Na primeira vez que guardar um Forward URL, é criado um segredo, mostrado uma vez, sob "Your signing secret, shown once. Copy it now:". Ele assina cada POST reenviado com o mesmo esquema X-EC-Signature. O botão New secret na página do número, ou chamar set_inbound_mode com rotate_secret a true, cria um substituto, de novo mostrado uma vez, e a partir daí assina tudo, incluindo as novas tentativas das entregas anteriores. Também pode escrever um segredo seu, com pelo menos 24 caracteres, que fica guardado e nunca mais é mostrado. Stop forwarding apaga o segredo, por isso guardar um URL mais tarde começa com um novo.

Rode o segredo depois de um colega com acesso sair, depois de um segredo ter parado num repositório, num ticket ou num registo, e quando mudar de alojamento. O segredo de Call my webhook pertence à automatização e só o proprietário da conta o vê. Quando o editor mostra New secret, sob um gatilho "Your system calls a URL", esse botão substitui-o e o antigo deixa de funcionar de imediato; numa automatização sem esse botão, crie a automatização de novo, aponte o seu recetor para o novo segredo e depois apague a automatização antiga.

Que endereços podem as automatizações chamar?

Apenas endereços HTTPS públicos. Um URL de Call my webhook ou de Forward URL que comece por http://, aponte para localhost, para uma rede privada, para um nome .internal ou .local, ou para um endereço de metadados da cloud é recusado ao guardar, e é verificado de novo depois do DNS antes de cada pedido. Assim, um nome público não pode mais tarde ser apontado para dentro de uma rede privada. Os redirecionamentos não são seguidos: um 301 ou 302 falha o passo, por isso guarde o endereço final.

Mantenha os segredos fora do próprio URL. list_automations devolve os passos de cada automatização, incluindo o URL do webhook, a qualquer assistente ligado à sua conta, por isso um token na string de consulta fica legível aí. Deixe que a assinatura faça essa prova.

Como manter o acesso no mínimo?

Dê a cada pessoa e a cada ferramenta apenas o acesso de que o seu trabalho precisa, e remova o que já não é usado. O lado do conector, com início de sessão, confirmações e ferramentas bloqueadas, está coberto na página sobre como ligar o WhatsApp a uma IA em segurança. Do lado das automatizações, estes hábitos são os mais importantes:

  • Peça get_api_credentials apenas num chat privado: o token de acesso do número fica então nessa transcrição.
  • Prefira Call my webhook ou um Forward URL a entregar o token a uma ferramenta de terceiros.
  • Apague as automatizações que desativou; isso também retira os respetivos segredos de assinatura.
  • Lembre-se de que os registos de execução guardam as mensagens e as respostas dos clientes durante 30 dias, e as Conversations mantêm as conversas durante o seu período de retenção (30, 90 ou 365 dias), ambos legíveis no painel e através do seu assistente ligado.
  • Num número configurado como Straight to your system, coloque um segredo longo e aleatório no caminho do URL de callback, uma vez que a assinatura da Meta não pode ser verificada aí.

Erros comuns

  • Verificar a assinatura sobre JSON que a sua framework voltou a serializar. Muitos parsers alteram espaçamento, escapes ou a ordem das chaves; calcule o HMAC sobre os bytes brutos do pedido sempre que a sua stack os expuser.
  • Executar efeitos secundários em chamadas de teste. Try it chama o seu webhook com dry_run a true; uma encomenda, um reembolso ou uma escrita no CRM feita nesse momento é real.
  • Colar uma chave de IA numa conversa com o seu assistente para poupar tempo. Nenhuma ferramenta a aceita, e ela fica na transcrição; use as chaves de IA no painel.
  • Verificar um reenvio com o segredo de Call my webhook, ou o inverso. São segredos separados: um por número para os reenvios, um por automatização para as chamadas de webhook.
Fazer isto com a EasyCoexistence

O seu número continua na Cloud API oficial da Meta através da Coexistence, monitorizado 24 horas por dia. De US$ 9 a US$ 0.75 por número por mês, descendo à medida que adiciona números, com os primeiros 3 dias grátis.

Perguntas frequentes

A equipa da easyCoexistence ou o suporte pode ver a minha chave de IA?

A chave nunca é apresentada depois de guardada: nem no painel, nem nos resultados MCP, nem nos factos que o assistente de suporte lê. É decifrada apenas pelo sistema, no momento em que chama o seu fornecedor para uma resposta de IA.

Quem pode ler os registos de execução das minhas automatizações?

Qualquer pessoa com sessão iniciada na sua conta easyCoexistence, incluindo as pessoas que convidou, no separador Runs, e qualquer assistente ligado à conta, através de list_automation_runs e get_automation_run. Os registos incluem a mensagem do cliente e a resposta, e são apagados ao fim de 30 dias.

Como remover uma chave de IA em segurança?

Desative primeiro as automatizações que a usam (Switch Off) e qualquer agente que funcione com ela, e depois selecione Remove em AI keys e revogue a chave no fornecedor. Removê-la enquanto as automatizações ainda a usam deixa-as em pausa na próxima resposta de IA e envia-lhe um email.

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

Envia apenas o texto de exemplo que escreveu, com dry_run a true e um histórico vazio. As execuções reais enviam a mensagem recebida e as mensagens recentes do chat, até 10, por isso trate o seu endpoint como um sistema que trata dados de clientes.

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