Usuarios de la API

Última actualización: 05/08/2022

Objetivo

Esta guía explica cómo crear y gestionar usuarios de la API de SMS.

Requisitos

• Disponer de una cuenta de SMS en OVHcloud.
• Haber iniciado sesión en el área de cliente de OVHcloud, en la sección Telecom{.action} > SMS.

Procedimiento

Existen diversos motivos por los que puede ser útil disponer de un usuario de la API de SMS:

• Los usuarios de la API permiten proteger los accesos a la cuenta de SMS al enviar SMS a través de una API externa, ya que el script que realiza la llamada solo conoce el identificador del usuario y su contraseña, pero no la sesión del ID de cliente del propietario.

• En una empresa, es posible crear varios usuarios de la API para disfrutar de una mejor trazabilidad y poder identificar el origen en caso de que un usuario de la API envíe SMS de forma abusiva.

• Es posible imponer restricciones (cuotas) a los créditos de SMS de un usuario de la API. De este modo, el propietario de la cuenta de SMS puede repartir sus créditos entre las diferentes cuentas de usuarios de la API.

Para gestionar mejor el saldo de su cuenta de SMS, es posible aplicar un límite y una cuota a los usuarios de la API.

• La cuota es la cantidad de créditos de SMS asignada a un usuario de la API.

• El límite es el umbral de créditos de SMS del que debe bajar un usuario de la API para recibir una alerta que se lo notifique y así poder recargar créditos si lo desea.

1. Crear un usuario de la API

Conéctese al área de cliente de OVHcloud en la sección Telecom. A continuación, haga clic en SMS y seleccione su cuenta de SMS.

Por último, abra la pestaña Usuarios API. Para añadir un usuario, haga clic en el botón Acciones y seleccione Añadir.

Introduzca el nombre que quiera asignarle a su usuario de la API. La contraseña del usuario de la API debe estar compuesta por 8 caracteres alfanuméricos.

2. Añadir una cuota a un usuario de la API

Puede gestionar las cuotas desde la pestaña Usuarios API. Haga clic en el botón ··· situado al final de la fila correspondiente al usuario de la API y seleccione Cuota.

Podrá realizar dos acciones:

• Activar la cuota: Marque la casilla ¿Quiere activar la cuota? para activar una cuota para el usuario de la API.
• Establecer una cuota: Establezca una cuota para el usuario en el campo Nueva cuota. Una vez alcanzada la cuota asignada, el envío de SMS se bloqueará para ese usuario.

3. Asignar un límite a un usuario de la API

También en Usuarios API, es posible configurar un límite para un usuario de la API, haciendo clic en el botón ··· y seleccionando Límite.

Podrá realizar las siguientes acciones:

• Activar una alerta: Marque la casilla ¿Quiere activar la alerta? para activar la alerta de límite.
• Establecer un umbral de alerta: Indique en el campo Umbral de alerta el número de créditos de SMS del que debe bajar para activar el envío de la notificación.
• Configurar la notificación: Elija el medio por el que desea recibir la notificación: correo electrónico, SMS o ambos, e indique la dirección de correo electrónico y/o el número de teléfono móvil.

4. Aplicar una restricción por IP para la función http2sms

Es posible proteger la función http2sms (envío de SMS mediante una petición http) aplicando restricciones por IP a cada usuario de la API.

Para activar la restricción por IP, haga clic en el botón ··· situado al final de la fila correspondiente al usuario de la API y seleccione Restricciones.

Puede introducir hasta 5 direcciones IP públicas diferentes por usuario para enviar las peticiones http.

Para más información sobre la función http2sms, consulte la guía Enviar SMS desde una URL.

5. Especificar una URL de callback

Para realizar un seguimiento personalizado de los acuses de recibo de los SMS (DLR, de delivery reporting) es posible indicar una URL de callback haciendo clic en botón ··· situado al final de la fila correspondiente al usuario de la API y seleccionando Callback.

Cuando se actualiza el estado de envío del SMS, el servicio realiza una llamada a la URL indicada, añadiendo los siguientes parámetros:

• id: Número de identificación del SMS.
• ptt: Código que indica el estado del SMS. Los distintos códigos ptt se describen más abajo.
• date: Fecha del DLR.
• description: ID del DLR. Los distintos ID de DLR se describen más abajo.
• descriptionDIr: 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 la API de OVHcloud.

En la siguiente tabla encontrará una lista no exhaustiva de los códigos ptt principales.

Código	Descripción
1	Estado intermedio que indica que el mensaje todavía no se ha entregado debido a un problema relacionado con el teléfono, pero sigue intentando entregarse.
2	El mensaje todavía no se ha entregado debido a un problema relacionado con el operador, pero sigue intentando enviarse dentro de la red.
3	El mensaje ha sido aceptado por el operador.
4	El mensaje se ha entregado.
5	El mensaje no se ha entregado, pero no se dispone de información detallada sobre el fallo.
6	No se ha podido determinar si el mensaje se ha entregado o se ha producido un fallo debido a la falta de información sobre el estado final de la entrega por parte del operador.
8	El mensaje ha expirado (no se ha podido entregar durante su período de validez) en el operador SMSC, pero se indica la causa del fallo.
20	No es posible entregar el mensaje en su forma actual.
21	Este código solo se utiliza cuando el operador acepta los mensajes antes de comprobar el saldo del abonado. Si el saldo no es suficiente, el operador vuelve a intentar el envío hasta que haya suficiente saldo o el mensaje expire. Si el mensaje expira y la última causa del fallo está relacionada con el saldo, se utiliza este código de error.
23	El mensaje no se puede entregar debido a un MSISDN incorrecto, no válido, en lista negra o prohibido definitivamente por el operador. Este MSISDN no debe volver a utilizarse para enviar mensajes a este operador.
24	El mensaje no se puede entregar porque el abonado está temporalmente ausente, por ejemplo, si su teléfono está apagado y no se puede localizar en la red.
25	El mensaje no ha podido entregarse debido a una circunstancia temporal en la red del operador. Puede estar relacionado con la capa SS7, la pasarela o la SMSC.
26	El mensaje no ha podido entregarse debido a un error temporal del teléfono, por ejemplo, si la tarjeta SIM está llena, la entidad de mensajes cortos está ocupada, la memoria está llena, etc., sin que esto signifique que el teléfono no pueda recibir este tipo de mensaje o contenido (ver código de error 27).
27	El teléfono es definitivamente incompatible o no puede recibir ese tipo de mensajes.
28	El mensaje no ha podido entregarse o ha sido rechazado en la red del operador por ser sospechoso de spam. En algunas zonas geográficas, podría indicar que el operador no puede identificar el MO obligatorio para un MT.
29	El contenido concreto no está autorizado en la red / código abreviado.
33	El abonado no puede recibir contenido para adultos debido a un control parental.
39	Fallo del operador.
73	El mensaje no ha podido entregarse porque el número portado no está disponible.
74	El mensaje no ha podido entregarse porque el MSISDN está en itinerancia.
76	El mensaje no ha podido entregarse porque el número portado está bloqueado para el cliente (el cliente ha sido incluido en una lista negra por el destino portado).
202	El mensaje no ha podido entregarse porque el número portado está bloqueado para el cliente. Para más información, contacte con el servicio de atención al cliente.

Los ID del DLR

Estado	Descripción
0	En creación o pendiente
1	Éxito
2	Error
4	En espera
8	En búfer
16	En error / no facturado

Más información

Interactúe con nuestra comunidad de usuarios en https://community.ovh.com/en/.

---

---

Otras guías que podrían interesarle...