Kanalorchestrierung
Bird legt die Standards fest. Sie passen einen einzelnen Aufruf an.
Kanalverfügbarkeit, Absenderregeln und Vorschriften unterscheiden sich je nach Land, und sie korrekt umzusetzen ist jahrelange Arbeit. Bird liefert das als länderspezifische Basis: welche Kanäle wo funktionieren, welche Absender erlaubt sind und sinnvolle Code-Standards – abgeleitet aus dem Betrieb von E-Mail und SMS im großen Maßstab. Ein Create-Aufruf löst bereits den richtigen Plan für jedes Land auf, und das Options-Feld kann die Kanäle umordnen oder einschränken oder die Code-Länge für diese eine Verifizierung setzen.
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;
Ihr Konto
Bestätigen Sie Ihre Identität.
Geben Sie den Code ein, der gesendet wurde an
+1 ••• ••• 4567Beispiel-Bestätigungscode
Täglich vertraut von Teams, die erstklassige Software entwickeln
Weitere Kundenberichte lesenDie Standards von Bird begleiten jeden Aufruf.
Jede Verifizierung über die Bird Verify API wird gegen eine länderspezifische Basis aufgelöst, die Bird aus jahrelangem Betrieb von E-Mail und SMS pflegt – so wird eine Verifizierung in jedem Land sinnvoll geroutet, bevor Sie eine Zeile Code schreiben. Eine Per-Request-Option kann einen einzelnen Aufruf dennoch anpassen: Kanäle umordnen oder einschränken oder die Code-Länge setzen. Sie starten nie bei null.
Zwei Ebenen bestimmen den Plan.
Die spezifischere Ebene gewinnt; was ein Request nicht setzt, fällt auf die länderspezifische Basis von Bird zurück.
- 01
Optionen pro Anfrage.
Übergeben Sie channels oder code_length im Create-Aufruf, um die Kanäle umzuordnen oder einzuschränken oder die Code-Länge für diese eine Verifizierung zu setzen. Lassen Sie eines davon weg, gilt der Länderstandard.
- 02
Birds länderspezifische Basis.
Die eigenen länderspezifischen Standards von Bird, abgeleitet aus dem Betrieb von E-Mail und SMS im großen Maßstab: welche Kanäle verfügbar sind, welche Absender erlaubt sind und sinnvolle Code- und TTL-Standards. Was ein Request nicht überschreibt, wird daraus aufgelöst – so landet eine Verifizierung immer auf einem sinnvollen Plan.
Was eine Verifikation auflöst.
Eine brasilianische Nummer wird gegen die länderspezifische Basis von Bird für Brasilien aufgelöst, eingeschränkt durch etwaige Per-Request-Optionen im Aufruf. WhatsApp und SMS sind dort beide verfügbar, sodass die Verifizierung diesen geordneten Plan mit ihrer typisierten vrf_-ID zurückgibt.
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"
// }
Zwei Obergrenzen stehen über den Standards.
Die beiden Ebenen oben bestimmen die Standards. Zwei Schranken entscheiden, was darüber hinaus erlaubt ist, und jede schränkt den aufgelösten Plan nur ein:
Länderspezifische Verfügbarkeit. Der aufgelöste Plan eines Landes enthält nur Kanäle, die Bird dort tatsächlich anbietet. Die Optionen eines Requests können diesen Plan umordnen oder einschränken; sie können keinen Kanal hinzufügen, den das Land nicht unterstützt, da die Verfügbarkeit eine Schnittmenge ist.
Globaler Notschalter. Wenn ein Anbieter einen Vorfall hat, kann Bird einen Kanal überall gleichzeitig deaktivieren. Der aufgelöste Plan fällt einfach auf den nächsten Kanal zurück und stellt sich automatisch wieder her, wenn der Schalter aufgehoben wird.
Der Plan ist in jeder Antwort enthalten.
Pro Verifikation aufgelöst, in der Antwort zurückgegeben.
- 01
Der aufgelöste Plan ist in der Antwort enthalten.
Jede Verifizierung gibt die aufgelösten Kanäle in ihrer Reihenfolge zurück – der aufgelöste Plan ist nie ein Rätsel.
- 02
Automatisches Failover arbeitet den Plan für Sie ab.
Ein fehlgeschlagener Kanal rückt die Verifizierung zum nächsten Kanal im Plan vor, und ein Zustellungs-Timer pro Versuch rückt vor, wenn überhaupt kein Zustellstatus eintrifft. Jeder Code in der Sitzung bleibt gültig, sodass der Empfänger die Nachricht nutzen kann, die ihn zuerst erreicht. Sie können eine Verifizierung auch auf Abruf mit einem Next-Channel-Aufruf vorrücken.
In die Praxis umsetzen.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Die restliche Verify-Plattform
Eine API, ein Schlüsselsatz. Entdecken Sie die weiteren Funktionen.
Länderspezifische Standards, die Sie nicht selbst bauen müssen.
Länderspezifische Standards sind eine Funktion von Bird Verify: Kanäle, Code und Limits werden mitgeliefert, über dieselben Create- und Check-Aufrufe.