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

# Endpoint dei WhatsApp Flow, cifratura e sicurezza dei dati

> Come gli endpoint dei WhatsApp Flow scambiano dati cifrati, le chiavi e gli health check richiesti da Meta, e dove Flowella ospita l'endpoint per voi.

Un endpoint permette a un WhatsApp Flow di comunicare con un server mentre il cliente lo compila: per verificare una risposta, caricare opzioni o decidere quale schermata mostrare dopo. Ogni richiesta tra WhatsApp e l'endpoint è cifrata con una coppia di chiavi che appartiene al vostro numero di telefono, e WhatsApp controlla regolarmente l'endpoint per assicurarsi che funzioni. I Flows senza endpoint inviano le risposte solo quando il cliente ha finito.

> [!NOTE]
>
> **In Flowella.** Supportato. Per i Flows creati da moduli HubSpot, Flowella ospita l'endpoint, crea e carica la chiave di cifratura sul vostro numero, risponde agli health check di WhatsApp e verifica che ogni richiesta provenga davvero da WhatsApp. Non dovete gestire alcun server. I Flows del Flow designer e della Flowella API non usano un endpoint.

## Cosa fa un endpoint

| Richiesta | Quando la invia WhatsApp | Cosa restituisce l'endpoint |
| - | - | - |
| **Health check** | Regolarmente e prima della pubblicazione | Una conferma di essere attivo |
| **Data exchange** | Quando il cliente tocca un pulsante o sceglie un'opzione impostata per chiamare l'endpoint | La schermata successiva da mostrare, con i suoi dati, o un messaggio di errore da mostrare nella schermata corrente |
| **Error notification** | Quando il Flow sul telefono ha incontrato un problema con una risposta precedente | Una conferma di ricezione |

> [!NOTE]
>
> **In Flowella.** Quando il cliente invia un Flow basato su un modulo HubSpot, l'endpoint verifica le risposte rispetto al modulo HubSpot attivo e le invia a HubSpot. Se qualcosa non va, il cliente vede un errore sullo schermo e può riprovare. Consultate [Errori che vede il cliente](https://knowledge.flowella.io/it/app/flows.md#errors-the-customer-sees).

## Cifratura

* **Una coppia di chiavi per numero di telefono.** L'azienda crea una chiave pubblica e una privata. La chiave pubblica viene caricata sul numero di telefono WhatsApp e firmata da Meta. La chiave privata resta sull'endpoint.
* **Ogni richiesta è cifrata.** WhatsApp cifra ogni richiesta con una chiave monouso, che solo l'endpoint può sbloccare con la propria chiave privata. La risposta viene cifrata allo stesso modo.
* **Le richieste sono firmate.** Ogni richiesta riporta una firma creata con il secret dell'app Meta, così l'endpoint può rifiutare tutto ciò che non proviene da WhatsApp.
* **Il numero deve essere registrato prima.** La chiave si può caricare solo dopo che il numero di telefono è stato registrato per la Cloud API.

> [!NOTE]
>
> **In Flowella.** Flowella carica la chiave sul vostro numero per voi. Se il numero non è ancora registrato, la sincronizzazione mostra **Registration required**. Completate la registrazione, poi sincronizzate di nuovo. Consultate [Numeri di telefono](https://knowledge.flowella.io/it/whatsapp/accounts/phone-numbers.md).

## Versioni della Data API

| Data API | Cosa aggiunge |
| - | - |
| **3.0** | Il formato originale cifrato di richiesta e risposta |
| **4.0** | Meta verifica che ogni richiesta appartenga a un vero messaggio Flow e aggiunge un Flow token firmato facoltativo che l'endpoint può controllare, da novembre 2025 |

I Flows di Flowella basati su moduli HubSpot usano la Data API 3.0. Consultate [Versioni di Flow JSON](https://knowledge.flowella.io/it/whatsapp/flows/flow-json-versions.md).

## Mantenere l'endpoint in salute

* Rispondete rapidamente. Meta suggerisce di rispondere in meno di 1 secondo.
* Restate sempre raggiungibili da internet e rispondete a ogni health check.
* Restituite errori che Meta riconosce, così il Flow può mostrare al cliente qualcosa di utile.

Se lo stato di salute peggiora, WhatsApp limita il Flow, poi lo blocca. Consultate [Salute dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-health.md).

## Proteggere ciò che condividono i clienti

* **Segnate i campi sensibili.** Flow JSON può segnare un campo come sensibile, così WhatsApp non ne mostra il valore nel riepilogo che il cliente vede dopo l'invio.
* **Non chiedete identificativi sensibili.** Le policy di WhatsApp vietano di chiedere numeri di carta completi, numeri di conto bancario o numeri di documenti d'identità nazionali. Consultate [Policy e loro applicazione](https://knowledge.flowella.io/it/whatsapp/messaging/policy-and-enforcement.md).
* **Sappiate dove vanno le risposte.** In Flowella, le risposte ai moduli HubSpot vanno a HubSpot, le foto caricate vengono salvate come file pubblici di HubSpot e le risposte ai Flow del designer vanno nell'archivio degli invii di Flowella e a qualsiasi webhook scegliate. Consultate [Sicurezza dei dati](https://knowledge.flowella.io/it/security/data-security.md).

## Correlati

> [card] [Salute dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-health.md)
>
> Limitazione, blocco e ripristino.

> [card] [Panoramica dei WhatsApp Flows](https://knowledge.flowella.io/it/whatsapp/flows/flows-overview.md)
>
> Flows statici e con endpoint.

> [card] [I Flows in Flowella](https://knowledge.flowella.io/it/app/flows.md)
>
> Come vengono inviati i Flows basati su moduli HubSpot.

> [card] [Codici di errore dei Flows](https://knowledge.flowella.io/it/whatsapp/errors/flows-error-codes.md)
>
> Errori di endpoint e di pubblicazione.

Verificato rispetto alla documentazione di Meta il 18 novembre 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 il [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.