> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoints, encriptação e segurança dos WhatsApp Flows

> Como os endpoints dos WhatsApp Flows trocam dados encriptados, as chaves e verificações de estado que a Meta exige e onde o Flowella aloja o endpoint.

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.

> [!NOTE]
>
> **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

| Pedido | Quando o WhatsApp o envia | O que o endpoint devolve |
| - | - | - |
| **Health check** | Regularmente e antes da publicação | Uma confirmação de que está ativo |
| **Data exchange** | Quando o cliente toca num botão ou escolhe uma opção configurada para chamar o endpoint | O ecrã seguinte a mostrar, com os respetivos dados, ou uma mensagem de erro a mostrar no ecrã atual |
| **Error notification** | Quando o Flow no telemóvel teve um problema com uma resposta anterior | Uma confirmação de receção |

> [!NOTE]
>
> **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ê](https://knowledge.flowella.io/pt/app/flows.md#errors-the-customer-sees).

## 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.

> [!NOTE]
>
> **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](https://knowledge.flowella.io/pt/whatsapp/accounts/phone-numbers.md).

## Versões da Data API

| Data API | O que acrescenta |
| - | - |
| **3.0** | O formato original de pedido e resposta encriptados |
| **4.0** | A Meta verifica se cada pedido pertence a uma mensagem de Flow real e acrescenta um Flow token assinado opcional que o endpoint pode verificar, desde novembro de 2025 |

Os Flows de formulários HubSpot do Flowella usam a Data API 3.0. Consulte [Versões do Flow JSON](https://knowledge.flowella.io/pt/whatsapp/flows/flow-json-versions.md).

## 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](https://knowledge.flowella.io/pt/whatsapp/flows/flow-health.md).

## 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](https://knowledge.flowella.io/pt/whatsapp/messaging/policy-and-enforcement.md).
* **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](https://knowledge.flowella.io/pt/security/data-security.md).

## Relacionado

> [card] [Estado dos Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flow-health.md)
>
> Limitação, bloqueio e recuperação.

> [card] [Visão geral dos WhatsApp Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flows-overview.md)
>
> Flows estáticos e Flows com endpoint.

> [card] [Flows no Flowella](https://knowledge.flowella.io/pt/app/flows.md)
>
> Como os Flows de formulários HubSpot são submetidos.

> [card] [Códigos de erro de Flows](https://knowledge.flowella.io/pt/whatsapp/errors/flows-error-codes.md)
>
> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/implementingyourflowendpoint), [Flows encryption](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/whatsapp-business-encryption), [Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring) e o [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.