Zapi SendComo evitar mensagens duplicadas em campanhas
Entenda a diferença entre contato duplicado, evento repetido e resultado incerto, e desenhe uma recuperação que preserve o histórico.
Mensagens duplicadas podem nascer de dados repetidos, cliques simultâneos ou uma tentativa de recuperação mal planejada. Identificar a origem muda a solução: limpar a planilha não impede que um evento seja processado duas vezes.
Separe duplicação de cadastro e de execução
Um mesmo endereço pode aparecer em mais de um registro. Nesse caso, normalize e deduplique os dados antes de formar a audiência. Mas também confira a campanha: duas solicitações iguais não deveriam criar dois conjuntos independentes de envios.
Use uma referência estável para cada operação. Ela deve representar a mesma intenção em uma repetição, e não mudar a cada clique. Também precisa distinguir campanhas diferentes; reaproveitar a chave de outra operação pode esconder uma comunicação legítima.
Não confunda silêncio com recusa
Se o provedor não devolve uma resposta, a chamada pode ter chegado até ele. Reenviar imediatamente transforma uma falha de confirmação em risco de duplicidade. Registre o estado incerto e consulte a evidência disponível antes de tomar outra decisão.
Cenário ilustrativo: o sistema envia uma mensagem, perde a conexão e não consegue salvar a confirmação. Na retomada, ele encontra a tentativa registrada e mantém o resultado para revisão, em vez de assumir que nada aconteceu.
Preserve o histórico durante a recuperação
A fila, a campanha e o registro do envio precisam concordar sobre a mesma operação. Recriar tudo com identificadores novos pode fazer os mecanismos de deduplicação perderem a referência do que já foi aceito.
Também teste efeitos parciais. Se uma sequência concluiu a primeira ação e falhou na segunda, repetir o conjunto pode refazer a primeira. A recuperação deve respeitar os resultados já registrados ou parar para revisão quando não houver prova suficiente.
Teste os casos que provocam repetição
- Dois cliques rápidos na mesma ação de envio.
- Recebimento duplicado do mesmo evento.
- Queda depois da chamada ao provedor e antes da confirmação local.
- Retomada após uma ação parcialmente concluída.
- Cancelamento enquanto a execução está sendo admitida.
Nenhum teste local comprova entrega exatamente uma vez em todos os provedores. O objetivo operacional é tornar tentativas e incertezas visíveis e impedir repetição cega. Uma equipe com histórico claro consegue recuperar uma campanha com menos improvisação.
Perguntas frequentes
Deduplificar contatos elimina todos os envios duplicados?
Não. Eventos, solicitações e retomadas também podem duplicar a execução.
É seguro reenviar quando houve timeout?
Não automaticamente. A chamada pode ter sido aceita; confira o ledger e os sinais do provedor antes de decidir.
Fontes e referências
Exemplos são ilustrativos. As regras e capacidades dos canais podem mudar; confira as fontes e teste a operação antes de publicar.