Ein Code, den Sie hören können – für die Nutzer, die SMS nicht erreicht.

Voice-Verifizierung ruft an und liest den Einmalcode vor: für Festnetzanschlüsse, für Nutzer, die keine SMS empfangen können, und als Fallback, wenn eine Textnachricht nicht ankommt. Der Kanal wird als bestellbare Option im selben länderspezifischen Plan eingeführt, über dieselbe Telefonnummer adressiert und mit demselben Check bestätigt.

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

Ihr Konto

Bestätigen Sie Ihre Identität.

Geben Sie den Code ein, der gesendet wurde an

+1 ••• ••• 4567

Beispiel-Bestätigungscode

482691
Code verifiziert
Code senden. Empfänger bestätigen.

Der Kanal, der Nutzer erreicht, wenn Text es nicht kann.

Voice ist ein Telefoniekanal in der Bird Verify API: Der Empfänger ist dieselbe Telefonnummer, und Voice wird ein bestellbarer Eintrag im länderspezifischen Plan – in der Regel der Fallback nach SMS. Nutzer mit reinem Festnetz, Barrierefreiheitsanforderungen und Märkte, in denen SMS unzuverlässig zugestellt wird, sind genau die Fälle, in denen ein gesprochener Code seinen Platz verdient.

Was Voice-Verifizierung hinzufügt.

Wird als Kanal im bestehenden Plan eingeführt.

  1. 01

    Gesprochener, synthetisierter Code.

    Der Code wird bei einem Anruf vorgelesen, sodass ein Nutzer, der eine Textnachricht nicht lesen kann oder keine erhält, sich trotzdem verifizieren kann.

  2. 02

    Erreicht Festnetzanschlüsse.

    Voice funktioniert auf Leitungen, die niemals SMS empfangen, und erweitert so den Kreis verifizierbarer Nutzer ohne separate Integration.

  3. 03

    Ein natürlicher SMS-Fallback.

    Bestellen Sie Voice nach SMS im Kanalplan, sodass die Sitzung – wenn zustellungsbasiertes Weiterschalten eingeführt wird – zu einem Anruf wechselt, wenn die Textnachricht nicht ankommt.

  4. 04

    Derselbe Empfänger, dieselben Aufrufe.

    Adressieren Sie dieselbe Telefonnummer und verwenden Sie dieselben Create- und Check-Endpunkte. Voice ist der Kanal, keine andere API.

  5. 05

    Dieselben Code-Garantien.

    Serverseitig generierte, gehashte Codes; konfigurierbare Länge und TTL; Check nach Empfänger, mit allen Garantien, die auch die anderen Kanäle bieten.

Voice ist ein Eintrag im Plan.

Sobald Voice verfügbar ist, fügt es sich wie jeder andere Kanal in den Plan ein, und der Create-Call bleibt derselbe. Wenn die zustellungsgesteuerte Weiterleitung ausrollt, wechselt die Sitzung zu Voice, sobald der vorherige Kanal nicht erfolgreich abschließt.

voice-otp.ts
rolling out
await bird.verify.verifications.create({
  to: { phone_number: "+15551234567" },
}).safe();

// resolved channels today: [{ channel: "sms" }] — voice joins as it rolls out

Wie der Fallback funktioniert.

Ordnen Sie SMS an erster und Voice an zweiter Stelle an, und eine einzelne Verifizierung arbeitet den Plan der Reihe nach ab. SMS wird versucht; kommt die Nachricht nicht an, wechselt die Sitzung zu einem Sprachanruf, der den Code vorliest, und jeder Code in der Sitzung bleibt gültig, sodass der Nutzer den verwenden kann, der ihn zuerst erreicht. Diese Weiterleitung erfolgt automatisch bei den heute verfügbaren Kanälen: Ein fehlgeschlagener Kanal schiebt die Sitzung weiter, und ein Zustellungstimer pro Versuch schiebt sie weiter, wenn kein Zustellungsstatus eintrifft. Voice wird als anordenbarer Kanal in den Plan aufgenommen, sobald es verfügbar ist.

Skalieren, ohne
die Kontrolle zu verlieren.

Organisieren Sie Teams in Workspaces, steuern Sie den API-Zugriff und verfolgen Sie Änderungen über Audit-Logs.

BirdHarborOrganisation
ArbeitsbereicheProduktionSandbox

Zustellagent

API-Schlüssel · Team Kundenbetrieb
Aktiv
BerechtigungenZugriff
E-MailLesen und Schreiben
SMSLesen und Schreiben
ALAlex Lee AdministratorBerechtigungen aktualisiert

Audit-Protokoll

Produktion
Workspace
Produktion
Ressource
Zustellagent
WhatsApp
LesezugriffLesen und Schreiben
Erfolgreich

Starten Sie mit Verify.
Kanalübergreifend entwickeln mit Bird.

Ihre nächste Idee. Bereit zur Verbindung.