Qué incluye
Al integrar ClickSend con Auth0, obtendrás:
Verificación de OTP: enviar contraseñas de un solo uso para acceder o registrarse
Notificaciones por SMS: enviar notificaciones en tiempo real para la autenticación de múltiples factores (MFA)
Requisitos previos
Una cuenta de ClickSend
Una cuenta de Auth0
Tus credenciales de la API de ClickSend (nombre de usuario + clave de API)
Instalación
Configurar ClickSend en Auth0:
Inicia sesión en tu panel de control de Auth0.
Ve al Marketplace y haz clic en Añadir integración.
Escoge tu tenant y concede los permisos necesarios.
Serás redirigido a la biblioteca donde tendrás que introducir tus credenciales de la API de ClickSend (nombre de usuario y clave de API).
La clave de API se encuentra en tu panel de control de ClickSend: clave de API de ClickSend.
Haz clic en Crear para guardar la conexión.
Configurar los ajustes de OTP en Auth0:
Ve a Panel de control > Seguridad > Autenticación de múltiples factores.
Activa la contraseña de un solo uso (OTP).
Desplázate hasta Define Policies y establece Requerir autenticación de múltiples factores en Always, y luego haz clic en Guardar.
Configurar mensaje de teléfono para SMS:
En Seguridad, configura el Phone Message Factor para la entrega de SMS.
Activa Phone Message y guarda tus cambios.
Añadir la acción de ClickSend al flujo:
Haz clic en Add to Flow en la ventana emergente que aparece.
Arrastra la acción de ClickSend a la ubicación deseada en tu flujo de MFA.
Autenticación
Para activar el componente de SMS:
En los ajustes del componente de Auth0, ve a API Credentials.
Introduce tu:
Username – tu nombre de usuario de ClickSend
API Key – la clave de API que se encuentra en tu panel de control de ClickSend
Verificación de OTP (contraseñas de un solo uso)
Verifica a los usuarios al acceder o registrarse usando contraseñas de un solo uso (OTP).
Configuración
Ve al Menú de verificación > Cuerpo del mensaje.
Incluye %otp% donde quieras que aparezca la OTP en tu mensaje.
Ejemplo: tu código de verificación es %otp%.
Consejo: usa Magic Text para extraer automáticamente los números de teléfono guardados de la base de datos de usuarios.
Personalizar: ajusta el texto del botón "Get OTP", la apariencia y el flujo para adaptarlos a tus necesidades.
Notificación por SMS
Envía alertas por SMS para la autenticación de múltiples factores u otros disparadores en la aplicación (por ejemplo, intentos de acceder del usuario).
Configuración
En Phone Message Factor, añade un mensaje estático o dinámico en el campo Cuerpo del mensaje (Message Body).
Opcionalmente, establece un mensaje de confirmación después de enviar el SMS, como "SMS Sent".
Permite a los usuarios editar el mensaje en tiempo real antes de enviar.
Solución de problemas
Si los mensajes no se pueden enviar, prueba lo siguiente:
Verificar credenciales de API:
Confirma que has introducido el nombre de usuario y la clave de API de ClickSend correctos (no tu contraseña).
Asegurar crédito suficiente:
Comprueba si tu cuenta de ClickSend tiene suficiente crédito. Recarga tu cuenta aquí.
Rellenar campos obligatorios:
Asegúrate de que todos los campos obligatorios (por ejemplo, número de teléfono de destino, cuerpo del mensaje) estén rellenados correctamente.
Problemas con la etiqueta alfa:
Si usas un nombre de empresa (etiqueta alfa) como remitente:
Asegúrate de que tenga un máximo de 11 caracteres y no contenga espacios.
Algunos países no admiten etiquetas alfa. Consulta la lista admitida aquí.
Asegúrate de que la etiqueta alfa esté registrada y aprobada en tu panel de control de ClickSend.
Preguntas frecuentes
¿Puedo usar el nombre de mi empresa como remitente?
Sí, pero solo en los países que admiten etiquetas alfa. Asegúrate de que la etiqueta alfa esté:
11 caracteres o menos
Sin espacios
Registrada y aprobada a través de tu página de IDs de remitente en ClickSend.
¿Cómo configuro una etiqueta alfa?
Ve a las credenciales de API en el panel de control de ClickSend y activa la opción de cambiar etiqueta alfa/ID de remitente.