WhatsApp OTP

En vista previa

Códigos de un solo uso, en WhatsApp.

Configúralo en:
Cursor

La verificación por WhatsApp envía el código como un mensaje de plantilla de autenticación a la cuenta de WhatsApp del usuario: enriquecido, con la marca Authifly y entregado en una app que ya usa. Es un canal configurable en el mismo plan por país, así que una verificación puede empezar con WhatsApp y mantener SMS en 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();

Un canal en el plan, no una nueva integración.

WhatsApp es un canal de la familia telefónica en la API de Bird Verify: el destinatario es el mismo número de teléfono, las llamadas de creación y verificación no cambian, y WhatsApp simplemente se convierte en una entrada configurable en el plan de canales por país. Lo ordenas por delante de SMS donde convierte, con SMS siguiente en el plan en el resto.

Qué aporta la verificación por WhatsApp.

Un canal configurable en el plan por país.

  1. 01

    Entrega con plantilla de autenticación.

    Los códigos se envían como mensajes de plantilla de autenticación de WhatsApp, el formato que la plataforma reserva para códigos de un solo uso.

  2. 02

    Mismo destinatario, mismas llamadas.

    Dirígete al mismo número de teléfono y usa los mismos endpoints de creación y verificación. WhatsApp es el canal, no una API diferente.

  3. 03

    Configurable por país.

    Coloca WhatsApp por delante de SMS en el plan de canales para los países donde mejor funciona, y deja el resto con SMS primero.

  4. 04

    SMS se mantiene en reserva.

    Un destino telefónico lleva consigo todo su plan de familia telefónica, así que SMS queda siguiente en la fila detrás de WhatsApp. A medida que se despliegue el avance por entrega, una verificación que empiece con WhatsApp pasa a SMS en la misma sesión.

  5. 05

    Las mismas garantías para los códigos.

    Códigos generados con una fuente aleatoria criptográfica y almacenados solo como HMAC; longitud y TTL configurables; verificación por destinatario. WhatsApp hereda todas las garantías que tienen los demás canales.

Empieza con WhatsApp, mantén SMS siguiente en la fila.

El orden de canales está en la configuración, así que elegir WhatsApp primero es un cambio de configuración, no de código. La llamada de creación sigue 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" }]

Preguntas frecuentes sobre WhatsApp OTP

¿La verificación por WhatsApp está disponible hoy?+
Sí. WhatsApp se lanza como canal junto con email y SMS: una entrada configurable en el plan por país, sin cambios en las llamadas de creación o verificación. Voz es el canal que aún se está desplegando.
¿Por qué verificar por WhatsApp en lugar de SMS?+
Los mensajes de plantilla de autenticación de WhatsApp tienen marca y llegan en una app que muchos usuarios ya mantienen abierta. En mercados con alto uso de WhatsApp, ordenarlo por delante de SMS te permite llegar a las personas en el canal que prefieren, con SMS aún en reserva.
¿Qué pasa si el usuario no tiene WhatsApp?+
Un destino telefónico lleva consigo todo su plan de canales de familia telefónica, así que SMS queda siguiente en la fila detrás de WhatsApp. A medida que se despliegue el avance por entrega, una verificación que empiece con WhatsApp pasa a SMS en la misma sesión, y cada código de esa sesión sigue siendo válido hasta que se verifica, expira o agota los intentos.
¿De quién ven mis usuarios que proviene el código?+
Authifly, la marca de verificación de Bird. Es la identidad en cada código que reciben tus usuarios: el email llega desde otp@verify.authifly.com o tu propio dominio verificado, y SMS y WhatsApp llevan la marca Authifly. authifly.com es una página pública que asegura a los destinatarios que Authifly envía códigos legítimos de un solo uso en nombre de un negocio. Bird es la plataforma sobre la que construyes; Authifly es lo que ve el destinatario.

Una API de verificación, en cada canal que usan tus usuarios.

WhatsApp se une al email y SMS como canal en el mismo plan por país — ordenado para maximizar conversiones, en los mismos dos endpoints.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor