Configura la verificación por SMS con Twilio SMS

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

tip:

Esta guía asume que tienes un entendimiento básico de los Conectores de Logto. Para aquellos que no están familiarizados, por favor consulta la guía de 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.

Registra una cuenta de Twilio

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

Configura los 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".

tip:

A veces puedes encontrarte con la situación de que el servicio de SMS no está disponible 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. En 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.

Obtén las credenciales de la cuenta

Necesitaremos las credenciales de la 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 conectores 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 arbitraria. No olvides dejar el marcador de posición {{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 SMS de Twilio

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 de enumeración
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referencia

Twilio - Diccionario de errores y advertencias