Kanalorchestrierung

In der Vorschau

Starten Sie mit unseren Standardwerten. Überschreiben Sie nur, was Sie brauchen.

Einrichtung in:

Kanalverfügbarkeit, Absenderregeln und Vorschriften unterscheiden sich je nach Land — und sie korrekt umzusetzen ist jahrelange Arbeit. Bird liefert das als länderspezifische Basiskonfiguration: welche Kanäle wo ankommen, welche Absender erlaubt sind und sinnvolle Code-Standardwerte. Ihre Einstellungen werden darüber gelegt. Sie ändern eine Sache für ein Land; alles, was Sie nicht anpassen, fällt auf die darunterliegende Ebene durch. Das ist länderspezifisches Routing als erstklassige API-Ressource — die Kontrolle, die Ihnen die meisten Verifikations-APIs nicht bieten.

verify.ts

200 · pending

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 } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

verify.ts

200 · pending

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 } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

Sie übernehmen Birds Standardwerte und bauen darauf auf.

Jede Verifikation über die Bird Verify API löst ihre Einstellungen über eine Kaskade auf. Ganz unten steht eine länderspezifische Basis, die Bird aus jahrelangem Betrieb von E-Mail und SMS pflegt — bevor Sie also irgendetwas konfigurieren, wird eine Verifikation in jedem Land bereits sinnvoll geroutet. Ihre Konfiguration und länderspezifischen Überschreibungen werden darüber gelegt, und eine Option pro Anfrage kann einen einzelnen Aufruf anpassen. Sie starten nie bei null und verantworten nur die Entscheidungen, die Sie tatsächlich treffen möchten.

Die Wertekaskade.

Die höchste Ebene, die einen Wert setzt, gewinnt; alles, was Sie nicht setzen, fällt auf die darunterliegende Ebene durch.

01
Optionen pro Anfrage.
Felder im Erstellungsaufruf (Code-Länge, Kanalpräferenz, Sprache) gewinnen für diese eine Verifikation. Die leichteste, lokalste Überschreibung.
02
Ihre länderspezifischen Überschreibungen.
Ändern Sie die Kanalreihenfolge oder einen Absender für ein Land. Eine Überschreibung wird zusammengeführt: Sie betrifft die Felder, die Sie setzen, und der Rest dieses Landes erbt weiterhin von unten.
03
Ihre Konfigurations-Standardwerte.
Ihr anwendungsweiter Plan und Ihre Code-Regeln — Kanalreihenfolge, Code-Länge, TTL und Versuche, die überall gelten, wo Sie keine länderspezifische Überschreibung gesetzt haben.
04
Birds länderspezifische Basis.
Die unterste Ebene: Birds eigene länderspezifische Standardwerte, gewonnen aus dem Betrieb von E-Mail und SMS im großen Maßstab. Was Sie nicht setzen, fällt hierauf durch — so wird eine Verifikation immer zu einem sinnvollen Plan aufgelöst.

Überschreiben Sie ein Land, erben Sie den Rest.

Legen Sie Ihren Plan einmal fest und passen Sie dann nur die Länder an, die etwas anderes brauchen. Hier führt Brasilien mit WhatsApp, dann SMS; jedes andere Land fällt weiterhin auf Ihre Standardwerte und Birds Basis durch.

orchestration.ts

200

// Your app-wide default plan.
await bird.verify.verifications.configurations.update("vfc_login", {
  channels: [
    { channel: "email", state: "enabled" },
    { channel: "sms", state: "enabled" },
  ],
}).safe();

// Override one country; the rest inherits.
await bird.verify.verifications.configurations.countries.upsert("vfc_login", "BR", {
  channels: [
    { channel: "whatsapp", state: "enabled" },
    { channel: "sms", state: "enabled" },
  ],
}).safe();

Was eine Verifikation auflöst.

Eine brasilianische Nummer unter dieser Konfiguration wird über die Kaskade aufgelöst. Die BR-Überschreibung ordnet WhatsApp vor SMS, beide sind verfügbar, und die Verifikation meldet den aufgelösten, geordneten Plan mit ihrer typisierten vrf_-ID zurück.

resolved.ts

200

const { data } = await bird.verify.verifications.create({
  configuration_id: "vfc_login",
  to: { phone_number: "+5511998765432" }, // Brazil
}).safe();

// Resolved through the cascade + availability/kill-switch ceilings:
// {
//   id:           "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
//   status:       "pending",
//   channels:     [{ channel: "whatsapp" }, { channel: "sms" }],
//   last_channel: "whatsapp"
// }

Zwei Obergrenzen stehen über der Kaskade.

Die Kaskade bestimmt Standardwerte. Zwei Tore bestimmen, was erlaubt ist — sie begrenzen den aufgelösten Plan, anstatt Werte zu liefern, die durchfallen:

Länderspezifische Verfügbarkeit. Sie können nur Kanäle aktivieren, die Bird in einem Land tatsächlich anbietet. Einen zu aktivieren, den wir dort nicht unterstützen, ist ein No-Op, kein stiller Fehler — Verfügbarkeit ist eine Schnittmenge, niemals eine Überschreibung.

