[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"content:article:webhook-ou-sse-whatsapp":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":113,"faqs":114,"sources":130,"keywords":148,"cluster":157,"canonical_url":9,"robots":158,"published_at":159,"updated_at":159,"author":160,"reviewer":167,"cover":168,"related":175,"json_ld":241},"f530ab5b-5b9d-486a-85de-a09914b2af16","article","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: qual usar? | FlowZap","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.",[14,15,16,17,18],"Webhook assinado leva eventos do WhatsApp de servidor para servidor, com novas tentativas se o seu sistema falhar.","SSE mantém uma conexão aberta e entrega eventos ao vivo para telas de atendimento e painéis.","Para ERP, CRM, filas e n8n, use webhook. Para chat ao vivo no navegador, use SSE.","Muitas integrações usam os dois. Webhook para gravar e processar, SSE para mostrar na tela.","No FlowZap você tem os dois, com chaves de API por organização, área ou número.","\u003Cp>Webhook ou SSE no WhatsApp? A regra é simples: use webhook assinado quando o destino é outro servidor, como ERP, CRM, fila ou n8n, e SSE quando o destino é uma tela aberta, como um chat ao vivo. Muitas integrações usam os dois. Neste guia você vê como cada um funciona, os critérios de decisão e como separar chaves de API por número.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Principais pontos\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Webhook é push de servidor para servidor, sem estado; SSE é uma conexão aberta de servidor para cliente, com estado.\u003C\u002Fli>\n\u003Cli>Webhook tem novas tentativas quando o seu endpoint falha; no SSE, o cliente precisa reconectar e retomar de onde parou.\u003C\u002Fli>\n\u003Cli>Webhook pede validação de assinatura, resposta rápida e tratamento de eventos repetidos (idempotência).\u003C\u002Fli>\n\u003Cli>SSE autentica no início da conexão e serve para interfaces ao vivo, sem polling constante.\u003C\u002Fli>\n\u003Cli>Chaves de API por organização, área ou número limitam o estrago se uma credencial vazar e facilitam a depuração.\u003C\u002Fli>\n\u003Cli>O padrão mais comum é combinar: webhook para o backend, SSE para a tela.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"webhook-ou-sse-no-whatsapp-a-resposta-curta\">Webhook ou SSE no WhatsApp: a resposta curta\u003C\u002Fh2>\n\u003Cp>A escolha cabe em uma pergunta: quem recebe o evento? Se for outro servidor (seu ERP, seu CRM, uma fila ou um fluxo no n8n), use \u003Cstrong>webhook\u003C\u002Fstrong>. Se for uma tela aberta no navegador de um atendente, use \u003Cstrong>SSE\u003C\u002Fstrong> (server-sent events).\u003C\u002Fp>\n\u003Cp>Os dois entregam o mesmo tipo de informação: mensagem recebida, mudança de status de uma mensagem enviada (na fila, enviada, entregue, lida), alteração em uma conversa. O que muda é o caminho e o que acontece quando algo dá errado.\u003C\u002Fp>\n\u003Ch3 id=\"quando-cada-um-e-a-escolha-certa\">Quando cada um é a escolha certa\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Webhook assinado:\u003C\u002Fstrong> o evento chega por requisição \u003Ccode>POST\u003C\u002Fcode> no endereço do seu sistema. Serve para gravar no CRM, abrir um chamado, atualizar um pedido ou acionar uma automação. Não precisa de ninguém olhando uma tela.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SSE:\u003C\u002Fstrong> o navegador abre uma conexão e fica ouvindo. Serve para a tela do atendente mostrar a mensagem nova e o status na hora, sem recarregar a página.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Os dois juntos:\u003C\u002Fstrong> o webhook cuida do que precisa ser gravado e processado; o SSE cuida do que precisa ser visto agora.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>A própria Meta descreve o webhook como o mecanismo para receber notificações de mensagens e status no seu servidor, conforme a \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Foverview\" rel=\"noopener noreferrer\" target=\"_blank\">visão geral de webhooks do WhatsApp\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"e-o-polling-por-que-perde-para-os-dois\">E o polling? Por que perde para os dois\u003C\u002Fh3>\n\u003Cp>Quem pesquisa webhook ou polling quer saber se vale perguntar ao servidor de tempos em tempos: \u003Cem>chegou algo novo?\u003C\u002Fem> Funciona em um protótipo, mas desperdiça requisições e atrasa o evento até a próxima consulta. Se você consulta a cada 30 segundos, a mensagem pode esperar quase isso para aparecer. Webhook e SSE invertem a lógica: quem tem a novidade avisa.\u003C\u002Fp>\n\u003Cp>O FlowZap oferece os dois caminhos na mesma conta. Os detalhes técnicos estão em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"webhook-assinado-com-novas-tentativas-como-funciona\">Webhook assinado com novas tentativas: como funciona\u003C\u002Fh2>\n\u003Cp>O webhook é o caminho clássico para integrar o WhatsApp com um sistema próprio. Você informa uma URL, e cada evento chega nela como uma requisição HTTP.\u003C\u002Fp>\n\u003Ch3 id=\"push-de-servidor-para-servidor\">Push de servidor para servidor\u003C\u002Fh3>\n\u003Cp>O fluxo é direto: aconteceu algo no número, o provedor monta um JSON e envia por \u003Ccode>POST\u003C\u002Fcode> ao seu endpoint. O seu sistema responde com um código 2xx para confirmar o recebimento. Como cada requisição é independente, o endpoint não guarda conexão aberta. Isso combina bem com funções serverless e com servidores que sobem e descem conforme a demanda.\u003C\u002Fp>\n\u003Ch3 id=\"assinatura-como-saber-que-o-evento-e-de-verdade\">Assinatura: como saber que o evento é de verdade\u003C\u002Fh3>\n\u003Cp>Seu endpoint é uma URL pública, então qualquer pessoa pode tentar enviar um JSON forjado para ela. A assinatura resolve isso. No WhatsApp Cloud API, a Meta envia o cabeçalho \u003Ccode>X-Hub-Signature-256\u003C\u002Fcode>, calculado com HMAC-SHA256 sobre o corpo bruto da requisição, usando o segredo do aplicativo. A \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Fcreate-webhook-endpoint\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">documentação da Meta sobre como criar o endpoint\u003C\u002Fa> detalha o procedimento.\u003C\u002Fp>\n\u003Cp>Três cuidados práticos:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Calcule a assinatura sobre o corpo bruto, antes de interpretar o JSON. Se você reserializar o objeto, o resultado pode mudar.\u003C\u002Fli>\n\u003Cli>Compare em tempo constante (em Node.js, \u003Ccode>crypto.timingSafeEqual\u003C\u002Fcode>), para não vazar informação pelo tempo de resposta.\u003C\u002Fli>\n\u003Cli>Descarte sem processar o que não bater com a assinatura.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Esses detalhes são da Meta. No FlowZap, os webhooks também são assinados; o formato exato da assinatura está em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"novas-tentativas-quando-o-seu-sistema-cai\">Novas tentativas quando o seu sistema cai\u003C\u002Fh3>\n\u003Cp>Sistemas ficam fora do ar: deploy, banco lento, pico de tráfego. No WhatsApp Cloud API, se o endpoint não responde com 2xx, a Meta tenta de novo com intervalos crescentes, por até 24 horas, segundo \u003Ca href=\"https:\u002F\u002Fhookdeck.com\u002Fwebhooks\u002Fplatforms\u002Fguide-to-whatsapp-webhooks-features-and-best-practices\" rel=\"noopener noreferrer\" target=\"_blank\">guia sobre as funções e boas práticas dos webhooks do WhatsApp\u003C\u002Fa>. Conferir o valor atual na documentação oficial é sempre uma boa ideia.\u003C\u002Fp>\n\u003Cp>O lado ruim: o mesmo evento pode chegar duas vezes. Por isso, quem consome webhook precisa tratar repetição. Veremos como na seção de boas práticas. Os webhooks do FlowZap também têm novas tentativas, e a política completa fica em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"eventos-em-tempo-real-sse-quando-a-tela-precisa-ver-na-hora\">Eventos em tempo real (SSE): quando a tela precisa ver na hora\u003C\u002Fh2>\n\u003Cp>Webhook entrega para servidores. Mas e a tela do atendente? Ela roda no navegador, que não tem URL pública para receber \u003Ccode>POST\u003C\u002Fcode>. É aí que entram os eventos em tempo real.\u003C\u002Fp>\n\u003Ch3 id=\"o-que-e-server-sent-events\">O que é server-sent events\u003C\u002Fh3>\n\u003Cp>SSE é uma conexão HTTP que fica aberta, na qual o servidor envia eventos em texto (\u003Ccode>Content-Type: text\u002Fevent-stream\u003C\u002Fcode>) sempre que algo acontece. O fluxo é unidirecional: do servidor para o cliente. Diferente do WebSocket, ele não precisa de protocolo próprio; roda sobre HTTP. A explicação do \u003Ca href=\"https:\u002F\u002Fbunny.net\u002Facademy\u002Fhttp\u002Fwhat-is-sse-server-sent-events-and-how-do-they-work\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">bunny.net sobre SSE\u003C\u002Fa> mostra o funcionamento básico.\u003C\u002Fp>\n\u003Cp>A API original da Meta não expõe um stream SSE. Plataformas como o FlowZap recebem os eventos e os repassam por esse canal, que é o que fornecemos como eventos em tempo real.\u003C\u002Fp>\n\u003Ch3 id=\"reconexao-e-retomada-de-onde-parou\">Reconexão e retomada de onde parou\u003C\u002Fh3>\n\u003Cp>Conexões caem: o atendente troca de Wi-Fi, o notebook dorme. O SSE tem reconexão nativa no navegador, e o cabeçalho \u003Ccode>Last-Event-ID\u003C\u002Fcode> permite ao cliente dizer qual foi o último evento recebido para retomar dali. Na prática, a garantia de entrega depende de o cliente reconectar e retomar. Se ele ficou muito tempo fora, vale recarregar o estado da conversa pela API REST ao voltar.\u003C\u002Fp>\n\u003Ch3 id=\"onde-o-sse-brilha-chat-ao-vivo-e-paineis\">Onde o SSE brilha: chat ao vivo e painéis\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Tela de atendimento que mostra a mensagem nova do cliente sem recarregar.\u003C\u002Fli>\n\u003Cli>Indicador de status da mensagem enviada mudando de enviada para entregue e lida.\u003C\u002Fli>\n\u003Cli>Painel da supervisão com a fila de conversas se atualizando.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>O limite honesto: conexão aberta é estado. Cada atendente conectado ocupa um socket no servidor, e quem constrói a própria camada precisa pensar em balanceamento de carga e em como distribuir eventos entre instâncias. Usando o SSE pronto de uma plataforma, essa parte fica com ela.\u003C\u002Fp>\n\u003Ch2 id=\"criterios-de-decisao-tabela-comparativa\">Critérios de decisão: tabela comparativa\u003C\u002Fh2>\n\u003Cp>Compare os dois lado a lado antes de escolher.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Critério\u003C\u002Fth>\n\u003Cth>Webhook assinado\u003C\u002Fth>\n\u003Cth>SSE\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Direção do fluxo\u003C\u002Ftd>\n\u003Ctd>Servidor para servidor\u003C\u002Ftd>\n\u003Ctd>Servidor para cliente (navegador ou app), em um só sentido\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Garantia de entrega\u003C\u002Ftd>\n\u003Ctd>Maior: novas tentativas automáticas se o endpoint falhar\u003C\u002Ftd>\n\u003Ctd>Moderada: depende de o cliente reconectar e retomar\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Estado\u003C\u002Ftd>\n\u003Ctd>Sem estado, bom para serverless\u003C\u002Ftd>\n\u003Ctd>Conexão aberta, exige gerenciar sockets\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Segurança\u003C\u002Ftd>\n\u003Ctd>Assinatura do corpo (HMAC-SHA256 no caso da Meta)\u003C\u002Ftd>\n\u003Ctd>Credencial (chave ou token) na abertura da conexão\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Caso de uso\u003C\u002Ftd>\n\u003Ctd>n8n, CRM, ERP, filas, bots\u003C\u002Ftd>\n\u003Ctd>Chat ao vivo, painel de atendentes, alertas visuais\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"direcao-garantia-de-entrega-e-estado\">Direção, garantia de entrega e estado\u003C\u002Fh3>\n\u003Cp>O webhook é a escolha quando perder evento custa caro: uma confirmação de pagamento, um lead novo, um status de entrega que atualiza um pedido. A repetição de tentativas protege você de quedas curtas. O SSE é a escolha quando o evento só importa enquanto alguém está olhando. Se a tela estava fechada, o dado continua salvo no sistema e será carregado quando ela abrir.\u003C\u002Fp>\n\u003Ch3 id=\"seguranca-assinatura-x-credencial-na-conexao\">Segurança: assinatura x credencial na conexão\u003C\u002Fh3>\n\u003Cp>No webhook, quem recebe precisa provar que o remetente é legítimo, por isso a assinatura. No SSE, quem abre a conexão é o seu cliente, então a autenticação acontece no início, com uma chave ou token. Os dois modelos são válidos; o erro é tratar um como o outro.\u003C\u002Fp>\n\u003Ch3 id=\"cinco-perguntas-para-decidir\">Cinco perguntas para decidir\u003C\u002Fh3>\n\u003Col>\n\u003Cli>\u003Cstrong>Quem recebe?\u003C\u002Fstrong> Um servidor, webhook. Uma tela, SSE.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Posso perder um evento?\u003C\u002Fstrong> Se não, webhook, com fila e controle de repetidos.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Tem alguém olhando a tela agora?\u003C\u002Fstrong> Se sim e a latência importa, SSE.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Minha infraestrutura aguenta conexões abertas?\u003C\u002Fstrong> Se roda em serverless, comece pelo webhook.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Preciso reprocessar eventos?\u003C\u002Fstrong> Webhook com fila facilita; no SSE, recarregue pelo estado da API.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>A comparação segue as descrições da \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Foverview\" rel=\"noopener noreferrer\" target=\"_blank\">Meta\u003C\u002Fa> para o webhook e da \u003Ca href=\"https:\u002F\u002Fbunny.net\u002Facademy\u002Fhttp\u002Fwhat-is-sse-server-sent-events-and-how-do-they-work\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">explicação sobre SSE do bunny.net\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"chaves-de-api-por-organizacao-area-ou-numero\">Chaves de API por organização, área ou número\u003C\u002Fh2>\n\u003Cp>Escolher o canal de eventos é metade da decisão. A outra metade é quem pode usar a API. No FlowZap, a API REST aceita chaves em três níveis: \u003Cstrong>organização\u003C\u002Fstrong>, \u003Cstrong>área\u003C\u002Fstrong> e \u003Cstrong>número\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch3 id=\"quando-usar-cada-nivel\">Quando usar cada nível\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Organização:\u003C\u002Fstrong> a integração central, que enxerga tudo. Boa para o sistema principal da empresa, como o ERP que conversa com todas as áreas.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Área:\u003C\u002Fstrong> isola um fluxo de trabalho. Boa quando uma equipe ou um cliente atendido (no caso de agências) precisa de acesso próprio, sem ver o resto.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Número:\u003C\u002Fstrong> limita a chave a um único número de WhatsApp. Boa para depurar um canal específico ou para dar acesso restrito a um parceiro ou a um sistema externo.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Quanto menor o alcance da chave, menor o estrago se ela vazar em um repositório, em um print ou na conta de um fornecedor.\u003C\u002Fp>\n\u003Ch3 id=\"exemplo-cobranca-separada-do-suporte\">Exemplo: cobrança separada do suporte\u003C\u002Fh3>\n\u003Cp>Imagine uma empresa com vendas, suporte e financeiro, cada um com sua área e seu número:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>O sistema de cobrança usa uma chave da área do financeiro e recebe só os eventos dela. O time de suporte nunca passa por esse fluxo.\u003C\u002Fli>\n\u003Cli>A ferramenta de chat do suporte abre o SSE com uma chave da área de suporte.\u003C\u002Fli>\n\u003Cli>O CRM central, que cadastra todo mundo, usa uma chave da organização.\u003C\u002Fli>\n\u003Cli>Uma consultoria que ajuda a depurar o número de vendas recebe uma chave daquele número, e só dele.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>A lista de operações da API e a forma de criar cada chave estão em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa>. Para entender por que uma API própria faz diferença no dia a dia da operação, leia \u003Ca href=\"\u002Fblog\u002Fflowzap\">vantagens de usar uma API como o FlowZap no WhatsApp\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"boas-praticas-para-webhooks-e-sse-funcionarem-sem-dor-de-cabeca\">Boas práticas para webhooks e SSE funcionarem sem dor de cabeça\u003C\u002Fh2>\n\u003Cp>A maior parte dos problemas em integrações com WhatsApp se resume a três: demora para responder, evento repetido e conexão que cai sem ninguém perceber.\u003C\u002Fp>\n\u003Ch3 id=\"responda-primeiro-processe-depois\">Responda primeiro, processe depois\u003C\u002Fh3>\n\u003Cp>Responda 2xx assim que validar a assinatura e guardar o evento. Só depois faça o trabalho pesado (consulta lenta, chamada a um modelo de IA, gravação em vários sistemas), de preferência em uma fila. Se o endpoint demora, o provedor entende como falha e reenvia. Guias de integração apontam um limite de espera de cerca de 5 segundos; confirme o valor atual na \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Fcreate-webhook-endpoint\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">documentação da Meta\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>É a técnica de confirmar primeiro e processar depois. Ela evita duplicidade em automações longas. O passo a passo prático está em \u003Ca href=\"\u002Fblog\u002Fwebhook-whatsapp-n8n\">webhook do WhatsApp no n8n\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"idempotencia-o-mesmo-evento-pode-chegar-duas-vezes\">Idempotência: o mesmo evento pode chegar duas vezes\u003C\u002Fh3>\n\u003Cp>Como as novas tentativas existem justamente para não perder evento, repetição é esperada. Trate assim:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Guarde o ID do evento ou da mensagem que você já processou.\u003C\u002Fli>\n\u003Cli>Ao receber de novo, ignore e responda 2xx.\u003C\u002Fli>\n\u003Cli>Escreva ações de forma que repeti-las não cause estrago: atualizar um status é seguro; criar um pedido a cada recebimento, não.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Imagine um aviso de pagamento que chega duas vezes. Sem controle, o cliente recebe dois recibos. Com o ID guardado, o segundo é descartado.\u003C\u002Fp>\n\u003Ch3 id=\"reconexao-no-sse-e-fila-de-processamento\">Reconexão no SSE e fila de processamento\u003C\u002Fh3>\n\u003Cp>No SSE, parta do princípio de que a conexão vai cair. Faça a tela reconectar sozinha, envie o último ID recebido e, se o intervalo foi grande, recarregue as conversas pela API REST. Para o backend, o desenho mais estável é: webhook recebe, valida, coloca na fila; trabalhadores processam; a tela se atualiza via SSE.\u003C\u002Fp>\n\u003Cp>Se a dúvida é custo, o texto \u003Ca href=\"\u002Fblog\u002Fapi-do-whatsapp-e-paga\">API do WhatsApp é paga? O que muda em outubro de 2026\u003C\u002Fa> ajuda a planejar o volume de mensagens.\u003C\u002Fp>\n\u003Ch2 id=\"seguranca-e-lgpd-na-hora-de-receber-eventos\">Segurança e LGPD na hora de receber eventos\u003C\u002Fh2>\n\u003Cp>Cada evento de WhatsApp carrega dados pessoais: nome, telefone, o conteúdo da conversa. Receber isso em um endpoint exige cuidado, sem alarmismo e sem improviso.\u003C\u002Fp>\n\u003Ch3 id=\"menos-acesso-menos-risco\">Menos acesso, menos risco\u003C\u002Fh3>\n\u003Cp>A LGPD (Lei 13.709\u002F2018, arts. 46 a 49) pede medidas técnicas para proteger dados pessoais. Na integração, isso se traduz em dar a cada sistema só o acesso de que precisa. Uma chave restrita a uma área ou a um número reduz o alcance de um vazamento: quem pegar a chave da cobrança não lê as conversas do suporte.\u003C\u002Fp>\n\u003Ch3 id=\"assinatura-e-credenciais-como-medida-de-seguranca\">Assinatura e credenciais como medida de segurança\u003C\u002Fh3>\n\u003Cp>Validar a assinatura do webhook evita aceitar requisições forjadas. Guardar chaves em variáveis de ambiente e trocá-las quando alguém sai da equipe também conta. No SSE, mantenha a chave fora do código que roda no navegador sempre que possível.\u003C\u002Fp>\n\u003Cp>Se, mesmo com os cuidados, houver um incidente de segurança com dados pessoais, o regulamento da ANPD de 2024 prevê comunicação à autoridade e aos titulares afetados em até 3 dias úteis a contar do conhecimento do evento, de acordo com o \u003Ca href=\"https:\u002F\u002Fwww.lgpd.ms.gov.br\u002Fwp-content\u002Fuploads\u002F2024\u002F05\u002FREGULAMENTO-DE-COMUNICACAO-DE-INCIDENTE-DE-SEGURANCA-ABRIL-2024-ANPD-.pdf\" rel=\"noopener noreferrer\" target=\"_blank\">regulamento de comunicação de incidente\u003C\u002Fa> e com a \u003Ca href=\"https:\u002F\u002Fconfidata.com.br\u002Fblog\u002Fcomunicacao-incidente-seguranca-anpd\" rel=\"noopener noreferrer\" target=\"_blank\">explicação da Confidata\u003C\u002Fa>. Os casos e prazos têm nuances, então valide o procedimento com o jurídico da sua empresa. Este texto não é aconselhamento jurídico.\u003C\u002Fp>\n\u003Cp>Um lembrete que vale para qualquer integração: enviar mensagens só é correto para quem autorizou. Veja o \u003Ca href=\"\u002Fblog\u002Flgpd-whatsapp-business-checklist-consentimento\">checklist de consentimento da LGPD para WhatsApp Business\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"como-o-flowzap-oferece-os-dois\">Como o FlowZap oferece os dois\u003C\u002Fh2>\n\u003Cp>O FlowZap reúne, na mesma conta, os recursos que este guia comparou.\u003C\u002Fp>\n\u003Ch3 id=\"webhooks-assinados-sse-chaves-e-integracoes\">Webhooks assinados, SSE, chaves e integrações\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>API REST\u003C\u002Fstrong> com chaves por organização, por área ou por número.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Webhooks assinados\u003C\u002Fstrong> com novas tentativas, para alimentar CRM, ERP, filas e automações.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Eventos em tempo real (SSE)\u003C\u002Fstrong>, para telas e painéis que precisam ver mensagens e status na hora.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Chatwoot\u003C\u002Fstrong>, exemplos para \u003Cstrong>n8n\u003C\u002Fstrong> e \u003Cstrong>Make\u003C\u002Fstrong>, e o \u003Cstrong>conector MCP\u003C\u002Fstrong> para usar a conta no Claude e no ChatGPT, do plano Growth em diante (veja em \u003Ca href=\"\u002Fclaude-chatgpt\">\u002Fclaude-chatgpt\u003C\u002Fa>).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Todos os planos incluem API e webhooks. Os valores e limites de cada plano estão em \u003Ca href=\"\u002Fprecos\">\u002Fprecos\u003C\u002Fa>; como referência, o Start custa R$ 49 por mês e o Growth, R$ 149 por mês. O cadastro não pede cartão, o pagamento é por Pix ou cartão de crédito e não há fidelidade.\u003C\u002Fp>\n\u003Ch3 id=\"combinar-webhook-e-sse-um-desenho-que-funciona\">Combinar webhook e SSE: um desenho que funciona\u003C\u002Fh3>\n\u003Cp>Uma empresa de serviços recebe pedidos pelo WhatsApp. O desenho fica assim:\u003C\u002Fp>\n\u003Col>\n\u003Cli>Chega uma mensagem do cliente. O \u003Cstrong>webhook\u003C\u002Fstrong> entrega o evento ao sistema da empresa, que valida a assinatura, responde 2xx e grava o contato e o pedido no CRM.\u003C\u002Fli>\n\u003Cli>A mesma mensagem aparece, via \u003Cstrong>SSE\u003C\u002Fstrong>, na tela do atendente que está de plantão, sem recarregar.\u003C\u002Fli>\n\u003Cli>O atendente responde. O status da mensagem muda de na fila para enviada, entregue e lida, e a tela acompanha ao vivo.\u003C\u002Fli>\n\u003Cli>Se o sistema da empresa ficar fora do ar por alguns minutos, as novas tentativas do webhook evitam que o pedido se perca.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch3 id=\"proximos-passos\">Próximos passos\u003C\u002Fh3>\n\u003Cp>Para ver o que mais a plataforma cobre, como caixa de conversas em equipe, CRM e respostas automáticas, consulte \u003Ca href=\"\u002Fproduto\">\u002Fproduto\u003C\u002Fa>. Se a sua operação tem vários atendentes, o guia de \u003Ca href=\"\u002Fblog\u002Fwhatsapp-para-empresas-multiusuario\">WhatsApp para empresas multiusuário\u003C\u002Fa> mostra como organizar as equipes. Na dúvida entre webhook ou SSE no WhatsApp, volte às cinco perguntas da tabela: quem recebe, se pode perder evento e se há alguém olhando a tela.\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,101,104,107,110],{"id":22,"text":23,"level":24},"webhook-ou-sse-no-whatsapp-a-resposta-curta","Webhook ou SSE no WhatsApp: a resposta curta",2,{"id":26,"text":27,"level":28},"quando-cada-um-e-a-escolha-certa","Quando cada um é a escolha certa",3,{"id":30,"text":31,"level":28},"e-o-polling-por-que-perde-para-os-dois","E o polling? Por que perde para os dois",{"id":33,"text":34,"level":24},"webhook-assinado-com-novas-tentativas-como-funciona","Webhook assinado com novas tentativas: como funciona",{"id":36,"text":37,"level":28},"push-de-servidor-para-servidor","Push de servidor para servidor",{"id":39,"text":40,"level":28},"assinatura-como-saber-que-o-evento-e-de-verdade","Assinatura: como saber que o evento é de verdade",{"id":42,"text":43,"level":28},"novas-tentativas-quando-o-seu-sistema-cai","Novas tentativas quando o seu sistema cai",{"id":45,"text":46,"level":24},"eventos-em-tempo-real-sse-quando-a-tela-precisa-ver-na-hora","Eventos em tempo real (SSE): quando a tela precisa ver na hora",{"id":48,"text":49,"level":28},"o-que-e-server-sent-events","O que é server-sent events",{"id":51,"text":52,"level":28},"reconexao-e-retomada-de-onde-parou","Reconexão e retomada de onde parou",{"id":54,"text":55,"level":28},"onde-o-sse-brilha-chat-ao-vivo-e-paineis","Onde o SSE brilha: chat ao vivo e painéis",{"id":57,"text":58,"level":24},"criterios-de-decisao-tabela-comparativa","Critérios de decisão: tabela comparativa",{"id":60,"text":61,"level":28},"direcao-garantia-de-entrega-e-estado","Direção, garantia de entrega e estado",{"id":63,"text":64,"level":28},"seguranca-assinatura-x-credencial-na-conexao","Segurança: assinatura x credencial na conexão",{"id":66,"text":67,"level":28},"cinco-perguntas-para-decidir","Cinco perguntas para decidir",{"id":69,"text":70,"level":24},"chaves-de-api-por-organizacao-area-ou-numero","Chaves de API por organização, área ou número",{"id":72,"text":73,"level":28},"quando-usar-cada-nivel","Quando usar cada nível",{"id":75,"text":76,"level":28},"exemplo-cobranca-separada-do-suporte","Exemplo: cobrança separada do suporte",{"id":78,"text":79,"level":24},"boas-praticas-para-webhooks-e-sse-funcionarem-sem-dor-de-cabeca","Boas práticas para webhooks e SSE funcionarem sem dor de cabeça",{"id":81,"text":82,"level":28},"responda-primeiro-processe-depois","Responda primeiro, processe depois",{"id":84,"text":85,"level":28},"idempotencia-o-mesmo-evento-pode-chegar-duas-vezes","Idempotência: o mesmo evento pode chegar duas vezes",{"id":87,"text":88,"level":28},"reconexao-no-sse-e-fila-de-processamento","Reconexão no SSE e fila de processamento",{"id":90,"text":91,"level":24},"seguranca-e-lgpd-na-hora-de-receber-eventos","Segurança e LGPD na hora de receber eventos",{"id":93,"text":94,"level":28},"menos-acesso-menos-risco","Menos acesso, menos risco",{"id":96,"text":97,"level":28},"assinatura-e-credenciais-como-medida-de-seguranca","Assinatura e credenciais como medida de segurança",{"id":99,"text":100,"level":24},"como-o-flowzap-oferece-os-dois","Como o FlowZap oferece os dois",{"id":102,"text":103,"level":28},"webhooks-assinados-sse-chaves-e-integracoes","Webhooks assinados, SSE, chaves e integrações",{"id":105,"text":106,"level":28},"combinar-webhook-e-sse-um-desenho-que-funciona","Combinar webhook e SSE: um desenho que funciona",{"id":108,"text":109,"level":28},"proximos-passos","Próximos passos",{"id":111,"text":112,"level":24},"comece-com-o-flowzap","Comece com o FlowZap",14,[115,118,121,124,127],{"a":116,"q":117},"O webhook envia cada evento por POST de servidor para servidor, com novas tentativas se o seu sistema falhar. O SSE mantém uma conexão aberta e entrega eventos ao vivo ao navegador. Use webhook para ERP, CRM e filas, e SSE para telas de atendimento.","Qual a diferença entre webhook e SSE no WhatsApp?",{"a":119,"q":120},"Na maioria dos casos, webhook. No polling você consulta o servidor repetidamente, gasta requisições e o evento espera até a próxima consulta. No webhook, o aviso chega assim que o evento acontece. O polling só serve como apoio para conferir o estado depois de uma queda.","Webhook ou polling: qual é melhor para integrar o WhatsApp?",{"a":122,"q":123},"São reenvios automáticos do evento quando o seu endpoint não responde com sucesso (código 2xx). No WhatsApp Cloud API, a Meta reenvia com intervalos crescentes por até 24 horas. Por isso o seu sistema deve ignorar eventos repetidos, guardando o ID do que já processou.","O que são novas tentativas de webhook?",{"a":125,"q":126},"Calcule o HMAC-SHA256 do corpo bruto da requisição com o segredo configurado e compare com o cabeçalho de assinatura, em tempo constante. No WhatsApp Cloud API, o cabeçalho é X-Hub-Signature-256. Só interprete o JSON depois de validar. Para o FlowZap, veja o formato em \u002Fdocs.","Como validar um webhook assinado do WhatsApp?",{"a":128,"q":129},"Sim. No FlowZap, a API REST aceita chaves por organização, por área ou por número. Assim cada sistema acessa só o que precisa, e um vazamento de chave atinge menos conversas. Isso também facilita a depuração de um canal específico.","Posso usar chaves de API diferentes por número de WhatsApp?",[131,134,136,139,142,145],{"url":132,"title":133},"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Foverview","facebook.com",{"url":135,"title":133},"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fwebhooks\u002Fcreate-webhook-endpoint\u002F",{"url":137,"title":138},"https:\u002F\u002Fhookdeck.com\u002Fwebhooks\u002Fplatforms\u002Fguide-to-whatsapp-webhooks-features-and-best-practices","hookdeck.com",{"url":140,"title":141},"https:\u002F\u002Fbunny.net\u002Facademy\u002Fhttp\u002Fwhat-is-sse-server-sent-events-and-how-do-they-work\u002F","bunny.net",{"url":143,"title":144},"https:\u002F\u002Fwww.lgpd.ms.gov.br\u002Fwp-content\u002Fuploads\u002F2024\u002F05\u002FREGULAMENTO-DE-COMUNICACAO-DE-INCIDENTE-DE-SEGURANCA-ABRIL-2024-ANPD-.pdf","lgpd.ms.gov.br",{"url":146,"title":147},"https:\u002F\u002Fconfidata.com.br\u002Fblog\u002Fcomunicacao-incidente-seguranca-anpd","confidata.com.br",[149,150,151,152,153,154,155,156],"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","API e integrações de WhatsApp","index","2026-11-13T12:00:29.806432+00:00",{"slug":161,"name":162,"path":163,"url":164,"bio":165,"role_title":165,"same_as":166,"photo":167},"flowzap","FlowZap S\u002FA","\u002Fautores\u002Fflowzap","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap","",[],null,{"url":169,"path":170,"og_url":171,"width":172,"height":173,"alt":174},"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",1600,900,"Ilustração de um celular com WhatsApp do qual saem duas rotas luminosas: uma leva a um servidor com engrenagens e fila de",[176,198,219],{"type":6,"slug":177,"path":178,"url":179,"title":180,"meta_description":181,"published_at":182,"updated_at":182,"reading_minutes":183,"keywords":184,"cluster":157,"author":192,"cover":193},"status-de-mensagem-whatsapp-api","\u002Fblog\u002Fstatus-de-mensagem-whatsapp-api","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fstatus-de-mensagem-whatsapp-api","Status de mensagem WhatsApp API: enviada, entregue e lida","Status de mensagem WhatsApp API: entenda fila, enviada, entregue e lida, o que fazer quando trava e como usar webhooks. Leia o guia.","2026-11-10T12:00:21.909205+00:00",12,[185,186,187,188,189,190,150,191],"status de mensagem whatsapp api","webhook whatsapp cloud api","webhook whatsapp business","mensagem enviada entregue lida whatsapp","status de entrega whatsapp","como saber se a mensagem foi lida whatsapp api","mensagem na fila whatsapp",{"name":162,"slug":161,"path":163},{"url":194,"path":195,"og_url":196,"width":172,"height":173,"alt":197},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Fc5b51eba-e3eb-4ec6-9ec8-826198ad2056.webp","\u002Fmedia\u002Fblog\u002Fc5b51eba-e3eb-4ec6-9ec8-826198ad2056.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Fc5b51eba-e3eb-4ec6-9ec8-826198ad2056.jpg","Celular sobre mesa de atendimento com uma mensagem avançando por quatro marcadores de uma linha do tempo, ao lado de um",{"type":6,"slug":199,"path":200,"url":201,"title":202,"meta_description":203,"published_at":204,"updated_at":204,"reading_minutes":205,"keywords":206,"cluster":157,"author":213,"cover":214},"webhook-whatsapp-n8n","\u002Fblog\u002Fwebhook-whatsapp-n8n","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwebhook-whatsapp-n8n","Webhook whatsapp n8n: Webhook WhatsApp no n8n: passo a passo","Aprenda a montar um webhook WhatsApp n8n: receber mensagens, validar a assinatura HMAC e evitar duplicidade nas novas tentativas. Veja o passo a passo.","2026-10-18T12:00:13.689923+00:00",15,[207,208,209,210,150,187,211,212],"webhook whatsapp n8n","whatsapp n8n workflow","whatsapp n8n trigger","automação whatsapp n8n","como validar assinatura de webhook","whatsapp n8n template",{"name":162,"slug":161,"path":163},{"url":215,"path":216,"og_url":217,"width":172,"height":173,"alt":218},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F09ddf1c0-1191-4177-8143-625f0f179033.webp","\u002Fmedia\u002Fblog\u002F09ddf1c0-1191-4177-8143-625f0f179033.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F09ddf1c0-1191-4177-8143-625f0f179033.jpg","Mesa de desenvolvedor com monitor exibindo um fluxo de blocos conectados por linhas, um cadeado em destaque entre dois",{"type":6,"slug":220,"path":221,"url":222,"title":223,"meta_description":224,"published_at":225,"updated_at":225,"reading_minutes":183,"keywords":226,"cluster":157,"author":235,"cover":236},"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",[227,228,229,230,231,232,233,234],"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":162,"slug":161,"path":163},{"url":237,"path":238,"og_url":239,"width":172,"height":173,"alt":240},"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",{"@context":242,"@graph":243},"https:\u002F\u002Fschema.org",[244,250,253,261,272,275],{"@type":245,"@id":246,"name":247,"url":248,"logo":249},"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":251,"@id":9,"url":9,"name":10,"inLanguage":252},"WebPage","pt-BR",{"@type":254,"@id":255,"url":9,"description":12,"inLanguage":252,"mainEntityOfPage":256,"image":171,"headline":10,"datePublished":159,"dateModified":159,"author":257,"publisher":259,"keywords":260,"articleSection":157},"BlogPosting","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwebhook-ou-sse-whatsapp#content",{"@id":9},{"@id":258},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap#person",{"@id":246},"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",{"@type":262,"itemListElement":263},"BreadcrumbList",[264,268,271],{"@type":265,"position":266,"name":267,"item":248},"ListItem",1,"Início",{"@type":265,"position":24,"name":269,"item":270},"Blog","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog",{"@type":265,"position":28,"name":10,"item":9},{"@type":273,"@id":258,"name":162,"url":164,"worksFor":274},"Person",{"@id":246},{"@type":276,"@id":277,"mainEntity":278},"FAQPage","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwebhook-ou-sse-whatsapp#faq",[279,283,285,287,289],{"@type":280,"name":117,"acceptedAnswer":281},"Question",{"@type":282,"text":116},"Answer",{"@type":280,"name":120,"acceptedAnswer":284},{"@type":282,"text":119},{"@type":280,"name":123,"acceptedAnswer":286},{"@type":282,"text":122},{"@type":280,"name":126,"acceptedAnswer":288},{"@type":282,"text":125},{"@type":280,"name":129,"acceptedAnswer":290},{"@type":282,"text":128}]