Saltar al contenido principal
Puede configurar un proveedor telefónico personalizado para mensajes SMS usando un número de teléfono como identificador de usuario. Un proveedor telefónico personalizado usa Actions para dirigir los mensajes SMS al proveedor telefónico que elija al verificar números de teléfono y restablecer contraseñas. Es posible que desee configurar un proveedor telefónico personalizado para los siguientes casos de uso:
  • Usar distintos proveedores telefónicos según el contexto de la aplicación, que puede incluir diferentes regiones geográficas donde los precios de los mensajes pueden variar significativamente entre proveedores.
  • Usar distintos proveedores telefónicos según el contexto de la organización, ya que algunos clientes B2B pueden requerir proveedores específicos.
Puede configurar un proveedor telefónico personalizado con o .

​
Configure un proveedor telefónico personalizado con Auth0 Dashboard o Management API

Para configurar un proveedor telefónico personalizado, debe usar el desencadenador de Action custom-phone-provider, que no está disponible en el editor de Auth0 Actions. Para obtener más información, consulte Ejemplo de Action custom-phone-provider.

​
Agregar un proveedor telefónico personalizado con el Auth0 Dashboard

Para configurar un nuevo proveedor telefónico personalizado en el Auth0 Dashboard:
  1. Vaya a Branding > Phone Provider. Esto le llevará a la página Phone Message Provider. De forma predeterminada, está seleccionado el proveedor telefónico de Twilio.
  2. Seleccione la opción de proveedor telefónico Custom en la sección Phone Provider.
  3. Seleccione el Método de entrega:
    1. Texto: El código de verificación se enviará a sus usuarios por SMS.
    2. Voz: El código de verificación se enviará a sus usuarios mediante un mensaje de voz.
  4. En Provider Configuration, escriba el código de Actions para configurar un proveedor telefónico personalizado:
    1. Consulte la documentación de su proveedor para comprender cómo enviar mensajes a su API.
    2. Agregue los secretos necesarios para autenticarse con la API.
    3. (Opcional) Puede editar la Action con la interfaz completa del editor de Actions haciendo clic en el botón Edit in Expanded Editor. Después de editar la Action en el editor de Actions, haga clic en Save y Deploy la Action desde esa interfaz. Haga clic en el enlace Back to Phone Provider en la parte superior de la página del editor de Actions para volver a la página Phone Message Provider. Tendrá que volver a seleccionar la opción de proveedor telefónico Custom en la sección Phone Provider.
  5. Haga clic en el botón Save en la parte inferior de la página.
Al hacer clic en Save, la Action se guarda y se implementa automáticamente. Para probar la configuración del proveedor telefónico personalizado antes de usarla en un entorno de producción, haga clic en Send Test Message.
No puede hacer clic en Send Test Message para probar el proveedor telefónico personalizado hasta después de guardar su configuración.

​
Editar un proveedor telefónico personalizado con el Auth0 Dashboard

Para editar un proveedor telefónico personalizado existente en el Auth0 Dashboard:
  1. Vaya a Branding > Phone Provider. Esto le llevará a la página Phone Message Provider.
  2. Modifique el código de la Action en la página Phone Message Provider según sea necesario.
    1. (Opcional) Puede editar la Action con la interfaz completa del editor de Actions haciendo clic en el botón Edit in Expanded Editor. Después de editar la Action en el editor de Actions, haga clic en Save y Deploy la Action desde esa interfaz. Luego, haga clic en el enlace Back to Phone Provider en la parte superior de la página del editor de Actions.
  3. Haga clic en el botón Save en la parte inferior de la página.
Al hacer clic en Save, la Action se guarda y se implementa automáticamente. Para probar la configuración del proveedor telefónico personalizado antes de usarla en un entorno de producción, haga clic en Send Test Message.
Un ejemplo de proveedor telefónico personalizado que puede configurar es Twilio Verify. Para obtener más información, consulte Configurar un proveedor telefónico personalizado con Twilio Verify.

​
Ejemplo de Action custom-phone-provider

El desencadenador custom-phone-provider es distinto del desencadenador send-phone-message, que no debe usarse para configurar un proveedor telefónico personalizado. Para obtener más información, consulte lo siguiente: La siguiente muestra de código es una Action custom-phone-provider con la funcionalidad de una Action send-phone-message: 
/**
* Manejador que se ejecuta al enviar una notificación por teléfono*
* @param {Event} event - Detalles sobre el usuario y el contexto en el que está iniciando sesión.
* @param {CustomPhoneProviderAPI} api - Métodos y utilidades para modificar el comportamiento del envío de notificaciones por teléfono.
*/
exports.onExecuteCustomPhoneProvider = async (event, api) => {

  if (event.notification.message_type.startsWith('otp')) {
    const body = {
      from: event.notification.from,
      action: event.notification.message_type === 'otp_verify' ? 'second-factor-authenticator' : 'enrollment',
      language: event.notification.locale,
      recipient: event.notification.recipient,
      message_type: event.notification.delivery_method,
      text: event.notification.as_text,
      code: event.notification.code,
    };

    const response = await fetch(event.secret.SERVICE_URL, {
      method: 'POST',
      headers: {
        authorization: `Bearer ${event.secrets.TOKEN}`,
      },
      body: JSON.stringify(body),
    });

    console.log(response);
  }

  return;
};