WhatsApp OTP

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, enviada a partir de um número empresarial gerido pela Bird sob a identidade que escolher (Bird Verify por predefinição, ou Authifly), e entregue numa aplicação que já utilizam. É um canal que pode ser adicionado 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, error } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();
if (error) throw error;

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.

    Codes go as WhatsApp authentication-template messages, the format the platform reserves for one-time passcodes. WhatsApp templates covers how the category works.

  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.

Routing is configured for the workspace, and a create call follows whatever it resolved. Putting WhatsApp first happens at that level, so the create call is the same one-liner either way.

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

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

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 de forma a maximizar a conversão, 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