Ir para o conteúdo
↗ COEX.

Webhooks

Verify token, Access Token e assinatura de webhook: diferenças

Conteúdo editorial da DropFlow · Atualizado em

O verify token participa da verificação configurada para o endpoint. O Access Token autoriza chamadas de API. O segredo usado para validar a assinatura das notificações depende do emissor e do contrato da integração. Esses elementos não são equivalentes e não devem ser reunidos em um único campo genérico chamado token.

Roteiro de verificação

  • Identifique quem entrega o evento: a própria Meta ou um serviço intermediário que encaminha notificações. O método de validação precisa corresponder a esse emissor.
  • Na integração direta com a Meta, siga a documentação de assinatura e preserve o corpo recebido conforme o método de verificação exigir. Não valide uma versão alterada do payload por conveniência.
  • Em encaminhamento intermediário, consulte o contrato de autenticação desse serviço. Não presuma que a assinatura original continuará válida se o corpo for transformado.
  • Mantenha os segredos em configuração restrita no servidor e documente os nomes dos campos, sem seus valores, para a equipe responsável.

Exemplo para orientar o teste

Um cliente que recebe eventos de um encaminhador precisa validar o mecanismo documentado por esse encaminhador. O App Secret de um aplicativo compartilhado não deve ser distribuído como se fosse uma credencial exclusiva de cada número.

Cuidados e limites

Não publique App Secret nem desative a autenticação do receptor para resolver um teste. Um verify token conhecido não comprova a origem de todas as notificações posteriores.

Como conferir o resultado

Teste uma notificação válida e uma requisição com autenticação inválida. O receptor deve aceitar somente a origem autenticada pelo contrato aplicável.

Fontes e condições

As condições da Meta podem mudar. Consulte as referências oficiais e os termos antes de executar alterações no seu número.

Preferências de cookies

Necessários: autenticação, segurança e registro da sua escolha. Sempre ativos.

O GTM compartilhado contém tags das duas categorias e será carregado somente se ambas forem autorizadas. Eventos da Meta no servidor dependem da opção de publicidade.

Você pode alterar ou retirar sua escolha aqui a qualquer momento. Sem consentimento, não enviamos novos eventos de publicidade.