Primeros pasos
Flujo de verificación de teléfono
El flujo de verificación de teléfono envía un OTP de 6 caracteres alfanuméricos al número del usuario. El código tiene una vigencia de 10 minutos. El usuario puede recibirlo por SMS (variante principal) o por llamada telefónica (variante alternativa).
Variante SMS
Variante llamada telefónica
Cuando el usuario no recibe el SMS o prefiere verificar por llamada.
Pasos del flujo
SMS
| Paso | Servicio | Endpoint | Descripción |
|---|---|---|---|
| 1 | Adamo ID API | GET /flow-runs/verify/{invitationToken} | Verifica el token de invitación y obtiene la configuración del flujo |
| 2 | Adamo ID API | POST /flow-runs/start | Inicia la ejecución del flujo y obtiene el authToken y runUuid |
| 3 | Adamo ID API | POST /verifications/phone-verification | Genera el OTP y lo envía por SMS |
| 4 | Queue Service | POST /phone/verify-code | Valida el OTP ingresado y registra el resultado (callMade: false) |
Llamada telefónica
| Paso | Servicio | Endpoint | Descripción |
|---|---|---|---|
| 1 | Adamo ID API | GET /flow-runs/verify/{invitationToken} | Verifica el token de invitación y obtiene la configuración del flujo |
| 2 | Adamo ID API | POST /flow-runs/start | Inicia la ejecución del flujo y obtiene el authToken y runUuid |
| 3 | Queue Service | POST /phone/send-code-to-verify-by-call | Realiza la llamada telefónica y dicta el código al usuario |
| 4 | Queue Service | POST /phone/verify-code | Valida el código recibido por llamada y registra el resultado (callMade: true) |
Notas
- Los pasos 1 y 2 son comunes a todos los flujos de verificación.
- En la variante SMS, la respuesta del paso 3 incluye el número enmascarado y
expiresAt, pero no el OTP. - El campo
callMadeenPOST /phone/verify-codedetermina cómo se valida el código:falsepara SMS,truepara llamada. - Tras 5 intentos fallidos el código queda bloqueado y se debe solicitar uno nuevo repitiendo el paso 3.
Last modified on