Voice OTP
Wird eingeführtEin Code zum Hören, für 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.
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 lesenDer 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.
- 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.
- 02
Erreicht Festnetzanschlüsse.
Voice funktioniert auf Anschlüssen, die keine SMS empfangen – so können Sie mehr Nutzer verifizieren, ohne eine separate Integration.
- 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.
- 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.
- 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.
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.
In die Praxis umsetzen.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Der Rest der Verify-Plattform
Eine API, ein Schlüsselsatz. Entdecken Sie die weiteren Funktionen.
Erreichen Sie jeden Nutzer – über den Kanal, der ankommt.
Voice ergänzt E-Mail, SMS und WhatsApp als Kanal im selben länderspezifischen Plan – ein gesprochener Fallback über dieselben zwei Endpunkte.