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.
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
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.
- 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.
- 02
Erreicht Festnetzanschlüsse.
Voice funktioniert auf Leitungen, die niemals SMS empfangen, und erweitert so den Kreis verifizierbarer Nutzer ohne separate Integration.
- 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.
- 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.
- 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.
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.
Die übrige Verify-Plattform
Eine API, ein Schlüsselsatz. Entdecken Sie die weiteren Funktionen.
Skalieren, ohne
die Kontrolle zu verlieren.
Organisieren Sie Teams in Workspaces, steuern Sie den API-Zugriff und verfolgen Sie Änderungen über Audit-Logs.
Audit-Protokoll
Produktion- Workspace
- Produktion
- Ressource
- Zustellagent
- LesezugriffLesen und Schreiben