Voice OTP

Em implementação

Um código que se ouve, para os utilizadores que o SMS não alcança.

Configure em:
Cursor

A verificação por voz efetua uma chamada e lê o código de uso único em voz alta — para telefones fixos, para utilizadores que não conseguem receber SMS e como alternativa quando uma mensagem de texto não chega. Está a ser implementada como canal disponível no mesmo plano por país, endereçada pelo mesmo número de telefone e confirmada pela mesma verificação.

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

O canal que alcança os utilizadores quando o texto não consegue.

A voz é um canal da família telefónica na API Bird Verify: o destinatário é o mesmo número de telefone, e a voz torna-se uma entrada disponível no plano por país — normalmente como alternativa após SMS. Utilizadores apenas com telefone fixo, necessidades de acessibilidade e mercados onde o SMS tem baixa entrega são exatamente onde um código falado justifica o seu lugar.

O que a verificação por voz acrescenta.

Em implementação como canal no plano existente.

  1. 01

    Código falado e sintetizado.

    O código é lido em voz alta numa chamada, para que um utilizador que não consiga ler uma mensagem de texto, ou que não a tenha recebido, possa verificar-se na mesma.

  2. 02

    Alcança telefones fixos.

    A voz funciona em linhas que nunca recebem SMS, ampliando quem pode verificar sem uma integração separada.

  3. 03

    Uma alternativa natural ao SMS.

    Ordene a voz após o SMS no plano de canais para que, à medida que o avanço baseado na entrega for implementado, a sessão passe para uma chamada quando o texto não chegar.

  4. 04

    Mesmo destinatário, mesmas chamadas.

    Endereçe o mesmo número de telefone e chame os mesmos endpoints de criação e verificação. A voz é o canal, não uma API diferente.

  5. 05

    As mesmas garantias de código.

    Códigos gerados no servidor e com hash; comprimento e TTL configuráveis; verificação por destinatário, com todas as garantias dos outros canais.

A voz é uma entrada no plano.

Ordene a voz após o SMS na configuração e a chamada de criação mantém-se inalterada. À medida que o avanço baseado na entrega for implementado, a sessão usa a voz quando o canal anterior não se completa.

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

Como funciona a alternativa.

Ordene SMS primeiro e voz em segundo, e uma única verificação percorre o plano por ordem. O SMS é tentado; se não chegar, a sessão passa para uma chamada de voz que lê o código em voz alta, e todos os códigos da sessão permanecem válidos para que o utilizador possa usar o que o alcançar. O avanço automático baseado na entrega está em implementação com o estado de entrega.

FAQ sobre Voice OTP

A verificação por voz está disponível hoje?+
Está em implementação. A verificação por email, SMS e WhatsApp está disponível agora; a voz será adicionada como canal disponível no mesmo plano por país, sem alterações às chamadas de criação ou verificação.
Quando devo usar Voice OTP?+
A voz alcança telefones fixos e utilizadores que não conseguem receber SMS, e é uma alternativa forte quando uma mensagem de texto não chega. É também a opção mais acessível para utilizadores que não conseguem ler um código no ecrã.
Como é que a voz se integra com o SMS?+
Ambos são canais da família telefónica endereçados pelo mesmo número. Ordene-os no plano de canais (normalmente SMS primeiro, voz como alternativa) e uma única verificação pode transitar de um para o outro enquanto todos os códigos da sessão permanecem válidos.
De quem é que os meus utilizadores veem o código?+
Authifly, a marca de verificação do Bird. É a identidade em todos os códigos que os seus utilizadores recebem: o email chega de otp@verify.authifly.com ou do seu próprio domínio verificado, e o SMS e o WhatsApp têm a marca Authifly. authifly.com é uma página pública que garante aos destinatários que a Authifly envia códigos de uso único legítimos em nome de uma empresa. Bird é a plataforma sobre a qual constrói; Authifly é o que o destinatário vê.

Alcance todos os utilizadores, no canal que funciona.

A voz junta-se ao e-mail, SMS e WhatsApp como canal no mesmo plano por país — um fallback por voz nos mesmos dois endpoints.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor