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

Die Sprachverifizierung 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. Sie wird als bestellbarer Kanal im selben länderspezifischen Plan ausgerollt, ü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 zu einem bestellbaren Eintrag im länderspezifischen Plan – in der Regel als Fallback nach SMS. Nutzer mit reinem Festnetzanschluss, 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 Sprachverifizierung hinzufügt.

Wird als Kanal im bestehenden Plan eingeführt.

  1. 01

    Gesprochener, synthetisierter Code.

    Der Code wird bei einem Anruf vorgelesen, sodass Nutzer, die keinen Text lesen können oder keinen erhalten, sich trotzdem verifizieren können.

  2. 02

    Erreicht Festnetzanschlüsse.

    Voice funktioniert auf Anschlüssen, die keine SMS empfangen – so können Sie mehr Nutzer verifizieren, ohne eine separate Integration.

  3. 03

    Ein natürlicher SMS-Fallback.

    Bestellen Sie Voice nach SMS im Kanalplan, sodass die Sitzung bei Einführung der zustellungsgesteuerten Weiterleitung zu einem Anruf wechselt, wenn die SMS nicht ankommt.

  4. 04

    Gleicher Empfänger, gleiche Aufrufe.

    Adressieren Sie dieselbe Telefonnummer und nutzen Sie dieselben Create- und Check-Endpunkte. Voice ist der Kanal, nicht eine andere API.

  5. 05

    Dieselben Code-Garantien.

    Serverseitig generierte, gehashte Codes; konfigurierbare Länge und TTL; Prüfung 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

So funktioniert der Fallback.

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.

BirdHarborOrganization
WorkspacesProductionSandbox

Delivery agent

API key · Customer operations team
Active
PermissionsAccess
EmailRead & write
SMSRead & write
ALAlex Lee AdminPermissions updated

Audit log

Production
Workspace
Production
Resource
Delivery agent
WhatsApp
ReadRead & write
Succeeded

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

Ihre nächste Idee.
Bereit zur Verbindung.