Panoramica di Verify

Bird Verify conferma che un utente controlla un indirizzo email o un numero di telefono. Chiedi a Bird di inviare un codice di verifica monouso, raccoglilo nella tua app e chiedi a Bird se corrisponde. Il flusso usa due chiamate API: POST /v1/verify/verifications invia il codice e POST /v1/verify/verifications/check lo controlla. I mittenti condivisi di Bird non richiedono registrazione del mittente né configurazione di template. Email, SMS e WhatsApp possono usare Bird Verify per impostazione predefinita, Authifly o un mittente di proprietà del tuo spazio di lavoro; Telegram usa il proprio account di notifica verificato e una chiamata vocale arriva da un numero Bird scelto in base alla destinazione. Mittenti e branding illustra la scelta.

Come funziona una verifica

Crei una verifica con un destinatario: un indirizzo email, un numero di telefono o entrambi. Bird genera un codice di verifica numerico e lo recapita attraverso i canali del destinatario. Un indirizzo email riceve il codice via email; un numero di telefono lo riceve via SMS, WhatsApp, Telegram o chiamata vocale, nell'ordine e con la disponibilità che la tua configurazione paese stabilisce per il paese di destinazione. L'utente digita il codice nella tua app e tu lo invii all'endpoint di controllo, che risponde success: true o false con una motivazione.

Una verifica segue un breve ciclo di vita: inizia pending e termina verified (un codice corretto è arrivato in tempo), failed (troppi tentativi errati) o expired (la finestra temporale è scaduta). La pagina Verifications mostra ogni verifica e il suo stato; ogni stato e motivazione è descritto in Invio delle verifiche.

L'app Verify nella dashboard

Nella dashboard, Verify è una delle app dello spazio di lavoro. Le sue pagine e dove si trova la guida di ciascuna:

Visibilità

La pagina Verifications elenca ogni verifica nello spazio di lavoro e ne mostra destinatario, piano canali e dettagli di tempistica. A livello programmatico, la risposta di controllo contiene lo stato attuale della verifica. Iscriviti agli eventi Verify per ricevere aggiornamenti su creazione, recapito e verifica riuscita. Gli endpoint di elenco e lettura sono disponibili per la dashboard ma non per l'API pubblica.

Canali

Verify recapita i codici su cinque canali. Quale canale riceve un destinatario dipende dal tipo di destinatario e, per i numeri di telefono, dalla tua configurazione paese.

Per un destinatario telefonico, nella maggior parte dei paesi WhatsApp viene provato per primo e SMS funge da fallback, anche se alcuni paesi usano SMS per primo per impostazione predefinita. Nell'ordine di fallback della piattaforma, Telegram si colloca dopo SMS e prima dell'email. La voce non fa parte dell'ordine di fallback della piattaforma, quindi un paese la usa solo dopo che l'hai attivata lì, ad esempio per raggiungere utenti che non possono ricevere messaggi di testo. Puoi cambiare l'ordine o disattivare un canale per paese. Se un invio fallisce, il recapito passa al canale successivo nel piano. Puoi anche forzare il passaggio quando un utente segnala che il codice non è arrivato; vedi Invia il codice su un altro canale. Mittenti e branding mostra ogni messaggio e i controlli disponibili sul mittente.

Valori predefiniti e limiti

Il tuo spazio di lavoro parte con i valori predefiniti della piattaforma Bird per il codice stesso (lunghezza, durata), il limite di tentativi di controllo e il cooldown di reinvio. Ognuno è modificabile nella dashboard sotto Configure, e la lunghezza del codice anche per singola richiesta; valori e intervalli si trovano in Impostazioni di verifica. A questi si aggiungono protezioni anti-abuso che non devi configurare: limiti di invio e controllo per destinatario, elencati in Protezioni anti-abuso. Il messaggio del codice usa per impostazione predefinita la lingua del numero di telefono del destinatario, una delle 40 traduzioni integrate, e options.language la sovrascrive per singola richiesta. Vedi Lingua del messaggio.

Prossimi passi