Orchestrazione dei canali
Bird decide le impostazioni predefinite. Voi regolate una singola chiamata.
Disponibilità dei canali, regole sui mittenti e normative variano da paese a paese, e gestirle correttamente richiede anni di lavoro. Bird le fornisce come base per paese: quali canali funzionano dove, quali mittenti sono consentiti e impostazioni di codice predefinite sensate, derivate dalla gestione di email e SMS su larga scala. Una chiamata di creazione risolve già il piano corretto per qualsiasi paese, e il campo options può riordinare o restringere i canali o impostare la lunghezza del codice per quella singola verifica.
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, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
Il tuo account
Conferma la tua identità.
Inserisci il codice inviato a
+1 ••• ••• 4567Codice di verifica di esempio
Scelto ogni giorno dai team che creano software di livello mondiale
Leggi altre storie dei clientiLe impostazioni predefinite di Bird accompagnano ogni chiamata.
Ogni verifica sulla Bird Verify API viene risolta rispetto a una base per paese che Bird mantiene grazie ad anni di gestione di email e SMS, quindi una verifica viene già instradata in modo sensato in ogni paese prima ancora di scrivere una riga di codice. Un'opzione per singola richiesta può comunque regolare una singola chiamata: riordinare o restringere i canali, o impostare la lunghezza del codice. Non si parte mai da zero.
Due livelli decidono il piano.
Prevale quello più specifico; tutto ciò che una richiesta non imposta ricade sulla base per paese di Bird.
- 01
Opzioni per richiesta.
Passate channels o code_length nella chiamata di creazione per riordinare o restringere i canali, o impostare la lunghezza del codice, per quella singola verifica. Omettete uno dei due e verrà applicata l'impostazione predefinita del paese.
- 02
Base per paese di Bird.
Le impostazioni predefinite per paese di Bird, derivate dalla gestione di email e SMS su larga scala: quali canali sono disponibili, quali mittenti sono consentiti e impostazioni predefinite sensate per codice e TTL. Tutto ciò che una richiesta non sovrascrive viene risolto da qui, così una verifica approda sempre su un piano sensato.
Ciò che una verifica risolve.
Un numero brasiliano viene risolto rispetto alla base per paese di Bird per il Brasile, filtrata da eventuali opzioni per singola richiesta nella chiamata. WhatsApp e SMS sono entrambi disponibili lì, quindi la verifica riporta quel piano ordinato, con il suo id tipizzato vrf_.
const { data, error } = await bird.verify.verifications.create({
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
if (error) throw error;
// Resolved from the per-country base, capped by availability and the kill-switch:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }
Due limiti superiori sopra le impostazioni predefinite.
I due livelli sopra decidono le impostazioni predefinite. Due filtri decidono cosa è consentito oltre a ciò, e ciascuno restringe soltanto il piano risolto:
Disponibilità per paese. Il piano risolto di un paese include solo i canali che Bird offre effettivamente lì. Le opzioni di una richiesta possono riordinare o restringere quel piano; non possono aggiungere un canale che il paese non supporta, poiché la disponibilità è un'intersezione.
Kill-switch globale. Quando un provider ha un'interruzione, Bird può disattivare un canale ovunque contemporaneamente. Il piano risolto passa semplicemente al canale successivo, per poi ripristinarsi automaticamente quando il blocco viene rimosso.
Il piano è in ogni risposta.
Risolto per ogni verifica, restituito nella risposta.
- 01
Il piano risolto è nella risposta.
Ogni verifica riporta i canali ordinati a cui è stata risolta, quindi il piano risolto non è mai un mistero.
- 02
Il failover automatico esegue il piano al posto tuo.
Un canale che non riesce fa avanzare la verifica a quello successivo nel piano, e un timer di consegna per ogni tentativo la fa avanzare quando non arriva alcuno stato di consegna. Ogni codice nella sessione resta valido, così il destinatario può usare qualsiasi messaggio lo raggiunga. Puoi anche far avanzare una verifica su richiesta con una chiamata next-channel.
Mettilo in pratica.
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Il resto della piattaforma Verify
Un'unica API, un unico set di chiavi. Esplora le altre funzionalità.
Impostazioni predefinite per paese che non dovete costruire da soli.
Le impostazioni predefinite per paese sono una funzionalità di Bird Verify: i canali, il codice e i limiti sono inclusi, sulle stesse chiamate di creazione e verifica.