Orquestación de canales
Bird decide los valores predeterminados. Tú ajustas una sola llamada.
La disponibilidad de canales, las reglas de remitentes y las regulaciones varían según el país, y configurarlas correctamente lleva años de trabajo. Bird lo incluye como una base por país: qué canales funcionan en cada lugar, qué remitentes están permitidos y valores predeterminados de código razonables, derivados de operar email y SMS a gran escala. Una llamada de creación ya resuelve el plan correcto para cualquier país, y su campo de opciones puede reordenar o reducir los canales o establecer la longitud del código para esa verificación específica.
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;
Tu cuenta
Confirma que eres tú.
Ingresa el código enviado a
+1 ••• ••• 4567Código de verificación de ejemplo
Equipos que crean software de primer nivel confían en nosotros cada día
Leer más historias de clientesLos valores predeterminados de Bird acompañan cada llamada.
Cada verificación en la API Bird Verify se resuelve contra una base por país que Bird mantiene a partir de años operando email y SMS, por lo que una verificación ya se enruta correctamente en cada país antes de que escribas una línea de código. Una opción por solicitud aún puede ajustar una llamada individual: reordenar o reducir los canales, o establecer la longitud del código. Nunca empiezas desde cero.
Dos capas deciden el plan.
La más específica prevalece; lo que una solicitud no defina se hereda de la base por país de Bird.
- 01
Opciones por solicitud.
Pasa channels o code_length en la llamada de creación para reordenar o reducir los canales, o establecer la longitud del código, para esa verificación específica. Omite cualquiera de los dos y se aplica el valor predeterminado del país.
- 02
Base por país de Bird.
Los valores predeterminados por país propios de Bird, derivados de operar email y SMS a gran escala: qué canales están disponibles, qué remitentes están permitidos y valores predeterminados razonables de código y TTL. Lo que una solicitud no sobreescriba se resuelve desde aquí, por lo que una verificación siempre aterriza en un plan coherente.
Lo que resuelve una verificación.
Un número brasileño se resuelve contra la base por país de Bird para Brasil, ajustado por cualquier opción por solicitud en la llamada. WhatsApp y SMS están disponibles allí, por lo que la verificación reporta ese plan ordenado, con su id vrf_ tipado.
const { data, error } = await bird.verify.verifications.create({
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
if (error) throw error;
// Resolved from the per-country base, capped by availability and the kill-switch:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }
Dos límites se sitúan por encima de los valores predeterminados.
Las dos capas anteriores deciden los valores predeterminados. Dos filtros deciden qué está permitido además de eso, y cada uno solo reduce el plan resuelto:
Disponibilidad por país. El plan resuelto de un país solo incluye canales que Bird realmente ofrece allí. Las opciones de una solicitud pueden reordenar o reducir ese plan; no pueden añadir un canal que el país no soporte, ya que la disponibilidad es una intersección.
Interruptor de emergencia global. Cuando un proveedor tiene una incidencia, Bird puede retirar un canal en todas partes a la vez. El plan resuelto simplemente recurre al siguiente canal y se restaura automáticamente cuando el interruptor se restablece.
El plan está en cada respuesta.
Resuelto por verificación, devuelto en la respuesta.
- 01
El plan resuelto está en la respuesta.
Cada verificación reporta los canales ordenados a los que se resolvió, por lo que el plan resuelto nunca es un misterio.
- 02
La conmutación automática por error ejecuta el plan por ti.
Un canal que falla avanza la verificación al siguiente en el plan, y un temporizador de entrega por intento la avanza cuando no se recibe ningún estado de entrega. Cada código de la sesión sigue siendo válido, para que el destinatario pueda usar el mensaje que le llegue primero. También puedes avanzar una verificación a demanda con una llamada de siguiente canal.
Ponlo en práctica.
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
El resto de la plataforma Verify
Una API, un conjunto de claves. Explora las demás capacidades.
Valores predeterminados por país que no tienes que construir tú mismo.
Los valores predeterminados por país son una capacidad de Bird Verify: los canales, el código y los límites vienen incluidos, en las mismas llamadas de creación y verificación.