WhatsApp OTP

Em pré-visualização

Códigos únicos, no WhatsApp.

Configure em:
Cursor

A verificação por WhatsApp envia o código como uma mensagem de modelo de autenticação para a conta WhatsApp do utilizador — rica, com a marca Authifly e entregue numa app que já utilizam. É um canal configurável no mesmo plano por país, para que uma verificação possa começar pelo WhatsApp e manter o SMS em reserva.

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

Um canal no plano, não uma nova integração.

O WhatsApp é um canal da família telefónica na Bird Verify API: o destinatário é o mesmo número de telefone, as chamadas de criação e verificação permanecem iguais, e o WhatsApp simplesmente se torna uma entrada configurável no plano de canais por país. Coloca-o à frente do SMS onde converte, com o SMS a seguir no plano em todos os outros casos.

O que a verificação por WhatsApp acrescenta.

Um canal configurável no plano por país.

  1. 01

    Entrega por modelo de autenticação.

    Os códigos são enviados como mensagens de modelo de autenticação do WhatsApp — o formato que a plataforma reserva para códigos de uso único.

  2. 02

    Mesmo destinatário, mesmas chamadas.

    Envie para o mesmo número de telefone e utilize os mesmos endpoints de criação e verificação. O WhatsApp é o canal, não uma API diferente.

  3. 03

    Configurável por país.

    Coloque o WhatsApp à frente do SMS no plano de canais para os países onde funciona melhor, e deixe os restantes com SMS em primeiro.

  4. 04

    O SMS fica em reserva.

    Um alvo telefónico carrega todo o plano da família telefónica, por isso o SMS fica em segundo lugar atrás do WhatsApp. À medida que o avanço baseado em entrega é disponibilizado, uma verificação que começa pelo WhatsApp passa para SMS na mesma sessão.

  5. 05

    As mesmas garantias de código.

    Códigos gerados com uma fonte aleatória criptográfica e armazenados apenas como HMAC; comprimento e TTL configuráveis; verificação por destinatário. O WhatsApp herda todas as garantias dos outros canais.

Comece pelo WhatsApp, mantenha o SMS a seguir.

A ordem dos canais é definida na configuração, por isso escolher o WhatsApp primeiro é uma alteração de configuração, não de código. A chamada de criação permanece igual.

whatsapp-otp.ts
200
await bird.verify.verifications.create({
  configuration_id: "vfc_login",
  to: { phone_number: "+15551234567" },
}).safe();

// resolved channels: [{ channel: "whatsapp" }, { channel: "sms" }]

FAQ sobre WhatsApp OTP

A verificação por WhatsApp está disponível hoje?+
Sim. O WhatsApp é lançado como canal inicial ao lado do email e SMS — uma entrada configurável no plano por país, sem alterações às chamadas de criação ou verificação. A voz é o canal ainda em implementação.
Porquê verificar pelo WhatsApp em vez de SMS?+
As mensagens de modelo de autenticação do WhatsApp têm marca e chegam numa app que muitos utilizadores já mantêm aberta. Em mercados com forte utilização do WhatsApp, colocá-lo à frente do SMS permite alcançar as pessoas no canal que preferem, com o SMS ainda em reserva.
O que acontece se o utilizador não tiver WhatsApp?+
Um alvo telefónico carrega todo o plano de canais da família telefónica, por isso o SMS fica a seguir ao WhatsApp. À medida que o avanço baseado em entrega é disponibilizado, uma verificação que começa pelo WhatsApp passa para SMS na mesma sessão, e todos os códigos nessa sessão permanecem válidos até serem verificados, expirarem ou esgotarem as tentativas.
De quem os meus utilizadores veem o código?+
Authifly, a marca de verificação da Bird. É a identidade em cada código 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 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. A Bird é a plataforma onde desenvolve; a Authifly é o que o destinatário vê.

Uma API de verificação, todos os canais que os seus utilizadores preferem.

O WhatsApp junta-se ao email e SMS como canal no mesmo plano por país — ordenado da forma que converte, 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