Registro de Verify
El Verify log, que aparece en la página Verifications en Verify > Verifications, es el registro de cada sesión de verificación de tu espacio de trabajo. Las verificaciones más recientes aparecen primero. Úsalo para confirmar que se creó una verificación, seguir cada intento y comprobación por canal, y revisar el tiempo de conversión y el coste de cada intento. El código de verificación de un solo uso generado nunca se almacena en texto plano ni se muestra en el panel.
La lista de verificaciones
Cada fila es una sesión de verificación. Las columnas son:
| Columna | Qué muestra |
|---|---|
| Status | El estado actual de la sesión (Pending, Converted, Failed, Expired, Canceled o Blocked; consulta Estados) |
| Verification | El ID de la verificación (vrf_...) |
| Recipient | El número de teléfono o la dirección de correo electrónico que se verifica |
| Channel | El canal de entrega usado en el último intento (Email, SMS, WhatsApp, Telegram o Voice) |
| Cost | Importe total cobrado por todos los intentos de entrega de la sesión |
| Created | Cuándo se creó la verificación |
La lista muestra 25 verificaciones por página.
Buscar y filtrar
La página ofrece una búsqueda por destinatario y tres filtros sobre una línea temporal de volumen. Los filtros se combinan para acotar la lista:
- Search by phone number: busca un número de teléfono de destinatario exacto en formato E.164, como
+14155550100. - Status: filtra por Pending, Converted (
verified), Failed o Expired. - Channel: filtra por canal de entrega (
Email,SMS,WhatsApp,TelegramoVoice). - Date range: elige un intervalo predefinido o selecciona un rango personalizado en el calendario o en la franja de la línea de tiempo.
Si ninguna verificación coincide con los filtros activos, usa Clear filters para restablecer la vista.
Estados
Una verificación empieza en Pending (pending) y pasa una sola vez a un estado final:
| Etiqueta del panel | API status | Significado |
|---|---|---|
| Pending | pending | La verificación está activa y espera una comprobación con el código de verificación correcto antes de expires_at |
| Converted | verified | Una llamada de comprobación proporcionó el código correcto antes de que caducara |
| Failed | failed | La sesión agotó los intentos de comprobación permitidos (attempts_exhausted) o la entrega falló en todos los canales |
| Expired | expired | La vigencia del código terminó (ttl_elapsed) sin una comprobación correcta y sin que se agotaran los intentos |
| Canceled | canceled | La sesión se canceló antes de completarse |
| Blocked | blocked | Una comprobación de seguridad o de políticas bloqueó la verificación |
Para saber cómo interactúan las transiciones de estado y los motivos finales con los reenvíos y el canal de respaldo, consulta Envío de verificaciones.
Inspeccionar una verificación
Selecciona cualquier fila para abrir el panel de detalles de la verificación. El panel organiza la sesión en tres secciones:
Resumen
La cabecera del resumen registra el resultado y la configuración de la sesión:
- Outcome: en una sesión convertida, el tiempo que tardó la conversión (
Converted in) y qué intento de comprobación coincidió (por ejemplo,Code matched on 1st check). En una sesión fallida, el número de comprobaciones fallidas. - Code: la longitud de dígitos y el plazo de caducidad configurados para la sesión.
- Channels used: todos los canales que intentaron la entrega durante la sesión.
- Metadata: los pares clave-valor que pasaste en
metadataal crear la verificación.
Cronología del ciclo de vida
La cronología ordena cada paso de la sesión, desde su creación hasta su resolución:
- Channel attempts: cada envío del código de verificación (
SMS,WhatsApp,Telegram,VoiceoEmail), su remitente, el resultado de la entrega (sent,deliveredoundeliveredcon el motivo del error), el tiempo de entrega transcurrido y el coste de cada intento. Mientras la sesión está pendiente, los canales de respaldo previstos que aún no se han activado aparecen como pasos próximos. - Code checks: cada llamada a
POST /v1/verify/verifications/checky si el código coincidió. - Terminal state: el momento en que la sesión alcanzó su estado final.
Desglose de costes
Cuando una sesión tiene intentos cobrados, Cost breakdown agrupa los cargos por canal y por clase de remitente (Shared sender, Custom domain, Dedicated sender o Managed sender) junto al Total de la sesión en la moneda de tu espacio de trabajo.
La lista de verificaciones y las vistas de detalle solo están disponibles en el panel y no tienen ningún endpoint API público de listado o lectura. Para seguir mediante programación la creación de verificaciones, la entrega de cada intento y la conversión, usa la respuesta de comprobación síncrona y suscríbete a los eventos de Verify.
Próximos pasos
- Eventos de Verify: recibe entregas de webhook para los eventos
verify.verification.*yverify.attempt.*. - Enviar verificaciones: configura la vigencia del código, los límites de intentos, los reenvíos y el respaldo entre varios canales.
- Destinos de Verify: habilita los países de destino y personaliza el orden de respaldo de canales.
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.