Configura la verificación por SMS con Twilio SMS

El conector oficial de Logto para el servicio de mensajes cortos de Twilio.

tip

En esta guía, asumimos que tienes conocimientos básicos de los conectores de Logto. Si no los tienes, consulta la guía Configurar conectores para comenzar.

Comenzar

Twilio proporciona herramientas de comunicación programables para realizar y recibir llamadas telefónicas, enviar y recibir mensajes de texto y otras funciones de comunicación. Podemos enviar los mensajes de texto de "código de verificación" a través de sus APIs de servicio web.

Registrar cuenta de Twilio

Crea una nueva cuenta en Twilio. (Salta al siguiente paso si ya tienes una.)

Configurar números de teléfono de los remitentes

Ve a la página de consola de Twilio e inicia sesión con tu cuenta de Twilio.

Compra un número de teléfono en "Phone Numbers" -> "Manage" -> "Buy a number".

ℹ️ Consejo

A veces puedes encontrarte con la situación de que el servicio de SMS no es compatible en países o áreas específicas. Elige un número de otras regiones para evitarlo.

Una vez que tengamos un número válido reclamado, navega a "Messaging" -> "Services". Crea un nuevo Servicio de Mensajes haciendo clic en el botón.

Dale un nombre amigable al servicio y elige Notify my users como nuestro propósito de servicio. Siguiendo el siguiente paso, elige Phone Number como Sender Type, y añade el número de teléfono que acabamos de reclamar a este servicio como remitente.

ℹ️ Nota

Cada número de teléfono solo puede estar vinculado a un servicio de mensajería.

Obtener credenciales de cuenta

Necesitaremos las credenciales de API para que el conector funcione. Comencemos desde la página de consola de Twilio.

Haz clic en el menú "Account" en la esquina superior derecha, luego ve a la página "API keys & tokens" para obtener tu Account SID y Auth token.

Regresa a la página de configuración de "Messaging" -> "Services" comenzando desde la barra lateral, y encuentra el Sid de tu servicio.

Componer el JSON del conector

Rellena los campos accountSID, authToken y fromMessagingServiceSID con Account SID, Auth token y Sid del servicio de mensajería correspondiente.

Puedes añadir múltiples plantillas de conector SMS para diferentes casos. Aquí tienes un ejemplo de cómo añadir una sola plantilla:

• Rellena el campo content con contenidos de tipo cadena arbitrarios. No olvides dejar el marcador {{code}} para el código de verificación aleatorio.
• Rellena el campo usageType con Register, SignIn, ForgotPassword, Generic para diferentes casos de uso. Para habilitar flujos de usuario completos, se requieren plantillas con usageType Register, SignIn, ForgotPassword y Generic.

Probar el conector de Twilio SMS

Puedes ingresar un número de teléfono y hacer clic en "Send" para ver si la configuración funciona antes de "Save and Done".

Eso es todo. No olvides Habilitar el conector en la experiencia de inicio de sesión.

Tipos de configuración

Nombre	Tipo
accountSID	string
authToken	string
fromMessagingServiceSID	string
templates	Templates[]

Propiedades de la plantilla	Tipo	Valores del enum
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referencia

• Twilio - Diccionario de errores y advertencias