Todo sobre los usuarios de SMS
Descubra cómo crear, configurar y gestionar usuarios de la API para el envío de SMS, incluidos los permisos y las restricciones
Las ofertas de SMS de OVHcloud solo están disponibles en los siguientes países: Francia, Reino Unido, Irlanda, España, Italia y Polonia.
Objetivo
Esta guía le explica cómo crear y gestionar usuarios de la API.
Requisitos
- Disponer de una cuenta de SMS de OVHcloud.
Acceso a la Console de OVHcloud
- Enlace directo: SMS
- Ruta de navegación:
Web Cloud>SMS> Seleccione su cuenta de SMS
Procedimiento
Un usuario de la API de SMS puede ser útil por varias razones:
-
Permite al propietario de la cuenta de SMS proteger sus accesos al enviar SMS a través de una API externa. En efecto, el script que realiza la llamada solo conoce el identificador del usuario y su contraseña, y no la sesión del identificador de cliente del propietario.
-
La creación de varios usuarios de la API puede resultar útil en una empresa, sobre todo para disponer de una mejor trazabilidad. Un usuario de la API que envíe SMS de forma abusiva puede ser detectado de inmediato por el propietario de la cuenta.
-
Un usuario de la API puede estar sujeto a restricciones (cuotas) en sus créditos de SMS. De este modo, el propietario de la cuenta de SMS puede repartir sus créditos entre sus diferentes cuentas de usuarios de la API.
Para gestionar mejor el crédito de su cuenta de SMS, puede fijar un límite y una cuota a sus usuarios de la API.
-
La cuota es la cantidad de créditos de SMS disponibles para el usuario de la API.
-
El límite corresponde al umbral mínimo de créditos de SMS que un usuario de la API debe tener antes de recibir una alerta para recargar o no el saldo de dichos créditos.
Etapa 1: Crear un usuario de la API
Haga clic en la pestaña Usuarios. Para añadir un usuario, haga clic en el botón Añadir un usuario.
En el panel Crear un usuario, el Identificador del usuario de la API puede definirse libremente. La Contraseña de un usuario de la API debe contener exactamente 8 caracteres. A continuación, haga clic en Guardar.
Etapa 2: Atribuir una cuota a un usuario de la API
La gestión de la cuota se realiza desde la pestaña Usuarios. Junto al usuario elegido, haga clic en el botón ⋮ y, a continuación, en Configurar la cuota.
La ventana Cuota ofrece entonces dos parámetros.
- Cuota: active este interruptor para que este usuario esté sujeto a una cuota.
- Nueva cuota: define la cuota del usuario. Una vez alcanzada esta cuota, el envío de SMS se bloqueará para este usuario.
A continuación, haga clic en Guardar.
La asignación de una cuota a un usuario de la API reducirá en la misma proporción el crédito total de la cuenta de SMS.
Por ejemplo: una cuenta de SMS dispone de un total de 200 créditos. La asignación de 150 créditos a un usuario de la API descontará 150 créditos de la cuenta de SMS, que ya solo dispondrá de 50 créditos.
Etapa 3: Atribuir un límite a un usuario de la API
La configuración de un límite para un usuario se realiza desde el mismo menú, haciendo clic en el botón ⋮ y, a continuación, en Configurar el límite.
Estarán entonces disponibles los siguientes parámetros en el panel Límite:
- Alerta: active este interruptor para recibir una alerta de límite.
- Umbral de alerta: define el nivel de créditos de SMS restantes a partir del cual se envía la notificación.
- Notificación: permite elegir el tipo de notificación en el menú desplegable: Correo electrónico (indique entonces su dirección en el campo Correo electrónico), SMS (indique su número en formato internacional) o Correo electrónico y SMS.
A continuación, haga clic en Guardar.
El envío de una notificación por SMS se descontará de su crédito de SMS.
Etapa 4: Definir una restricción por IP para la función http2sms
Puede proteger la función http2sms aplicando restricciones por IP a cada usuario de la API.
Para activarla, haga clic en el botón ⋮ a la derecha del usuario y, a continuación, en Restringir las llamadas.
En el panel Restricción de IP para http2sms, puede indicar hasta 5 direcciones IP públicas diferentes, en notación CIDR IPv4 (por ejemplo, 203.0.113.10/32 para una sola dirección) (campos Restricción n.º 1 a Restricción n.º 5) para el envío de sus peticiones https y, a continuación, hacer clic en Guardar.
Para más información sobre la función http2sms, consulte la guía Enviar SMS desde una URL.
Etapa 5: Especificar una URL de Callback
Para realizar un seguimiento personalizado de los acuses de recibo de los SMS (Delivery reporting o DLR), puede especificar una URL llamada de Callback haciendo clic en el botón ⋮ a la derecha del usuario y, a continuación, en Configurar la URL de callback. Introduzca la dirección en el campo URL de callback de la ventana que se abre y, a continuación, haga clic en Guardar.
Cuando se actualiza el estado de envío del SMS, llamamos a la URL especificada. Los siguientes valores se insertan automáticamente en la query string:
- id: número de identificación del SMS
- ptt: código que corresponde a un estado del SMS. Los diferentes códigos ptt se describen en la primera tabla que figura a continuación.
- date: fecha del DLR
- description: ID del DLR. Los diferentes ID se describen en la segunda tabla que figura a continuación.
- descriptionDlr: descripción del estado del DLR
Los códigos ptt
Para obtener la descripción de un código ptt específico, puede utilizar la siguiente API:
Para más información sobre el uso de las API de OVHcloud, consulte nuestra guía Primeros pasos con las API de OVHcloud.
En la siguiente tabla encontrará una lista no exhaustiva de los principales códigos ptt.
Los diferentes ID del DLR
Más información
Interactúe con nuestra comunidad de usuarios.