WhatsApp OTP

In anteprima

Codici monouso, su WhatsApp.

Configurazione in:
Cursor

La verifica WhatsApp invia il codice come messaggio authentication-template all'account WhatsApp dell'utente — ricco, brandizzato Authifly e recapitato in un'app che già utilizza. È un canale ordinabile nello stesso piano per paese, quindi una verifica può iniziare con WhatsApp e tenere SMS come riserva.

verify.ts
200 · pending
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

// Send the code, then check it by recipient.
await bird.verify.verifications.create({
  to: { phone_number: "+15551234567" },
}).safe();

const { data } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

Un canale nel piano, non una nuova integrazione.

WhatsApp è un canale phone-family sulla Bird Verify API: il destinatario è lo stesso numero di telefono, le chiamate di creazione e verifica restano invariate, e WhatsApp diventa semplicemente una voce ordinabile nel piano canali per paese. Lo ordinate prima di SMS dove converte, con SMS subito dopo nel piano ovunque.

Cosa aggiunge la verifica WhatsApp.

Un canale ordinabile nel piano per paese.

  1. 01

    Recapito tramite authentication-template.

    I codici vengono inviati come messaggi WhatsApp authentication-template — il formato che la piattaforma riserva ai codici monouso.

  2. 02

    Stesso destinatario, stesse chiamate.

    Indirizzate lo stesso numero di telefono e chiamate gli stessi endpoint di creazione e verifica. WhatsApp è il canale, non un'API diversa.

  3. 03

    Ordinabile per paese.

    Mettete WhatsApp prima di SMS nel piano canali per i paesi dove funziona meglio, e lasciate SMS come prima scelta nel resto.

  4. 04

    SMS resta in riserva.

    Un target telefonico porta con sé l'intero piano phone-family, quindi SMS si posiziona subito dopo WhatsApp. Con il rilascio dell'avanzamento basato sulla consegna, una verifica WhatsApp-first passa a SMS nella stessa sessione.

  5. 05

    Le stesse garanzie sui codici.

    Codici generati con una fonte crittografica casuale e memorizzati solo come HMAC; lunghezza e TTL configurabili; verifica per destinatario. WhatsApp eredita ogni garanzia degli altri canali.

Iniziate con WhatsApp, tenete SMS subito dopo.

L'ordine dei canali è nella configurazione, quindi scegliere WhatsApp come primo è una modifica di configurazione, non di codice. La chiamata di creazione resta la stessa.

whatsapp-otp.ts
200
await bird.verify.verifications.create({
  configuration_id: "vfc_login",
  to: { phone_number: "+15551234567" },
}).safe();

// resolved channels: [{ channel: "whatsapp" }, { channel: "sms" }]

FAQ WhatsApp OTP

La verifica WhatsApp è disponibile oggi?+
Sì. WhatsApp è disponibile come canale di lancio insieme a email e SMS — una voce ordinabile nel piano per paese, senza modifiche alle chiamate di creazione o verifica. Voice è il canale ancora in fase di rilascio.
Perché verificare tramite WhatsApp invece di SMS?+
I messaggi WhatsApp authentication-template sono brandizzati e arrivano in un'app che molti utenti tengono già aperta. Nei mercati con un uso intenso di WhatsApp, ordinarlo prima di SMS consente di raggiungere le persone sul canale che preferiscono, con SMS sempre in riserva.
Cosa succede se l'utente non è su WhatsApp?+
Un target telefonico porta con sé l'intero piano canali phone-family, quindi SMS si posiziona subito dopo WhatsApp. Con il rilascio dell'avanzamento basato sulla consegna, una verifica WhatsApp-first passa a SMS nella stessa sessione, e ogni codice in quella sessione resta valido finché non viene verificato, scade o esaurisce i tentativi.
Da chi vedono arrivare il codice i miei utenti?+
Authifly, il brand di verifica di Bird. È l'identità su ogni codice che i vostri utenti ricevono: le email arrivano da otp@verify.authifly.com o dal vostro dominio verificato, e SMS e WhatsApp sono brandizzati Authifly. authifly.com è una pagina pubblica che rassicura i destinatari che Authifly invia codici monouso legittimi per conto di un'azienda. Bird è la piattaforma su cui costruite; Authifly è ciò che il destinatario vede.

Un'unica API di verifica, per ogni canale utilizzato dai tuoi utenti.

WhatsApp si aggiunge a email e SMS come canale nello stesso piano per paese — ordinato per massimizzare le conversioni, sugli stessi due endpoint.

Inizia con un canale.
Aggiungi gli altri quando sei pronto.

Una chiave API di test è subito tua. La produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

Usi Claude Code, Cursor o Codex? Copia un prompt di configurazione e il tuo agente installerà la CLI e le skill di Bird per te. Scegli il tuo:

Cursor