Voice OTP

W trakcie wdrażania

Kod, który można usłyszeć, dla użytkowników, do których SMS nie dociera.

Konfiguracja w:
Cursor

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.

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();

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.

  1. 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ć.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

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" }]

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ś?+
Jest w trakcie wdrażania. Weryfikacja przez e-mail, SMS i WhatsApp jest dostępna teraz; głos pojawi się jako dodatkowy zamawiany kanał w tym samym planie per kraj, bez zmian w wywołaniach create i check.
Kiedy powinienem użyć Voice OTP?+
Głos dociera do telefonów stacjonarnych i użytkowników, którzy nie mogą odbierać SMS, a także stanowi silny kanał zapasowy, gdy wiadomość tekstowa nie dotrze. To również bardziej dostępna opcja dla użytkowników, którzy nie mogą odczytać kodu na ekranie.
Jak głos współgra z SMS?+
Oba to kanały z rodziny telefonicznej adresowane tym samym numerem. Zamów je w planie kanałów (zazwyczaj SMS pierwszy, głos jako zapasowy), a pojedyncza weryfikacja może przejść z jednego na drugi, podczas gdy każdy kod w sesji pozostaje ważny.
Od kogo moi użytkownicy widzą kod?+
Authifly, marka weryfikacyjna Bird. To tożsamość na każdym kodzie, który otrzymują Twoi użytkownicy: e-mail przychodzi z otp@verify.authifly.com lub Twojej własnej zweryfikowanej domeny, a SMS i WhatsApp mają branding Authifly. authifly.com to publiczna strona, która zapewnia odbiorców, że Authifly wysyła prawdziwe kody jednorazowe w imieniu firmy. Bird to platforma, na której budujesz; Authifly to to, co widzi odbiorca.

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.

Zacznij od jednego kanału.
Dodaj kolejne, gdy będziesz gotowy.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i weryfikacji nadawcy.

Używasz Claude Code, Cursor lub Codex? Skopiuj prompt konfiguracyjny, a Twój agent zainstaluje za Ciebie Bird CLI i umiejętności. Wybierz swój:

Cursor