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;
Les 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 est en cours de déploiement.
La progression pilotée par la livraison dans le plan (essayer le canal suivant lorsqu'un canal n'aboutit pas) est en cours de déploiement à mesure que le statut de livraison arrive. Le plan est d'ores et déjà résolu et renvoyé aujourd'hui.
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.