[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"content:article:enviar-mensagem-whatsapp-api":3},{"data":4},{"id":5,"type":6,"slug":7,"path":8,"url":9,"title":10,"meta_title":11,"meta_description":12,"tldr":13,"html":19,"toc":20,"reading_minutes":101,"faqs":102,"sources":118,"keywords":144,"cluster":153,"canonical_url":9,"robots":154,"published_at":155,"updated_at":155,"author":156,"reviewer":163,"cover":164,"related":171,"json_ld":240},"8b1cfe11-1f7a-479a-a28a-6e196f2f3018","article","enviar-mensagem-whatsapp-api","\u002Fblog\u002Fenviar-mensagem-whatsapp-api","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fenviar-mensagem-whatsapp-api","Enviar mensagem WhatsApp API sem duplicar: guia prático","Enviar mensagem WhatsApp API sem duplicar | FlowZap","Enviar mensagem WhatsApp API sem duplicar: entenda por que timeouts e retries repetem envios e veja como usar chave de idempotência e fila.",[14,15,16,17,18],"Duplicidade nasce quando o timeout esconde uma resposta de sucesso e a aplicação reenvia às cegas.","Grave o estado no seu banco antes de chamar a API e use uma chave ligada ao evento de negócio.","Depois de um timeout, consulte o estado da mensagem antes de tentar de novo, com espera crescente.","Responda o webhook rápido, processe depois e trate cada evento como possível repetição.","No FlowZap, o envio sem duplicidade e a fila com intervalo entre envios ajudam a evitar repetição e rajadas.","\u003Cp>Para enviar mensagem WhatsApp API sem duplicar, não repita a chamada às cegas quando houver timeout. Grave o envio no seu banco antes, use uma chave ligada ao evento de negócio e consulte o estado da mensagem antes de qualquer nova tentativa. Neste guia você vê por que a duplicidade acontece, como evitá-la no código e onde o FlowZap ajuda.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Principais pontos\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>O timeout não prova que a mensagem falhou: ela pode ter sido aceita e só a resposta se perdeu.\u003C\u002Fli>\n\u003Cli>A chave de idempotência deve vir do negócio (ex.: cobrança 1049), não de um UUID novo a cada tentativa.\u003C\u002Fli>\n\u003Cli>Grave o estado do envio antes da chamada HTTP e reconcilie antes de reenviar, com espera crescente.\u003C\u002Fli>\n\u003Cli>Webhooks também repetem: responda rápido, processe depois e ignore eventos já vistos.\u003C\u002Fli>\n\u003Cli>Fila com intervalo entre envios evita rajadas, e os estados na fila, enviada, entregue e lida mostram onde cada mensagem está.\u003C\u002Fli>\n\u003Cli>Repetir mensagem para a mesma pessoa tem custo de relação e de LGPD; só envie a quem autorizou.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"por-que-a-mensagem-duplica-ao-enviar-mensagem-whatsapp-api\">Por que a mensagem duplica ao enviar mensagem WhatsApp API\u003C\u002Fh2>\n\u003Cp>Enviar mensagem WhatsApp API parece simples: um POST, uma resposta 200, pronto. O problema aparece quando a resposta não chega.\u003C\u002Fp>\n\u003Cp>Imagine uma cobrança de R$ 120 disparada para um cliente. A API aceita o pedido e despacha a mensagem, mas a conexão cai antes de o HTTP 200 voltar ao seu servidor. Seu código lê isso como falha, tenta de novo e o cliente recebe a mesma cobrança duas vezes. Quem atende a reclamação depois sabe como isso soa: parece descuido, mas na verdade é um bug de arquitetura.\u003C\u002Fp>\n\u003Cp>A \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Freference\u002Fwhatsapp-business-phone-number\u002Fmessage-api\" rel=\"noopener noreferrer\" target=\"_blank\">referência de envio da Meta\u003C\u002Fa> mostra o que o pedido retorna quando dá certo. O que fazer quando ele não retorna é responsabilidade sua. Relatos de quem integrou a Cloud API, como \u003Ca href=\"https:\u002F\u002Fwww.tabnews.com.br\u002FRelayOS\u002Fcomo-construimos-a-integracao-com-a-whatsapp-cloud-api-oficial-da-meta-o-que-aprendemos\" rel=\"noopener noreferrer\" target=\"_blank\">este da equipe RelayOS\u003C\u002Fa>, tratam falha de rede e de resposta como parte normal do trabalho.\u003C\u002Fp>\n\u003Ch3 id=\"o-timeout-que-esconde-uma-resposta-de-sucesso\">O timeout que esconde uma resposta de sucesso\u003C\u002Fh3>\n\u003Cp>Timeout de leitura significa apenas que sua aplicação desistiu de esperar. Não significa que a mensagem não saiu. A API pode ter processado tudo e só a confirmação se perdeu no caminho. Por isso, deu timeout não é o mesmo que falhou.\u003C\u002Fp>\n\u003Ch3 id=\"retry-cego-na-aplicacao\">Retry cego na aplicação\u003C\u002Fh3>\n\u003Cp>É o clássico bloco que captura qualquer exceção e chama a função de envio de novo. Sem checar o que aconteceu antes, cada tentativa pode virar uma mensagem nova.\u003C\u002Fp>\n\u003Cp>O mesmo vale para filas de tarefas configuradas para reexecutar jobs que não terminaram dentro do prazo. O job estourou o tempo, mas a mensagem já tinha saído.\u003C\u002Fp>\n\u003Ch3 id=\"duas-instancias-disparando-o-mesmo-job\">Duas instâncias disparando o mesmo job\u003C\u002Fh3>\n\u003Cp>Se você tem mais de um worker lendo a tabela de envios pendentes, dois deles podem pegar o mesmo registro quase ao mesmo tempo. Cada um faz sua chamada e o cliente recebe duas mensagens, sem que nenhum worker tenha errado sozinho.\u003C\u002Fp>\n\u003Cp>Essa concorrência é um dos motivos para travar o registro antes da chamada, como você verá adiante.\u003C\u002Fp>\n\u003Ch2 id=\"api-do-whatsapp-como-funciona-e-onde-a-duplicidade-escapa\">API do WhatsApp: como funciona e onde a duplicidade escapa\u003C\u002Fh2>\n\u003Cp>Se você chegou aqui pesquisando como a API do WhatsApp funciona, o resumo é este: você faz um pedido REST com destinatário e conteúdo, a mensagem entra no fluxo de envio e a confirmação de cada etapa chega depois, por estados e webhooks. O pedido e a confirmação são momentos diferentes.\u003C\u002Fp>\n\u003Ch3 id=\"do-pedido-de-envio-a-confirmacao\">Do pedido de envio à confirmação\u003C\u002Fh3>\n\u003Cp>O caminho típico tem três passos:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Pedido:\u003C\u002Fstrong> seu sistema chama a API com o telefone e o conteúdo.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Aceite:\u003C\u002Fstrong> a plataforma responde que recebeu o pedido.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Acompanhamento:\u003C\u002Fstrong> novos eventos informam se a mensagem foi enviada, entregue e lida.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>O ponto frágil é o intervalo entre o pedido e o aceite chegar até você. É nesse espaço que o timeout aparece e que o reenvio às cegas acontece.\u003C\u002Fp>\n\u003Ch3 id=\"o-que-a-api-garante-e-o-que-fica-com-voce\">O que a API garante e o que fica com você\u003C\u002Fh3>\n\u003Cp>Não parta do princípio de que a API deduplica sozinha. Cada provedor tem as suas regras: alguns aceitam uma chave de idempotência, outros não oferecem nada parecido. Confira sempre a documentação de envio da Meta e a do provedor que você usa. Se a regra não estiver clara, assuma que a proteção é sua.\u003C\u002Fp>\n\u003Cp>Se a dúvida for sobre custo, veja \u003Ca href=\"\u002Fblog\u002Fapi-do-whatsapp-e-paga\">API do WhatsApp é paga? O que muda em outubro de 2026\u003C\u002Fa>. Para a API do FlowZap, o caminho é a \u003Ca href=\"\u002Fdocs\">documentação\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"idempotencia-na-pratica-chave-estado-e-reconciliacao\">Idempotência na prática: chave, estado e reconciliação\u003C\u002Fh2>\n\u003Cp>Idempotência é a propriedade de repetir um pedido sem repetir o efeito. Para quem busca idempotência em API de WhatsApp, a ideia se resume a três hábitos: chave estável, estado gravado antes e consulta antes de reenviar. Esse é o raciocínio de materiais sobre \u003Ca href=\"https:\u002F\u002Fleadnotifi.com\u002Farticles\u002Fwhatsapp-idempotent-sends-monitoring-alerting-stack\" rel=\"noopener noreferrer\" target=\"_blank\">envios idempotentes e monitoramento\u003C\u002Fa> e sobre \u003Ca href=\"https:\u002F\u002Fwhabuzz.com\u002Fblog\u002Fwhatsapp-api-idempotency\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">idempotência em APIs de WhatsApp\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"chave-ligada-ao-evento-de-negocio-nao-uuid-aleatorio\">Chave ligada ao evento de negócio, não UUID aleatório\u003C\u002Fh3>\n\u003Cp>A chave deve responder à pergunta: que fato do negócio gerou esta mensagem? Exemplos:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode>cobranca-1049-lembrete\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>hash de \u003Ccode>id do destinatário + id do evento\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Um UUID novo a cada tentativa é o erro mais comum. Cada retry parece um pedido inédito, então nada impede a repetição. A chave só funciona se for a mesma em todas as tentativas daquele envio.\u003C\u002Fp>\n\u003Cp>Algumas implementações e proxies de envio tratam pedidos repetidos com o mesmo conteúdo, dentro de uma janela de tempo, devolvendo o mesmo identificador sem despachar outra mensagem. Isso é característica dessas implementações, não uma regra que você possa presumir em qualquer API. Verifique no seu caso.\u003C\u002Fp>\n\u003Ch3 id=\"trave-o-estado-antes-da-chamada-http\">Trave o estado antes da chamada HTTP\u003C\u002Fh3>\n\u003Cp>Antes de falar com a API, grave no seu banco um registro com a chave e o estado processando. Se outro worker tentar o mesmo envio, a chave única ou um lock transacional o barra. Pode ser \u003Ccode>SKIP LOCKED\u003C\u002Fcode> no PostgreSQL ou um lock em Redis.\u003C\u002Fp>\n\u003Cp>Um esqueleto de pseudo-código:\u003C\u002Fp>\n\u003Cpre>\u003Ccode>envio = gravar(chave, estado='processando')  # falha se a chave já existe\nse envio já existia: parar\nresposta = chamar_api(destino, conteudo)\nse resposta ok: gravar(estado='aceita', id_da_mensagem)\nse timeout: gravar(estado='incerto') e agendar reconciliação\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"depois-do-timeout-consulte-espere-so-entao-tente-de-novo\">Depois do timeout: consulte, espere, só então tente de novo\u003C\u002Fh3>\n\u003Cp>O estado incerto é honesto: você não sabe se a mensagem saiu. A reconciliação olha o que já se sabe antes de agir:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Existe um identificador de mensagem gravado?\u003C\u002Fli>\n\u003Cli>Chegou algum webhook de envio ou entrega para essa chave?\u003C\u002Fli>\n\u003Cli>Algum estado da mensagem já passou de na fila?\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Só se nada indicar que a mensagem saiu você libera nova tentativa. Use espera crescente (1 min, 2 min, 4 min, por exemplo) e um limite de tentativas.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Situação\u003C\u002Fth>\n\u003Cth>Ação recomendada\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Sucesso (resposta 2xx com identificador)\u003C\u002Ftd>\n\u003Ctd>Gravar o identificador e marcar como aceita. Não repetir.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Erro 4xx (pedido inválido, número com problema)\u003C\u002Ftd>\n\u003Ctd>Não repetir igual. Corrigir o dado ou registrar a falha.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Erro 5xx (falha do lado da API)\u003C\u002Ftd>\n\u003Ctd>Reconciliar e tentar de novo com espera crescente e limite.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Timeout (sem resposta)\u003C\u002Ftd>\n\u003Ctd>Marcar como incerto, consultar estado e webhooks, só então reenviar.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>Se aparecer erro de limite de taxa (como o 429), reduza o ritmo em vez de insistir. Mais adiante você vê como a fila ajuda nisso.\u003C\u002Fp>\n\u003Ch2 id=\"retry-de-webhook-como-nao-processar-o-mesmo-evento-duas-vezes\">Retry de webhook: como não processar o mesmo evento duas vezes\u003C\u002Fh2>\n\u003Cp>A duplicidade não acontece só na saída. No recebimento, quem envia o evento espera uma resposta rápida. Se o seu endpoint demora porque faz muita coisa antes de responder, a conexão estoura o tempo, o remetente tenta de novo e sua lógica roda duas vezes.\u003C\u002Fp>\n\u003Cp>Discussões como \u003Ca href=\"https:\u002F\u002Fstackoverflow.com\u002Fquestions\u002F72894209\u002Fwhatsapp-cloud-api-sending-old-message-inbound-notification-multiple-time-on-my\" rel=\"noopener noreferrer\" target=\"_blank\">esta no Stack Overflow\u003C\u002Fa> e \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fcommunity\u002Fthreads\u002F435282849333929\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">esta na comunidade da Meta\u003C\u002Fa> mostram desenvolvedores lidando com notificações que chegam mais de uma vez. Quem pesquisa retry de webhook do WhatsApp costuma estar nessa situação.\u003C\u002Fp>\n\u003Ch3 id=\"responda-rapido-processe-depois\">Responda rápido, processe depois\u003C\u002Fh3>\n\u003Cp>A receita é simples:\u003C\u002Fp>\n\u003Col>\n\u003Cli>Valide a assinatura, se houver.\u003C\u002Fli>\n\u003Cli>Devolva 200 imediatamente.\u003C\u002Fli>\n\u003Cli>Coloque o evento numa fila interna.\u003C\u002Fli>\n\u003Cli>Processe com calma em outro worker.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Assim, o tempo de resposta deixa de depender da sua regra de negócio, seja atualizar um CRM, mandar um e-mail ou gerar uma nota.\u003C\u002Fp>\n\u003Ch3 id=\"guarde-o-id-do-evento-e-ignore-repetidos\">Guarde o ID do evento e ignore repetidos\u003C\u002Fh3>\n\u003Cp>Trate todo evento como possivelmente repetido. Ao receber, tente registrar o ID do evento numa tabela com chave única ou numa chave Redis com validade. Se já existir, descarte. Este \u003Ca href=\"https:\u002F\u002Fmedium.com\u002F@nkangprecious26\u002Fhandling-duplicate-webhooks-in-whatsapp-api-using-redis-d7d117731f95\" rel=\"noopener noreferrer\" target=\"_blank\">passo a passo com Redis\u003C\u002Fa> mostra a ideia aplicada.\u003C\u002Fp>\n\u003Cp>Se você monta o recebimento no n8n, veja \u003Ca href=\"\u002Fblog\u002Fwebhook-whatsapp-n8n\">Webhook WhatsApp no n8n: passo a passo\u003C\u002Fa>. Os webhooks do FlowZap são assinados e têm novas tentativas. Por isso, o seu lado precisa estar preparado para receber o mesmo evento mais de uma vez. Os detalhes estão em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"fila-de-mensagens-whatsapp-estados-na-fila-enviada-entregue-e-lida\">Fila de mensagens WhatsApp: estados na fila, enviada, entregue e lida\u003C\u002Fh2>\n\u003Cp>Aqui o foco é usar o estado como decisão de código, não explicar cada ícone. Cada mensagem passa por uma sequência: na fila, enviada, entregue e, se a pessoa abrir, lida. Quem acompanha essa sequência sabe onde a mensagem está e não precisa adivinhar.\u003C\u002Fp>\n\u003Ch3 id=\"estados-como-trava-contra-reenvio\">Estados como trava contra reenvio\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Estado\u003C\u002Fth>\n\u003Cth>O que significa\u003C\u002Fth>\n\u003Cth>O que fazer no código\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Na fila\u003C\u002Ftd>\n\u003Ctd>Pedido registrado, ainda não saiu\u003C\u002Ftd>\n\u003Ctd>Não crie outro pedido para o mesmo evento.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Enviada\u003C\u002Ftd>\n\u003Ctd>Aceita para envio\u003C\u002Ftd>\n\u003Ctd>Não reenvie.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Entregue\u003C\u002Ftd>\n\u003Ctd>Chegou ao aparelho da pessoa\u003C\u002Ftd>\n\u003Ctd>Encerrar o envio como concluído.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Lida\u003C\u002Ftd>\n\u003Ctd>A pessoa abriu a conversa\u003C\u002Ftd>\n\u003Ctd>Opcional: use para follow-up, nunca para reenviar.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>A regra prática: se o estado já passou de na fila, um novo envio do mesmo evento é duplicidade. O webhook de status é a sua fonte para saber disso sem depender da resposta HTTP que pode ter se perdido.\u003C\u002Fp>\n\u003Ch3 id=\"quando-reenviar-e-quando-esperar\">Quando reenviar e quando esperar\u003C\u002Fh3>\n\u003Cp>Se a mensagem ficou na fila por muito tempo, o problema está na fila, não no destinatário. Investigue antes de criar outro pedido.\u003C\u002Fp>\n\u003Cp>Se ficou enviada e não virou entregue, o aparelho pode estar desligado ou sem internet, e isso costuma se resolver sozinho. Reenviar só faz sentido quando a falha está registrada e a causa foi corrigida.\u003C\u002Fp>\n\u003Cp>No FlowZap, você acompanha esses quatro estados em cada mensagem, no console. Para receber os eventos no seu sistema, veja a \u003Ca href=\"\u002Fdocs\">documentação\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"envio-sem-duplicidade-e-fila-com-intervalo-no-flowzap\">Envio sem duplicidade e fila com intervalo no FlowZap\u003C\u002Fh2>\n\u003Cp>Construir tudo isso do zero dá trabalho. Quando faz sentido, o FlowZap resolve parte do problema na plataforma, e o que está descrito abaixo é o que o produto oferece hoje.\u003C\u002Fp>\n\u003Ch3 id=\"texto-com-envio-sem-duplicidade\">Texto com envio sem duplicidade\u003C\u002Fh3>\n\u003Cp>O envio de mensagens de texto no FlowZap tem proteção contra duplicidade. Na prática, se o seu sistema repetir o mesmo pedido por causa de um timeout, a mensagem não sai de novo para o cliente.\u003C\u002Fp>\n\u003Cp>A \u003Ca href=\"\u002Fdocs\">documentação\u003C\u002Fa> explica como identificar o pedido na chamada. Use sempre o mesmo identificador em todas as tentativas do mesmo envio e confira lá os detalhes antes de implementar.\u003C\u002Fp>\n\u003Cp>Isso não dispensa o seu controle. Continue gravando o estado antes e reconciliando depois. A proteção da plataforma é uma segunda camada, não um motivo para tirar a primeira.\u003C\u002Fp>\n\u003Ch3 id=\"fila-com-intervalo-entre-envios\">Fila com intervalo entre envios\u003C\u002Fh3>\n\u003Cp>Mandar dezenas de mensagens ao mesmo tempo causa dois problemas. O primeiro é a rajada, que pode estourar limites de taxa. O segundo é a concorrência na gravação, que favorece repetição quando várias instâncias agem juntas.\u003C\u002Fp>\n\u003Cp>No FlowZap, as mensagens entram numa fila com intervalo entre envios e saem em ritmo controlado. Você acompanha cada uma pelos estados na fila, enviada, entregue e lida. Para avisos em lote ao seu público autorizado, isso dá previsibilidade e facilita a reconciliação.\u003C\u002Fp>\n\u003Ch3 id=\"quando-usar-modelos-com-variaveis\">Quando usar modelos com variáveis\u003C\u002Fh3>\n\u003Cp>Para avisos, cobranças e lembretes, os modelos de mensagem com variáveis (nome, valor, data) evitam montar o texto no código. Eles são enviados para uma pessoa por vez, na hora ou agendados, pelo console ou pela API.\u003C\u002Fp>\n\u003Cp>Isso encaixa bem com a chave de negócio: um lembrete por cobrança, um envio por chave. Se quiser ver tudo o que a plataforma faz, vá a \u003Ca href=\"\u002Fproduto\">\u002Fproduto\u003C\u002Fa>. Para ideias de uso com cobrança e atendimento, veja os \u003Ca href=\"\u002Fcasos-de-uso\">casos de uso\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"duplicidade-lgpd-e-boa-relacao-com-o-cliente\">Duplicidade, LGPD e boa relação com o cliente\u003C\u002Fh2>\n\u003Cp>Mensagem repetida incomoda o cliente e tem um lado legal. Dá para tratar isso com calma, sem alarmismo.\u003C\u002Fp>\n\u003Ch3 id=\"telefone-e-conversas-sao-dados-pessoais\">Telefone e conversas são dados pessoais\u003C\u002Fh3>\n\u003Cp>Pela LGPD (Lei nº 13.709\u002F2018, art. 5º, I), número de telefone e registros de conversa são dados pessoais. Falhas técnicas que repetem contato pesam contra os princípios de segurança e de prevenção (art. 6º, VII e VIII): quem trata dados deve adotar medidas para evitar danos.\u003C\u002Fp>\n\u003Cp>A ANPD publica materiais orientativos, como as notas técnicas \u003Ca href=\"https:\u002F\u002Fwww.gov.br\u002Fanpd\u002Fpt-br\u002Fcentrais-de-conteudo\u002Fdocumentos-tecnicos-orientativos\u002Fversao_publica_sei_4161316_nota_tecnica_19.pdf\u002F@@display-file\u002Ffile\" rel=\"noopener noreferrer\" target=\"_blank\">19\u003C\u002Fa> e \u003Ca href=\"http:\u002F\u002Fwww.gov.br\u002Fanpd\u002Fpt-br\u002Fcentrais-de-conteudo\u002Fdocumentos-tecnicos-orientativos\u002Fsei_0227507_nota_tecnica__pub__no_58_2025_fis_cgf_anpd.pdf\u002F@@display-file\u002Ffile\" rel=\"noopener noreferrer\" target=\"_blank\">58\u002F2025\u003C\u002Fa>. Vale ler com o seu jurídico, que sabe como elas se aplicam ao seu caso.\u003C\u002Fp>\n\u003Ch3 id=\"so-envie-a-quem-autorizou\">Só envie a quem autorizou\u003C\u002Fh3>\n\u003Cp>Deduplicar não é licença para disparar. Mensagens só devem ir para quem autorizou receber, com o consentimento registrado. Não compre listas, não use números descartáveis e não tente contornar bloqueios. Uma mensagem a mais para quem não pediu contato é pior que duas para quem pediu.\u003C\u002Fp>\n\u003Ch3 id=\"checklist-final\">Checklist final\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>A chave de idempotência vem do evento de negócio, não de um UUID novo.\u003C\u002Fli>\n\u003Cli>O estado do envio é gravado antes da chamada HTTP.\u003C\u002Fli>\n\u003Cli>Timeout vira incerto, não falhou.\u003C\u002Fli>\n\u003Cli>Antes de reenviar, você consulta identificador, estado e webhooks.\u003C\u002Fli>\n\u003Cli>O webhook responde rápido e ignora IDs de evento já vistos.\u003C\u002Fli>\n\u003Cli>O destinatário autorizou receber a mensagem.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Para os detalhes de API e webhooks do FlowZap, consulte \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>. Se tiver dúvidas sobre o seu caso, fale pelo \u003Ca href=\"\u002Fcontato\">\u002Fcontato\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"comece-com-o-flowzap\">Comece com o FlowZap\u003C\u002Fh2>\n\u003Cp>Veja \u003Ca href=\"\u002Fproduto\">o que o FlowZap faz\u003C\u002Fa> e \u003Ca href=\"\u002Fprecos\">compare os planos\u003C\u002Fa>. Para criar a conta, basta o nome da empresa, um e-mail e uma senha: o cadastro não pede cartão de crédito, e o pagamento é por Pix ou cartão de crédito, sem fidelidade.\u003C\u002Fp>\n",[21,25,29,32,35,38,41,44,47,50,53,56,59,62,65,68,71,74,77,80,83,86,89,92,95,98],{"id":22,"text":23,"level":24},"por-que-a-mensagem-duplica-ao-enviar-mensagem-whatsapp-api","Por que a mensagem duplica ao enviar mensagem WhatsApp API",2,{"id":26,"text":27,"level":28},"o-timeout-que-esconde-uma-resposta-de-sucesso","O timeout que esconde uma resposta de sucesso",3,{"id":30,"text":31,"level":28},"retry-cego-na-aplicacao","Retry cego na aplicação",{"id":33,"text":34,"level":28},"duas-instancias-disparando-o-mesmo-job","Duas instâncias disparando o mesmo job",{"id":36,"text":37,"level":24},"api-do-whatsapp-como-funciona-e-onde-a-duplicidade-escapa","API do WhatsApp: como funciona e onde a duplicidade escapa",{"id":39,"text":40,"level":28},"do-pedido-de-envio-a-confirmacao","Do pedido de envio à confirmação",{"id":42,"text":43,"level":28},"o-que-a-api-garante-e-o-que-fica-com-voce","O que a API garante e o que fica com você",{"id":45,"text":46,"level":24},"idempotencia-na-pratica-chave-estado-e-reconciliacao","Idempotência na prática: chave, estado e reconciliação",{"id":48,"text":49,"level":28},"chave-ligada-ao-evento-de-negocio-nao-uuid-aleatorio","Chave ligada ao evento de negócio, não UUID aleatório",{"id":51,"text":52,"level":28},"trave-o-estado-antes-da-chamada-http","Trave o estado antes da chamada HTTP",{"id":54,"text":55,"level":28},"depois-do-timeout-consulte-espere-so-entao-tente-de-novo","Depois do timeout: consulte, espere, só então tente de novo",{"id":57,"text":58,"level":24},"retry-de-webhook-como-nao-processar-o-mesmo-evento-duas-vezes","Retry de webhook: como não processar o mesmo evento duas vezes",{"id":60,"text":61,"level":28},"responda-rapido-processe-depois","Responda rápido, processe depois",{"id":63,"text":64,"level":28},"guarde-o-id-do-evento-e-ignore-repetidos","Guarde o ID do evento e ignore repetidos",{"id":66,"text":67,"level":24},"fila-de-mensagens-whatsapp-estados-na-fila-enviada-entregue-e-lida","Fila de mensagens WhatsApp: estados na fila, enviada, entregue e lida",{"id":69,"text":70,"level":28},"estados-como-trava-contra-reenvio","Estados como trava contra reenvio",{"id":72,"text":73,"level":28},"quando-reenviar-e-quando-esperar","Quando reenviar e quando esperar",{"id":75,"text":76,"level":24},"envio-sem-duplicidade-e-fila-com-intervalo-no-flowzap","Envio sem duplicidade e fila com intervalo no FlowZap",{"id":78,"text":79,"level":28},"texto-com-envio-sem-duplicidade","Texto com envio sem duplicidade",{"id":81,"text":82,"level":28},"fila-com-intervalo-entre-envios","Fila com intervalo entre envios",{"id":84,"text":85,"level":28},"quando-usar-modelos-com-variaveis","Quando usar modelos com variáveis",{"id":87,"text":88,"level":24},"duplicidade-lgpd-e-boa-relacao-com-o-cliente","Duplicidade, LGPD e boa relação com o cliente",{"id":90,"text":91,"level":28},"telefone-e-conversas-sao-dados-pessoais","Telefone e conversas são dados pessoais",{"id":93,"text":94,"level":28},"so-envie-a-quem-autorizou","Só envie a quem autorizou",{"id":96,"text":97,"level":28},"checklist-final","Checklist final",{"id":99,"text":100,"level":24},"comece-com-o-flowzap","Comece com o FlowZap",12,[103,106,109,112,115],{"a":104,"q":105},"Geralmente por timeout ou erro de rede que esconde a resposta de sucesso. A mensagem já saiu, mas o código assume falha e reenvia. Também ocorre quando dois workers pegam o mesmo registro pendente ao mesmo tempo.","Por que a mensagem duplica ao enviar pela API do WhatsApp?",{"a":107,"q":108},"Grave o envio no banco antes de chamar a API, use uma chave ligada ao evento de negócio (como cobranca-1049-lembrete) e, após um timeout, consulte o estado da mensagem antes de tentar de novo, com espera crescente entre as tentativas.","Como evitar envio duplicado no WhatsApp?",{"a":110,"q":111},"É repetir o mesmo pedido sem repetir o efeito. Na prática, você manda a mesma chave em todas as tentativas de um envio, e quem recebe reconhece o repetido. Nem todo provedor oferece isso, então confira a documentação e proteja também no seu lado.","O que é idempotência numa API de WhatsApp?",{"a":113,"q":114},"Sim, trate todo evento como possivelmente repetido. Responda 200 logo, coloque o evento numa fila interna e guarde o ID do evento numa tabela com chave única ou no Redis. Se o ID já existir, descarte o evento.","O webhook do WhatsApp pode chegar repetido?",{"a":116,"q":117},"A fila com intervalo entre envios evita rajadas e reduz concorrência de gravação. As mensagens saem em ritmo controlado e você acompanha cada uma como na fila, enviada, entregue ou lida, o que ajuda a não reenviar por engano.","Qual a vantagem de uma fila de mensagens no WhatsApp?",[119,122,125,128,131,134,136,139,142],{"url":120,"title":121},"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Freference\u002Fwhatsapp-business-phone-number\u002Fmessage-api","facebook.com",{"url":123,"title":124},"https:\u002F\u002Fwww.tabnews.com.br\u002FRelayOS\u002Fcomo-construimos-a-integracao-com-a-whatsapp-cloud-api-oficial-da-meta-o-que-aprendemos","tabnews.com.br",{"url":126,"title":127},"https:\u002F\u002Fleadnotifi.com\u002Farticles\u002Fwhatsapp-idempotent-sends-monitoring-alerting-stack","leadnotifi.com",{"url":129,"title":130},"https:\u002F\u002Fwhabuzz.com\u002Fblog\u002Fwhatsapp-api-idempotency\u002F","whabuzz.com",{"url":132,"title":133},"https:\u002F\u002Fstackoverflow.com\u002Fquestions\u002F72894209\u002Fwhatsapp-cloud-api-sending-old-message-inbound-notification-multiple-time-on-my","stackoverflow.com",{"url":135,"title":121},"https:\u002F\u002Fdevelopers.facebook.com\u002Fcommunity\u002Fthreads\u002F435282849333929\u002F",{"url":137,"title":138},"https:\u002F\u002Fmedium.com\u002F@nkangprecious26\u002Fhandling-duplicate-webhooks-in-whatsapp-api-using-redis-d7d117731f95","medium.com",{"url":140,"title":141},"https:\u002F\u002Fwww.gov.br\u002Fanpd\u002Fpt-br\u002Fcentrais-de-conteudo\u002Fdocumentos-tecnicos-orientativos\u002Fversao_publica_sei_4161316_nota_tecnica_19.pdf\u002F@@display-file\u002Ffile","www.gov.br",{"url":143,"title":141},"http:\u002F\u002Fwww.gov.br\u002Fanpd\u002Fpt-br\u002Fcentrais-de-conteudo\u002Fdocumentos-tecnicos-orientativos\u002Fsei_0227507_nota_tecnica__pub__no_58_2025_fis_cgf_anpd.pdf\u002F@@display-file\u002Ffile",[145,146,147,148,149,150,151,152],"enviar mensagem whatsapp api","mensagem duplicada whatsapp api","idempotência api whatsapp","como evitar envio duplicado whatsapp","retry webhook whatsapp","api rest whatsapp exemplo","fila de mensagens whatsapp","enviar mensagem whatsapp por api","API e integrações de WhatsApp","index","2026-11-02T12:00:43.588481+00:00",{"slug":157,"name":158,"path":159,"url":160,"bio":161,"role_title":161,"same_as":162,"photo":163},"flowzap","FlowZap S\u002FA","\u002Fautores\u002Fflowzap","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap","",[],null,{"url":165,"path":166,"og_url":167,"width":168,"height":169,"alt":170},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F75515735-d908-4f41-a40b-a8f62a88ebe6.webp","\u002Fmedia\u002Fblog\u002F75515735-d908-4f41-a40b-a8f62a88ebe6.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F75515735-d908-4f41-a40b-a8f62a88ebe6.jpg",1600,900,"Duas bolhas de mensagem idênticas saem de um celular e são barradas por um funil, ao lado de uma fila organizada de balões de",[172,194,217],{"type":6,"slug":173,"path":174,"url":175,"title":176,"meta_description":177,"published_at":178,"updated_at":178,"reading_minutes":101,"keywords":179,"cluster":153,"author":188,"cover":189},"whatsapp-mcp-claude-chatgpt","\u002Fblog\u002Fwhatsapp-mcp-claude-chatgpt","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwhatsapp-mcp-claude-chatgpt","WhatsApp MCP Claude: como usar o conector com a IA","WhatsApp MCP Claude: entenda o que é o MCP, como usar o conector do FlowZap com Claude e ChatGPT e quais cuidados tomar com acesso e LGPD.","2026-11-16T12:00:11.965959+00:00",[180,181,182,183,184,185,186,187],"whatsapp mcp claude","conector mcp whatsapp","whatsapp chatgpt integração","usar whatsapp no claude","mcp para atendimento","o que é mcp","integrar whatsapp com chatgpt","automação whatsapp com ia",{"name":158,"slug":157,"path":159},{"url":190,"path":191,"og_url":192,"width":168,"height":169,"alt":193},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.webp","\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.jpg","Mesa de trabalho com notebook exibindo uma conversa de atendimento, ao lado de uma janela de assistente de IA ligadas por um",{"type":6,"slug":195,"path":196,"url":197,"title":198,"meta_description":199,"published_at":200,"updated_at":200,"reading_minutes":201,"keywords":202,"cluster":153,"author":211,"cover":212},"webhook-ou-sse-whatsapp","\u002Fblog\u002Fwebhook-ou-sse-whatsapp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwebhook-ou-sse-whatsapp","Webhook ou SSE WhatsApp: qual usar na sua integração","Webhook ou SSE WhatsApp: veja quando usar cada um, com critérios de decisão, retentativas, assinatura e chaves por número. Leia e escolha certo.","2026-11-13T12:00:29.806432+00:00",14,[203,204,205,206,207,208,209,210],"webhook ou sse whatsapp","webhook whatsapp api","eventos em tempo real whatsapp","server-sent events whatsapp","webhook assinado whatsapp","novas tentativas de webhook","api rest whatsapp chaves por número","integrar whatsapp com sistema próprio",{"name":158,"slug":157,"path":159},{"url":213,"path":214,"og_url":215,"width":168,"height":169,"alt":216},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.webp","\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.jpg","Ilustração de um celular com WhatsApp do qual saem duas rotas luminosas: uma leva a um servidor com engrenagens e fila de",{"type":6,"slug":218,"path":219,"url":220,"title":221,"meta_description":222,"published_at":223,"updated_at":223,"reading_minutes":224,"keywords":225,"cluster":153,"author":234,"cover":235},"custo-por-mensagem-whatsapp-api","\u002Fblog\u002Fcusto-por-mensagem-whatsapp-api","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fcusto-por-mensagem-whatsapp-api","Custo por mensagem WhatsApp API: como reduzir em 2026","Custo por mensagem WhatsApp API: veja como desenhar menu, respostas rápidas e modelos para resolver com menos trocas. Leia o passo a passo.","2026-11-12T12:00:27.172848+00:00",13,[226,227,228,229,230,231,232,233],"custo por mensagem whatsapp api","quanto custa mensagem whatsapp api","cobrança janela de 24h whatsapp","reduzir custo atendimento whatsapp","api do whatsapp business valores","mensagens de serviço whatsapp cobrança","fluxo de sac no whatsapp","eficiência no atendimento por whatsapp",{"name":158,"slug":157,"path":159},{"url":236,"path":237,"og_url":238,"width":168,"height":169,"alt":239},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.webp","\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.jpg","Mesa de atendimento com celular exibindo menu numerado, notebook com caixa de conversas organizada e gráfico de linha em",{"@context":241,"@graph":242},"https:\u002F\u002Fschema.org",[243,249,252,260,271,274],{"@type":244,"@id":245,"name":246,"url":247,"logo":248},"Organization","https:\u002F\u002Fflowzap.flowpost.com.br\u002F#organization","FlowZap","https:\u002F\u002Fflowzap.flowpost.com.br\u002F","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fog\u002Fflowzap.png",{"@type":250,"@id":9,"url":9,"name":10,"inLanguage":251},"WebPage","pt-BR",{"@type":253,"@id":254,"url":9,"description":12,"inLanguage":251,"mainEntityOfPage":255,"image":167,"headline":10,"datePublished":155,"dateModified":155,"author":256,"publisher":258,"keywords":259,"articleSection":153},"BlogPosting","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fenviar-mensagem-whatsapp-api#content",{"@id":9},{"@id":257},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap#person",{"@id":245},"enviar mensagem whatsapp api, mensagem duplicada whatsapp api, idempotência api whatsapp, como evitar envio duplicado whatsapp, retry webhook whatsapp, api rest whatsapp exemplo, fila de mensagens whatsapp, enviar mensagem whatsapp por api",{"@type":261,"itemListElement":262},"BreadcrumbList",[263,267,270],{"@type":264,"position":265,"name":266,"item":247},"ListItem",1,"Início",{"@type":264,"position":24,"name":268,"item":269},"Blog","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog",{"@type":264,"position":28,"name":10,"item":9},{"@type":272,"@id":257,"name":158,"url":160,"worksFor":273},"Person",{"@id":245},{"@type":275,"@id":276,"mainEntity":277},"FAQPage","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fenviar-mensagem-whatsapp-api#faq",[278,282,284,286,288],{"@type":279,"name":105,"acceptedAnswer":280},"Question",{"@type":281,"text":104},"Answer",{"@type":279,"name":108,"acceptedAnswer":283},{"@type":281,"text":107},{"@type":279,"name":111,"acceptedAnswer":285},{"@type":281,"text":110},{"@type":279,"name":114,"acceptedAnswer":287},{"@type":281,"text":113},{"@type":279,"name":117,"acceptedAnswer":289},{"@type":281,"text":116}]