Orchestration des canaux
Bird définit les paramètres par défaut. Vous ajustez un seul appel.
La disponibilité des canaux, les règles d'expéditeurs et les réglementations varient selon les pays, et les maîtriser demande des années de travail. Bird intègre tout cela dans une base par pays : quels canaux fonctionnent où, quels expéditeurs sont autorisés et des paramètres de code pertinents, issus de l'exploitation de l'e-mail et du SMS à grande échelle. Un appel de création résout déjà le bon plan pour n'importe quel pays, et son champ d'options peut réorganiser ou restreindre les canaux, ou définir la longueur du code pour cette vérification.
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;
Your account
Confirm it’s you.
Enter the code sent to
+1 ••• ••• 4567Example verification code
Des équipes qui créent des logiciels de classe mondiale nous font confiance au quotidien
Découvrir plus de témoignages clientsLes paramètres par défaut de Bird accompagnent chaque appel.
Chaque vérification sur l<hub>API Bird Verify</hub> est résolue selon une base par pays que Bird maintient grâce à des années dexploitation de l'e-mail et du SMS. Ainsi, une vérification est déjà acheminée de manière pertinente dans chaque pays avant même que vous n'écriviez une ligne de code. Une option par requête peut toujours ajuster un appel individuel : réorganiser ou restreindre les canaux, ou définir la longueur du code. Vous ne partez jamais de zéro.
Deux couches déterminent le plan.
La plus spécifique l'emporte ; tout ce qu'une requête ne définit pas est hérité de la base par pays de Bird.
- 01
Options par requête.
Transmettez channels ou code_length dans l'appel de création pour réorganiser ou restreindre les canaux, ou définir la longueur du code, pour cette vérification. Omettez l'un ou l'autre et le paramètre par défaut du pays s'applique.
- 02
La base par pays de Bird.
Les paramètres par défaut par pays de Bird, issus de l'exploitation de l'e-mail et du SMS à grande échelle : quels canaux sont disponibles, quels expéditeurs sont autorisés, et des paramètres de code et de TTL pertinents. Tout ce qu'une requête ne remplace pas est résolu à partir de cette base, de sorte qu'une vérification aboutit toujours à un plan pertinent.
Ce qu'une vérification résout.
Un numéro brésilien est résolu selon la base par pays de Bird pour le Brésil, affinée par les options par requête de l'appel. WhatsApp et SMS y sont tous deux disponibles, la vérification renvoie donc ce plan ordonné, avec son identifiant typé 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"
// }
Deux garde-fous s'appliquent au-dessus des paramètres par défaut.
Les deux couches ci-dessus déterminent les paramètres par défaut. Deux filtres décident de ce qui est autorisé en plus, et chacun ne fait que restreindre le plan résolu :
Disponibilité par pays. Le plan résolu d'un pays n'inclut que les canaux que Bird propose effectivement dans ce pays. Les options d'une requête peuvent réorganiser ou restreindre ce plan ; elles ne peuvent pas ajouter un canal non supporté par le pays, car la disponibilité fonctionne par intersection.
Interrupteur d'urgence global. Lorsqu'un fournisseur subit un incident, Bird peut retirer un canal partout à la fois. Le plan résolu bascule simplement sur le canal suivant, puis se rétablit automatiquement lorsque l'interrupteur est levé.
Le plan figure dans chaque réponse.
Résolu par vérification, renvoyé dans la réponse.
- 01
Le plan résolu figure dans la réponse.
Chaque vérification indique les canaux ordonnés vers lesquels elle a été résolue, le plan résolu n'est donc jamais un mystère.
- 02
Le basculement automatique suit le plan à votre place.
Un canal en échec fait passer la vérification au suivant dans le plan, et un minuteur de livraison par tentative la fait avancer lorsqu'aucun statut de livraison n'est reçu. Chaque code de la session reste valide, permettant au destinataire d'utiliser le message qui lui parvient en premier. Vous pouvez également faire avancer une vérification à la demande via un appel de canal suivant.
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Le reste de la plateforme Verify
Une API, un jeu de clés. Découvrez les autres fonctionnalités.
Des paramètres par pays que vous n'avez pas à construire vous-même.
Les paramètres par pays sont une fonctionnalité de Bird Verify : les canaux, le code et les limites sont intégrés, sur les mêmes appels de création et de vérification.