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 jednorazowy kod na głos: dla telefonów stacjonarnych, dla użytkowników, którzy nie mogą odbierać SMS, oraz jako rozwiązanie awaryjne, gdy wiadomość tekstowa nie dotrze. Jest wdrażana jako zamawiany kanał w tym samym planie per kraj, przypisana do tego samego numeru telefonu i potwierdzana tym samym wywołaniem sprawdzającym.

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, error } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();
if (error) throw error;

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: odbiorcą jest ten sam numer telefonu, a kanał głosowy staje się zamawialną pozycją w planie per kraj, zazwyczaj jako rozwiązanie awaryjne po SMS. Użytkownicy wyłącznie stacjonarni, potrzeby związane z dostępnością i rynki, na których SMS zawodzi — to dokładnie miejsca, w których kod odczytywany 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.

Once voice ships, it slots into the plan the same way any other channel does, and the create call stays the same. As delivery-driven advancement rolls out, the session moves to voice when the channel ahead of it doesn't complete.

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

// resolved channels today: [{ channel: "sms" }] — voice joins as it rolls out

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.

Dotrzyj do każdego użytkownika kanałem, który działa.

Głos dołącza do e-maila, SMS i WhatsApp jako kanał w tym samym planie per kraj — głosowe rozwiązanie awaryjne 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