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

# Template di autenticazione WhatsApp per codici monouso

> Come i template di autenticazione WhatsApp inviano codici: testo fisso, pulsanti copy code, one-tap e zero-tap, time-to-live e invio da Flowella.

Un template di autenticazione invia un codice monouso, per l'accesso, il recupero dell'account o la conferma di una transazione. È l'unica categoria autorizzata a contenere un codice, ed è la più rigida: il testo è stabilito da Meta, voi aggiungete solo il codice e le righe facoltative di sicurezza e di scadenza, e il messaggio include un pulsante che copia o inserisce il codice.

> [!NOTE]
>
> **In Flowella.** Supportato in parte. Flowella può inviare template di autenticazione tramite l'[API Flowella](https://knowledge.flowella.io/it/hubspot/workflows/authentication-otp.md), con un codice diverso per ogni destinatario. L'editor di Flowella non può aggiungere pulsanti per i codici, quindi create il template in WhatsApp Manager. Un workflow HubSpot non può inviare codici.

## Cosa contiene il messaggio

| Parte | Contenuto | Potete modificarla |
| - | - | - |
| Corpo | Il testo predefinito di Meta: il codice, seguito da "is your verification code", tradotto nella lingua del template | Solo il codice |
| Riga di sicurezza | "For your security, do not share this code." | Attiva o disattiva |
| Riga di scadenza | "This code expires in N minutes", da 1 a 90 minuti | Attiva o disattiva, e il numero di minuti |
| Pulsante | Copy code, compilazione automatica one-tap o zero-tap | Il tipo e, per il one-tap, i dati dell'app |

I template di autenticazione non possono contenere link, media o emoji, e ogni variabile è limitata a 15 caratteri. Usate solo cifre e lettere nel codice.

## Tipi di pulsante

| Tipo | Come funziona | Dove funziona |
| - | - | - |
| **Copy code** | La persona tocca il pulsante, WhatsApp copia il codice e la persona lo incolla nella vostra app o sul vostro sito | Qualsiasi telefono, senza lavoro da parte vostra |
| **Compilazione automatica one-tap** | La persona tocca il pulsante e WhatsApp passa il codice direttamente alla vostra app Android | Android, con modifiche alla vostra app |
| **Zero-tap** | WhatsApp passa il codice alla vostra app Android senza alcun tocco | Android, con modifiche alla vostra app e i termini zero-tap di Meta accettati |

Su iOS 26 e versioni successive, iOS propone il codice come suggerimento della tastiera a partire dalla notifica, per ogni template di autenticazione, senza lavoro da parte vostra. Le versioni precedenti di iOS non compilano automaticamente il codice, quindi copy code è la scelta sicura se non sviluppate un'app Android nativa.

> [!WARNING]
>
> Se la vostra app Android avvia l'handshake one-tap o zero-tap con `PendingIntent`, passate all'OTP Android SDK di Meta prima del 31 gennaio 2027, quando Meta ritirerà il metodo `PendingIntent`.

## Dispositivi collegati

WhatsApp consegna i messaggi di autenticazione solo al telefono principale della persona. Sui dispositivi collegati, come WhatsApp Web o un tablet, il messaggio è nascosto e alla persona viene chiesto di controllare il telefono. Non potete disattivare questo comportamento.

## Time-to-live

| | Valore |
| - | - |
| Valore predefinito di Meta | 10 minuti. I template creati prima del 23 ottobre 2024 hanno un valore predefinito di 30 giorni. |
| Intervallo impostabile | Da 30 secondi a 15 minuti |

Impostate un time-to-live non più lungo della validità del codice, così nessuno riceve un codice già scaduto. Flowella non ha un'impostazione per il time-to-live. Se vi serve un valore personalizzato, impostatelo sul template in WhatsApp Manager.

## Prezzo

I messaggi di autenticazione vengono addebitati per ogni messaggio consegnato, con [scaglioni di volume](https://knowledge.flowella.io/it/whatsapp/pricing/whatsapp-pricing.md#volume-tiers-for-utility-and-authentication). In alcuni mercati, Meta applica una tariffa più alta, **authentication-international**, quando un'azienda idonea invia codici a numeri di quel mercato. Consultate [Prezzi di WhatsApp](https://knowledge.flowella.io/it/whatsapp/pricing/whatsapp-pricing.md).

## Crearne uno in WhatsApp Manager

**1. Avviate un template**

In [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates), fate clic su **Create template** e scegliete **Authentication**. Potete anche partire da un template di autenticazione della libreria di Meta.

**2. Scegliete le opzioni**

Scegliete il tipo di pulsante e attivate la riga di sicurezza e la riga di scadenza se vi servono. Per il one-tap o lo zero-tap, aggiungete il nome del pacchetto e l'hash della firma della vostra app Android.

**3. Inviate**

Scegliete le lingue e inviate il template. Il testo lo scrive Meta, quindi la revisione di solito è rapida.

Il template compare poi nella pagina **Templates** di Flowella, pronto per l'invio tramite l'API.

## Inviare codici da Flowella

La vostra app genera il codice, lo salva con una scadenza e chiama `POST /v1/templates/send` con il codice come variabile del corpo e come valore del pulsante. Flowella rifiuta un codice più lungo di 15 caratteri prima che arrivi a Meta. Per una guida completa con le regole di reinvio e di blocco, consultate [Inviare codici monouso](https://knowledge.flowella.io/it/hubspot/workflows/authentication-otp.md).

## Buone pratiche

* **Verificate prima il numero.** Assicuratevi che il numero WhatsApp appartenga alla persona prima di inviarle un codice.
* **Avvisate le persone che il codice arriverà su WhatsApp**, soprattutto se offrite anche SMS o email.
* **Mostrate che l'avete ricevuto.** Quando la persona incolla il codice, o la vostra app lo riceve, confermatelo sullo schermo.
* **Non inviate codici in template di marketing o utility.** Meta rifiuta i template che contengono codici nella categoria sbagliata, a partire dal primo giorno del mese successivo. Consultate [Categorie dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-categories.md#when-meta-changes-a-category-after-approval).

## Correlati

> [card] [Inviare codici monouso](https://knowledge.flowella.io/it/hubspot/workflows/authentication-otp.md)
>
> La guida all'API Flowella.

> [card] [Libreria dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-library.md)
>
> I template già pronti di Meta.

> [card] [Nozioni di base sui template](https://knowledge.flowella.io/it/whatsapp/templates/template-fundamentals.md)
>
> Nomi, lingue, stati e limiti.

> [card] [Prezzi di WhatsApp](https://knowledge.flowella.io/it/whatsapp/pricing/whatsapp-pricing.md)
>
> Tariffe di autenticazione e tariffa internazionale.

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates), [Template categorization](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization) e [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


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