# Webhooks em campanhas: eventos, segurança e duplicidade

> Planeje integrações por webhook com autenticação, validação, rastreabilidade, deduplicação e recuperação de resultados incertos.

Autoria: Zapi Send. Publicado: 2026-09-30T12:00:00-03:00. Atualizado: 2026-09-30T12:00:00-03:00.

Página original: https://send.zapi.ninja/blog/webhook-integracoes

Um webhook avisa que algo aconteceu em outro sistema. Para transformar esse aviso em uma campanha ou automação, é preciso validar origem, interpretar o evento e controlar repetições. Receber uma chamada HTTP não comprova que uma mensagem foi entregue ao cliente.

## Defina o contrato do evento

Especifique nome, identificador, horário, campos obrigatórios e significado do evento. “Pedido atualizado” é amplo demais se o fluxo depende de “pagamento confirmado”. Campos opcionais precisam de um comportamento previsto quando não chegam.

Mantenha exemplos de teste separados dos eventos reais. Uma integração que aceita qualquer texto pode disparar uma ação com dados incompletos. Valide a estrutura antes de agendar trabalhos e preserve uma referência para acompanhar o resultado.

## Confirme a origem e limite o acesso

Use o mecanismo de autenticação oferecido pelo emissor, como assinatura verificada ou credencial própria da integração. Não publique segredos em URLs de artigos, planilhas compartilhadas ou capturas de tela. Permissões devem corresponder apenas ao processo necessário.

> Cenário ilustrativo: o sistema de pedidos envia a confirmação com um identificador estável. A integração verifica a assinatura, registra a entrada e associa o evento ao pedido. Uma repetição com o mesmo identificador não cria uma nova intenção de comunicação.

## Trate repetição e ordem dos eventos

Provedores podem repetir entregas, e eventos podem chegar fora de ordem. Defina uma chave de deduplicação e uma regra para conferir o estado atual da entidade. Um aviso antigo de carrinho não deve reabrir uma recuperação depois da compra confirmada.

Separe receber de executar. A confirmação HTTP informa o que foi aceito pela integração; o resultado da ação externa exige outro registro. Se a resposta do provedor se perdeu, marque a incerteza e investigue antes de reenviar.

## Teste antes de conectar o público real

- Assinatura ou credencial inválida é rejeitada?
- Campos ausentes impedem uma execução incorreta?
- O mesmo evento repetido mantém uma única intenção?
- Um evento antigo respeita o estado mais recente?
- Falhas podem ser investigadas sem expor dados pessoais nos logs?

Documente quem mantém o contrato e como mudanças serão publicadas. Se um campo muda de significado, ajuste e teste as duas pontas. Uma integração confiável oferece evidência para explicar cada execução, inclusive quando ela não terminou.

## Perguntas frequentes

### Webhook e consulta periódica são a mesma coisa?

Não. O webhook recebe avisos do emissor; uma consulta periódica busca o estado em intervalos definidos.

### Responder 200 significa que o cliente recebeu?

Não. Essa resposta pode confirmar a entrada do evento; a entrega depende da execução e dos sinais do canal.

## Fontes e referências

- [Como o Zapi Send organiza a comunicação](https://send.zapi.ninja/#produto)

## Continue a leitura

- [Como evitar mensagens duplicadas em campanhas](https://send.zapi.ninja/blog/campanhas-sem-duplicidade/index.md)

- [Recuperação de carrinho abandonado no WhatsApp: fluxo e mensagens](https://send.zapi.ninja/blog/recuperacao-carrinho-whatsapp/index.md)

- [Métricas de campanhas: diferencie envio, entrega e conversão](https://send.zapi.ninja/blog/metricas-campanhas/index.md)