Globaler Kill-Switch. Wenn ein Anbieter einen Vorfall hat, kann Bird einen Kanal überall gleichzeitig deaktivieren. Ihre Konfiguration wird nicht verändert; der aufgelöste Plan fällt einfach auf den nächsten Kanal zurück und wird wiederhergestellt, wenn der Switch aufgehoben wird.

Routing, das Sie selbst festlegen — kein Ticket, das Sie einreichen.

Pro Verifikation aufgelöst, in der Antwort zurückgegeben.

01
Länderspezifische Routen, anhand der Nummer.
Das Land wird aus der E.164-Nummer des Empfängers abgeleitet — Sie übergeben es nicht. Legen Sie eine Route für ein Land fest, und sie überschreibt Reihenfolge und Absender dort.
02
Kanäle ein- und ausschalten.
Jeder Kanal hat einen Aktiviert/Deaktiviert-Status, sodass Sie einen für ein Land abschalten können, ohne seine Position im Plan zu verlieren.
03
Der aufgelöste Plan ist in der Antwort enthalten.
Jede Verifikation meldet die geordneten Kanäle, zu denen sie aufgelöst wurde — was die Kaskade entschieden hat, ist nie ein Rätsel.
04
Automatisches Failover wird ausgerollt.
Zustellungsbasiertes Fortschreiten durch den Plan (Versuch des nächsten Kanals, wenn einer nicht ankommt) wird mit dem Eintreffen des Zustellstatus ausgerollt. Der Plan wird bereits heute aufgelöst und zurückgegeben.

FAQ zur Kanalorchestrierung

Was ist die Konfigurationskaskade?+

So werden die Einstellungen einer Verifizierung aufgelöst: zuerst Optionen pro Anfrage, dann Ihre länderspezifischen Überschreibungen, dann Ihre Konfigurationsstandards, dann Bird's länderspezifische Basis. Die höchste Ebene, die einen Wert setzt, gewinnt – und alles, was Sie nicht festlegen, fällt auf die darunterliegende Ebene durch. So konfigurieren Sie nur das, was Sie ändern möchten.

Was bietet mir Bird's länderspezifische Basis?+

Einen sinnvollen Ausgangspunkt in jedem Land ohne jegliches Setup: welche Kanäle einen Versuch wert sind, welche Absender erlaubt sind und vernünftige Code-Standardwerte – gepflegt von Bird aus jahrelanger Erfahrung mit E-Mail und SMS. Sie bauen darauf auf, statt alles selbst herauszufinden.

Ersetzt eine länderspezifische Überschreibung den gesamten Plan?+

Nein – sie wird zusammengeführt. Sie setzen nur die Felder, die für dieses Land abweichen, und der Rest wird weiterhin von Ihrer Konfiguration und Bird's Basis geerbt. Eine Überschreibung ist also eine kleine, gezielte Änderung statt einer vollständigen Neuspezifikation.

Kann ich einen Kanal aktivieren, den Bird in einem Land nicht anbietet?+

Nein. Die länderspezifische Verfügbarkeit ist eine Obergrenze, kein Standard: Sie können nur aktivieren, was Bird dort unterstützt. Das Aktivieren eines nicht verfügbaren Kanals ist ein No-Op statt eines stillen Fehlers – ein Plan kann also nie einen Kanal versprechen, der tatsächlich nicht senden kann.

Wie wird das Land bestimmt?+

Anhand der E.164-Telefonnummer des Empfängers zum Zeitpunkt der Auflösung. Sie übergeben kein Land; Bird leitet es ab und wendet die passende Route an. E-Mail ist länderunabhängig.

Von wem sehen meine Nutzer den Code?+

Von Authifly, Bird's Verifizierungsmarke. Sie ist die Identität auf jedem Code, den Ihre Nutzer erhalten: E-Mails kommen von otp@verify.authifly.com oder Ihrer eigenen verifizierten Domain, und SMS sowie WhatsApp tragen das Authifly-Branding. authifly.com ist eine öffentliche Seite, die Empfängern versichert, dass Authifly legitime Einmalcodes im Auftrag eines Unternehmens versendet. Bird ist die Plattform, auf der Sie aufbauen; Authifly ist das, was der Empfänger sieht.

Die restliche Verify-Plattform

Eine API, ein Schlüsselsatz. Entdecken Sie die weiteren Funktionen.

SMS OTPEinmalpasscodes per SMS mit globaler Reichweite und integrierten Ratenlimits.E-Mail OTPVerifizierung per E-Mail über das Netzwerk, das bereits Ihre Transaktionsmails transportiert.WhatsApp OTPCodes über WhatsApp als anordenbarer Kanal im selben Plan.Voice OTPIn Einführung: ein gesprochener Code für Festnetzanschlüsse und schwer erreichbare Nutzer.Missbrauchsschutz & Code-SicherheitGehashte Codes, Limits pro Empfänger, Sperrung nach Fehlversuchen und die Betrugsschutz-Roadmap.Verify API – ÜbersichtDie vollständige Verify API: Erstellen-oder-Wiederholen, Prüfung nach Ziel und länderspezifische Konfiguration.

Die länderspezifische Kontrolle, die Ihnen keine andere Verifizierungs-API bietet.

Orchestrierung ist eine Funktion von Bird Verify: Kanäle, Code und Limits sind enthalten – auf denselben zwei Endpunkten.

Entdecken Sie die Verify-Plattform Jetzt starten