Voice OTP
W trakcie wdrażaniaKod, który można usłyszeć, dla użytkowników, do których SMS nie dociera.
Weryfikacja głosowa wykonuje połączenie i odczytuje kod jednorazowy na głos — dla telefonów stacjonarnych, użytkowników, którzy nie mogą odbierać SMS, oraz jako zapasowy kanał, gdy wiadomość tekstowa nie dotrze. Jest wdrażana jako zamawiany kanał w tym samym planie per kraj, adresowany tym samym numerem telefonu i potwierdzany tym samym wywołaniem check.
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();Kanał, który dociera do użytkowników, gdy wiadomość tekstowa nie może.
Głos to kanał z rodziny telefonicznej w Bird Verify API: odbiorca to ten sam numer telefonu, a głos staje się zamawianą pozycją w planie per kraj — zwykle jako zapasowy kanał po SMS. Użytkownicy wyłącznie stacjonarni, potrzeby związane z dostępnością i rynki, na których SMS zawodzi — to dokładnie tam, gdzie kod wypowiadany głosowo znajduje swoje zastosowanie.
Co wnosi weryfikacja głosowa.
Wdrażany jako kanał w istniejącym planie.
- 01
Kod wypowiadany przez syntezator mowy.
Kod jest odczytywany na głos podczas połączenia, więc użytkownik, który nie może przeczytać wiadomości tekstowej lub jej nie otrzymał, nadal może się zweryfikować.
- 02
Dociera do telefonów stacjonarnych.
Głos działa na liniach, które nigdy nie odbierają SMS, poszerzając grono osób, które możesz zweryfikować bez osobnej integracji.
- 03
Naturalny kanał zapasowy po SMS.
Zamów głos po SMS w planie kanałów, aby — gdy wdrożone zostanie awansowanie sterowane dostarczalnością — sesja przeszła do połączenia telefonicznego, gdy wiadomość tekstowa nie dotrze.
- 04
Ten sam odbiorca, te same wywołania.
Adresuj ten sam numer telefonu i wywołuj te same endpointy create i check. Głos to kanał, a nie inne API.
- 05
Te same gwarancje kodu.
Kody generowane po stronie serwera, haszowane; konfigurowalna długość i TTL; weryfikacja po odbiorcy, ze wszystkimi gwarancjami, jakie zapewniają pozostałe kanały.
Głos to pozycja w planie.
Zamów głos po SMS w konfiguracji, a wywołanie create pozostaje niezmienione. Gdy awansowanie sterowane dostarczalnością zostanie wdrożone, sesja użyje głosu, gdy kanał przed nim nie zakończy się powodzeniem.
await bird.verify.verifications.create({
configuration_id: "vfc_login",
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels: [{ channel: "sms" }, { channel: "voice" }]Jak działa mechanizm zapasowy.
Zamów SMS jako pierwszy, a głos jako drugi — pojedyncza weryfikacja realizuje plan po kolei. Najpierw próbowany jest SMS; jeśli nie dotrze, sesja przechodzi do połączenia głosowego, które odczytuje kod na głos, a każdy kod w sesji pozostaje ważny, więc użytkownik może skorzystać z tego, który do niego dotrze. Automatyczne awansowanie sterowane dostarczalnością jest wdrażane wraz ze statusem dostarczenia.
Voice OTP FAQ
Czy weryfikacja głosowa jest dostępna już dziś?+
Kiedy powinienem użyć Voice OTP?+
Jak głos współgra z SMS?+
Od kogo moi użytkownicy widzą kod?+
Reszta platformy Verify
Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.
Dotrzyj do każdego użytkownika kanałem, który działa.
Połączenia głosowe dołączają do e-maila, SMS i WhatsApp jako kanał w tym samym planie per kraj — głosowy fallback na tych samych dwóch endpointach.