Saltar para o conteúdo principal
Um endpoint permite que um WhatsApp Flow comunique com um servidor enquanto o cliente o preenche: para verificar uma resposta, carregar opções ou decidir que ecrã vem a seguir. Cada pedido entre o WhatsApp e o endpoint é encriptado com um par de chaves que pertence ao seu número de telefone, e o WhatsApp verifica o endpoint regularmente para garantir que está a funcionar. Os Flows sem endpoint só enviam as respostas quando o cliente termina.
No Flowella. Suportado. Para Flows construídos a partir de formulários do HubSpot, o Flowella aloja o endpoint, cria e carrega a chave de encriptação no seu número, responde às verificações de estado do WhatsApp e confirma que cada pedido vem realmente do WhatsApp. Não precisa de gerir um servidor. Os Flows do Flow designer e da API Flowella não usam endpoint.

O que um endpoint faz

No Flowella. Quando o cliente submete um Flow de formulário HubSpot, o endpoint verifica as respostas com base no formulário HubSpot atual e submete-as ao HubSpot. Se algo estiver errado, o cliente vê um erro no ecrã e pode tentar novamente. Consulte Erros que o cliente vê.

Encriptação

  • Um par de chaves por número de telefone. A empresa cria uma chave pública e uma privada. A chave pública é carregada no número de telefone WhatsApp e assinada pela Meta. A chave privada fica no endpoint.
  • Cada pedido é encriptado. O WhatsApp encripta cada pedido com uma chave de utilização única, que só o endpoint consegue desbloquear com a sua chave privada. A resposta é encriptada da mesma forma.
  • Os pedidos são assinados. Cada pedido inclui uma assinatura feita com o segredo da app Meta, para que o endpoint possa rejeitar tudo o que não venha do WhatsApp.
  • O número tem de estar registado primeiro. A chave só pode ser carregada depois de o número de telefone estar registado para a Cloud API.
No Flowella. O Flowella carrega a chave no seu número por si. Se o número ainda não estiver registado, a sincronização mostra Registration required. Conclua o registo e volte a sincronizar. Consulte Números de telefone.

Versões da Data API

Os Flows de formulários HubSpot do Flowella usam a Data API 3.0. Consulte Versões do Flow JSON.

Manter o endpoint saudável

  • Responda depressa. A Meta sugere responder em menos de 1 segundo.
  • Mantenha o endpoint acessível a partir da internet em permanência e responda a todas as verificações de estado.
  • Devolva erros que a Meta reconheça, para que o Flow possa mostrar ao cliente algo útil.
Se o estado piorar, o WhatsApp limita o Flow e, depois, bloqueia-o. Consulte Estado dos Flows.

Proteger o que os clientes partilham

  • Marque os campos sensíveis. O Flow JSON pode marcar um campo como sensível, para que o WhatsApp não mostre o valor no resumo que o cliente vê depois de submeter.
  • Não peça identificadores sensíveis. As políticas do WhatsApp proíbem pedir números de cartão completos, números de contas bancárias ou números de identificação nacional. Consulte Políticas e aplicação.
  • Saiba para onde vão as respostas. No Flowella, as respostas de formulários HubSpot vão para o HubSpot, as fotos carregadas são guardadas como ficheiros públicos do HubSpot, e as respostas de Flows do designer vão para o armazenamento de submissões do Flowella e para qualquer webhook que escolha. Consulte Segurança dos dados.

Estado dos Flows

Limitação, bloqueio e recuperação.

Visão geral dos WhatsApp Flows

Flows estáticos e Flows com endpoint.

Flows no Flowella

Como os Flows de formulários HubSpot são submetidos.

Códigos de erro de Flows

Erros de endpoint e de publicação.
Verificado com base na documentação da Meta a 18 de novembro de 2026: Implementing endpoints for Flows, Flows encryption, Flow health and monitoring e o WhatsApp Flows changelog.
Última modificação em 21 de novembro de 2026