Descripción general de Verify

Bird Verify confirma que un usuario controla una dirección de correo electrónico o un número de teléfono. Pide a Bird que envíe un código de verificación de un solo uso, recógelo en tu app y pregunta a Bird si coincide. El flujo usa dos llamadas API: POST /v1/verify/verifications envía el código y POST /v1/verify/verifications/check lo comprueba. Los remitentes compartidos de Bird no requieren registro de remitente ni configuración de plantilla. Email, SMS y WhatsApp pueden usar Bird Verify por defecto, Authifly o un remitente de tu espacio de trabajo; Telegram usa su propia cuenta de notificaciones verificada. Remitentes y personalización cubre la elección.

Creas una verificación con un destinatario: una dirección de correo electrónico, un número de teléfono o ambos. Bird genera un código de verificación numérico y lo entrega por los canales del destinatario. Una dirección de correo recibe el código por email; un número de teléfono lo recibe por SMS o WhatsApp, en el orden y la disponibilidad que tu configuración de país establece para el país de destino. El usuario escribe el código en tu aplicación y tú lo envías al endpoint de comprobación, que responde success: true o false con un motivo.

Una verificación recorre un ciclo de vida breve: comienza pending y termina verified (un código correcto llegó a tiempo), failed (demasiados intentos incorrectos) o expired (la ventana de tiempo expiró). La página Verifications muestra cada verificación y su estado; cada estado y motivo se detalla en Envío de verificaciones.

En el dashboard, Verify es una de las aplicaciones del espacio de trabajo. Sus páginas y dónde se encuentra la guía de cada una:

La página Verifications lista cada verificación en el espacio de trabajo y muestra el destinatario, el plan de canales y los detalles de tiempo de cada una. De forma programática, la respuesta de comprobación incluye el estado actual de la verificación. Suscríbete a los eventos de Verify para recibir actualizaciones de creación, entrega y verificación exitosa. Los endpoints de listado y lectura están disponibles para el dashboard, pero no para la API pública.

Verify entrega códigos por cuatro canales. El canal que recibe un destinatario depende del tipo de destinatario y, para números de teléfono, de tu configuración de país.

Para un destinatario telefónico, primero se intenta WhatsApp y SMS actúa como respaldo en la mayoría de los países, aunque algunos usan SMS primero por defecto. Telegram se ubica después de SMS y antes de email en el orden de respaldo de la plataforma. Puedes cambiar el orden o desactivar un canal por país. Si un envío falla, la entrega avanza al siguiente canal del plan. También puedes avanzarlo cuando un usuario reporta que el código no llegó; consulta Enviar el código por otro canal. Remitentes y marca muestra cada mensaje y los controles de remitente disponibles.

Tu espacio de trabajo comienza con los valores predeterminados de la plataforma de Bird para el código en sí (longitud, duración), el límite de intentos de comprobación y el tiempo de espera para reenvío. Cada uno se puede ajustar en el dashboard en Configure, y la longitud del código también por solicitud; los valores y rangos se encuentran en Configuración de verificación. Por encima de estos hay protecciones contra abuso que no configuras: límites de envío y comprobación por destinatario, listados en Protecciones contra abuso. El mensaje del código usa por defecto el idioma del número de teléfono del destinatario, una de 40 traducciones integradas, y options.language lo cambia por solicitud. Consulta Idioma del mensaje.