Voice OTP

Wird eingeführt

Ein Code zum Hören, für Nutzer, die SMS nicht erreicht.

Einrichtung in:
Cursor

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 Nachricht nicht ankommt. Sie wird als bestellbarer Kanal 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 } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

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

Voice ist ein Telefon-Kanal 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 ist, 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.

Bestellen Sie Voice nach SMS in der Konfiguration – der Create-Aufruf bleibt unverändert. Bei Einführung der zustellungsgesteuerten Weiterleitung nutzt die Sitzung Voice, wenn der vorherige Kanal nicht erfolgreich ist.

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

// resolved channels: [{ channel: "sms" }, { channel: "voice" }]

So funktioniert der Fallback.

Bestellen Sie SMS an erster und Voice an zweiter Stelle, und eine einzelne Verifizierung arbeitet den Plan der Reihe nach ab. SMS wird versucht; kommt sie nicht an, wechselt die Sitzung zu einem Sprachanruf, der den Code vorliest. Jeder Code in der Sitzung bleibt gültig, sodass Nutzer den verwenden können, der sie erreicht. Automatische, zustellungsgesteuerte Weiterleitung wird mit Zustellstatus eingeführt.

Voice OTP FAQ

Ist Sprachverifizierung heute verfügbar?+
Sie wird eingeführt. E-Mail-, SMS- und WhatsApp-Verifizierung sind bereits verfügbar; Voice kommt als zusätzlicher bestellbarer Kanal im selben länderspezifischen Plan hinzu – ohne Änderung an den Create- oder Check-Aufrufen.
Wann sollte ich Voice OTP verwenden?+
Voice erreicht Festnetzanschlüsse und Nutzer, die keine SMS empfangen können, und ist ein starker Fallback, wenn eine Nachricht nicht ankommt. Außerdem ist es die barrierefreiere Option für Nutzer, die einen Code auf dem Bildschirm nicht lesen können.
Wie passt Voice zu SMS?+
Beide sind Telefon-Kanäle, die über dieselbe Nummer adressiert werden. Ordnen Sie sie im Kanalplan an (üblicherweise SMS zuerst, Voice als Fallback), und eine einzelne Verifizierung kann von einem zum anderen wechseln, während jeder Code in der Sitzung gültig bleibt.
Von wem sehen meine Nutzer den Code?+
Authifly, die Verifizierungsmarke von Bird. 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 im Auftrag eines Unternehmens legitime Einmalcodes versendet. Bird ist die Plattform, auf der Sie aufbauen; Authifly ist das, was der Empfänger sieht.

Erreichen Sie jeden Nutzer – über den Kanal, der ankommt.

Voice ergänzt E-Mail, SMS und WhatsApp als Kanal im selben länderspezifischen Tarif – ein gesprochener Fallback über dieselben zwei Endpunkte.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:

Cursor