Ir para o conteúdo
↗ COEX.

Webhooks

Mensagens duplicadas no webhook: como planejar idempotência

Conteúdo editorial da DropFlow · Atualizado em

Um receptor precisa lidar com a possibilidade de mais de uma entrega relacionada à mesma mensagem ou evento. Isso não deve gerar automaticamente outra mensagem na conversa nem uma segunda resposta do robô. A idempotência é a regra que permite reconhecer o que já foi processado e repetir a entrega sem repetir seus efeitos.

Roteiro de verificação

  • Registre o identificador da mensagem, o tipo de evento e o número ou conta de destino. Não deduplique somente pelo texto: clientes podem enviar duas mensagens iguais de forma legítima.
  • Defina uma chave de processamento que respeite o tipo de operação. Uma atualização de status não deve ser descartada apenas porque usa o ID de uma mensagem já registrada.
  • Grave o controle de processamento de forma consistente com o efeito no sistema. A verificação isolada em memória pode falhar quando há vários processos ou reinicialização.
  • Teste duas entregas do mesmo evento e duas mensagens diferentes com conteúdo igual. Os resultados esperados são distintos e precisam estar cobertos.

Exemplo para orientar o teste

Receber duas vezes a notificação de uma mesma mensagem deve manter uma entrada na conversa. Receber dois IDs diferentes com o texto Olá representa duas mensagens e não pode ser eliminado pela comparação de conteúdo.

Cuidados e limites

Não desative novas tentativas de entrega sem avaliar sua função de recuperação. A solução deve tolerar repetição e falhas, preservando as mensagens legítimas.

Como conferir o resultado

No teste repetido, confirme uma gravação e uma execução dos efeitos associados, mantendo registro suficiente para explicar a reentrega sem expor dados do cliente.

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.