> ## 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 de WhatsApp Flows, cifrado y seguridad de datos

> Cómo intercambian datos cifrados los endpoints de WhatsApp Flows, qué claves y comprobaciones exige Meta y dónde aloja Flowella el endpoint por ti.

Un endpoint permite que un WhatsApp Flow se comunique con un servidor mientras el cliente lo rellena: para comprobar una respuesta, cargar opciones o decidir qué pantalla viene después. Todas las solicitudes entre WhatsApp y el endpoint se cifran con un par de claves que pertenece a tu número de teléfono, y WhatsApp comprueba el endpoint con regularidad para asegurarse de que funciona. Los Flows sin endpoint envían sus respuestas solo cuando el cliente termina.

> [!NOTE]
>
> **En Flowella.** Compatible. En los Flows creados a partir de formularios de HubSpot, Flowella aloja el endpoint, crea y sube la clave de cifrado a tu número, responde a las comprobaciones de estado de WhatsApp y verifica que cada solicitud procede realmente de WhatsApp. No tienes que gestionar ningún servidor. Los Flows del diseñador de Flows y de la API de Flowella no usan endpoint.

## Qué hace un endpoint

| Solicitud | Cuándo la envía WhatsApp | Qué devuelve el endpoint |
| - | - | - |
| **Comprobación de estado** | Con regularidad, y antes de publicar | Una confirmación de que está activo |
| **Intercambio de datos** | Cuando el cliente toca un botón o elige una opción configurada para llamar al endpoint | La siguiente pantalla que se debe mostrar, con sus datos, o un mensaje de error para mostrar en la pantalla actual |
| **Notificación de error** | Cuando el Flow en el teléfono tuvo un problema con una respuesta anterior | Un acuse de recibo |

> [!NOTE]
>
> **En Flowella.** Cuando el cliente envía un Flow de formulario de HubSpot, el endpoint comprueba las respuestas con el formulario de HubSpot en vigor y las envía a HubSpot. Si algo falla, el cliente ve un error en la pantalla y puede volver a intentarlo. Consulta [Errores que ve el cliente](https://knowledge.flowella.io/es/app/flows.md#errors-the-customer-sees).

## Cifrado

* **Un par de claves por número de teléfono.** La empresa crea una clave pública y una privada. La clave pública se sube al número de teléfono de WhatsApp y Meta la firma. La clave privada se queda en el endpoint.
* **Todas las solicitudes van cifradas.** WhatsApp cifra cada solicitud con una clave de un solo uso que solo el endpoint puede desbloquear con su clave privada. La respuesta se cifra de la misma forma.
* **Las solicitudes van firmadas.** Cada solicitud lleva una firma hecha con el secreto de la app de Meta, para que el endpoint pueda rechazar todo lo que no venga de WhatsApp.
* **Antes hay que registrar el número.** La clave solo se puede subir cuando el número de teléfono está registrado en la Cloud API.

> [!NOTE]
>
> **En Flowella.** Flowella sube la clave a tu número por ti. Si el número aún no está registrado, la sincronización muestra **Registration required**. Completa el registro y vuelve a sincronizar. Consulta [Números de teléfono](https://knowledge.flowella.io/es/whatsapp/accounts/phone-numbers.md).

## Versiones de Data API

| Data API | Qué añade |
| - | - |
| **3.0** | El formato original de solicitud y respuesta cifradas |
| **4.0** | Meta verifica que cada solicitud pertenece a un mensaje de Flow real y añade un token de Flow firmado opcional que el endpoint puede comprobar, desde noviembre de 2025 |

Los Flows de formularios de HubSpot de Flowella usan Data API 3.0. Consulta [Versiones de Flow JSON](https://knowledge.flowella.io/es/whatsapp/flows/flow-json-versions.md).

## Mantener el endpoint en buen estado

* Responde rápido. Meta recomienda responder en menos de 1 segundo.
* Mantente accesible desde internet en todo momento y responde a todas las comprobaciones de estado.
* Devuelve errores que Meta reconozca, para que el Flow pueda mostrar al cliente algo útil.

Si el estado empeora, WhatsApp limita el Flow y después lo bloquea. Consulta [Estado de los Flows](https://knowledge.flowella.io/es/whatsapp/flows/flow-health.md).

## Proteger lo que comparten los clientes

* **Marca los campos sensibles.** Flow JSON permite marcar un campo como sensible, para que WhatsApp no muestre su valor en el resumen que ve el cliente después de enviar.
* **No pidas identificadores sensibles.** Las políticas de WhatsApp prohíben pedir números de tarjeta completos, números de cuenta bancaria o números de documento de identidad. Consulta [Políticas y su aplicación](https://knowledge.flowella.io/es/whatsapp/messaging/policy-and-enforcement.md).
* **Ten claro adónde van las respuestas.** En Flowella, las respuestas de formularios de HubSpot van a HubSpot, las fotos subidas se guardan como archivos públicos de HubSpot y las respuestas de los Flows del diseñador van al almacén de envíos de Flowella y a cualquier webhook que elijas. Consulta [Seguridad de los datos](https://knowledge.flowella.io/es/security/data-security.md).

## Relacionado

> [card] [Estado de los Flows](https://knowledge.flowella.io/es/whatsapp/flows/flow-health.md)
>
> Limitación, bloqueo y recuperación.

> [card] [Introducción a WhatsApp Flows](https://knowledge.flowella.io/es/whatsapp/flows/flows-overview.md)
>
> Flows estáticos y con endpoint.

> [card] [Flows en Flowella](https://knowledge.flowella.io/es/app/flows.md)
>
> Cómo se envían los Flows de formularios de HubSpot.

> [card] [Códigos de error de Flows](https://knowledge.flowella.io/es/whatsapp/errors/flows-error-codes.md)
>
> Errores de endpoint y de publicación.

Comprobado con la documentación de Meta el 18 de noviembre 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) y el [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.