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 verifica. 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. Mittenti e branding illustra la scelta.

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 o WhatsApp, 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.

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

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.

Verify recapita i codici su quattro 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, WhatsApp viene provato per primo e SMS funge da fallback nella maggior parte dei paesi, anche se alcuni usano SMS per primo per impostazione predefinita. Telegram si colloca dopo SMS e prima dell'email nell'ordine di fallback della piattaforma. 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.

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.