Todo sobre los usuarios de SMS

Ver como Markdown

Descubra cómo crear, configurar y gestionar usuarios de la API para el envío de SMS, incluidos los permisos y las restricciones

Info

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 al área de cliente de OVHcloud

Enlace directo: SMS
Para acceder a sus servicios: Telecom > 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 API. Para añadir un usuario, haga clic en el botón Acciones y, a continuación, en Añadir.

La definición del nombre del usuario de la API es libre. La contraseña de un usuario de la API debe estar compuesta por 8 caracteres alfanuméricos.

Etapa 2: Atribuir una cuota a un usuario de la API

La gestión de la cuota se realiza desde la pestaña Usuarios API. Junto al usuario elegido, haga clic en ... y, a continuación, en Cuota.

Podrá entonces realizar dos acciones.

¿Quiere activar la cuota?: le permite definir si 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.

Info

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 ... y, a continuación, en Límite.

Estarán entonces disponibles los siguientes parámetros:

¿Quiere activar la alerta?: permite activar la 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: correo electrónico (indique entonces su dirección de correo electrónico), SMS (indique su número en formato internacional) o ambos.

Warning

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 ... a la derecha del usuario y, a continuación, en Restricciones.

Puede indicar hasta 5 direcciones IP públicas diferentes para el envío de sus peticiones https.

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 ... a la derecha del usuario y, a continuación, en Callback.

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:

🇪🇺GET/sms/ptts

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.

Código	Descripción
1	Notificación de estado intermedio que indica que el mensaje todavía no se ha entregado debido a un problema relacionado con el teléfono, pero se está reintentando el envío (Intermediate state notification that the message has not yet been delivered due to a phone related problem but is being retried).
2	Se utiliza para indicar que el mensaje todavía no se ha entregado debido a un problema relacionado con el operador, pero se está reintentando el envío dentro de la red (Used to indicate that the message has not yet been delivered due to some operator related problem but is being retried within the network).
3	Se utiliza para indicar que el mensaje ha sido aceptado por el operador (Used to indicate that the message has been accepted by the operator).
4	El mensaje se ha entregado (The message was delivered).
5	Se ha confirmado que el mensaje no se ha entregado, pero no se dispone de información detallada sobre el fallo (The message has been confirmed as undelivered but no detailed information related to the failure is known).
6	No se puede determinar si el mensaje se ha entregado o ha fallado, debido a la falta de información sobre el estado final de la entrega por parte del operador (Cannot determine whether this message has been delivered or has failed due to lack of final delivery state information from the operator).
8	Se utiliza cuando un mensaje ha expirado (no se ha podido entregar durante el período de validez del mensaje) en el SMSC del operador, pero sin estar asociado a una causa del fallo (Used when a message expired (could not be delivered within the life time of the message) within the operator SMSC but is not associated with a reason for failure).
20	Se utiliza cuando un mensaje no se puede entregar en su forma actual (Used when a message in its current form is undeliverable).
21	Solo se utiliza cuando el operador acepta el mensaje antes de realizar la comprobación del crédito del abonado. Si el crédito es insuficiente, el operador reintenta el envío hasta que haya suficiente crédito o el mensaje expire. Si el mensaje expira y la última causa del fallo está relacionada con el crédito, se utilizará este código de error (Only occurs where the operator accepts the message before performing the subscriber credit check. If there is insufficient credit then the operator will retry the message until the subscriber tops up or the message expires. If the message expires and the last failure reason is related to credit then this error code will be used).
23	Se utiliza cuando el mensaje no se puede entregar debido a un MSISDN incorrecto / no válido / en lista negra / prohibido definitivamente por este operador. Este MSISDN no debe volver a utilizarse para enviar mensajes a este operador (Used when the message is undeliverable due to an incorrect / invalid / blacklisted / permanently barred MSISDN for this operator. This MSISDN should not be used again for message submissions to this operator).
24	Se utiliza cuando un mensaje no se puede entregar porque el abonado está temporalmente ausente, por ejemplo, si su teléfono está apagado o no se puede localizar en la red (Used when a message is undeliverable because the subscriber is temporarily absent, e.g. their phone is switch off, they cannot be located on the network).
25	Se utiliza cuando el mensaje ha fallado debido a una situación temporal en la red del operador. Podría estar relacionado con la capa SS7, la pasarela o el SMSC (Used when the message has failed due to a temporary condition in the operator network. This could be related to the SS7 layer, SMSC or gateway).
26	Se utiliza cuando un mensaje ha fallado debido a un error temporal del teléfono, por ejemplo, si la tarjeta SIM está llena, el SME está ocupado, la memoria está llena, etc. Esto no significa que el teléfono sea incapaz de recibir este tipo de mensaje o contenido (consulte el código de error 27) (Used when a message has failed due to a temporary phone related error, e.g. SIM card full, SME busy, memory exceeded etc. This does not mean the phone is unable to receive this type of message/content (refer to error code 27)).
27	Se utiliza cuando un terminal es definitivamente incompatible o incapaz de recibir este tipo de mensajes (Used when a handset is permanently incompatible or unable to receive this type of message).
28	Se utiliza si un mensaje falla o es rechazado debido a sospechas de SPAM en la red del operador. En algunas zonas geográficas, podría indicar que el operador no tiene ningún registro del MO obligatorio requerido para un MT (Used if a message fails or is rejected due to suspicion of SPAM on the operator network. This could indicate in some geographies that the operator has no record of the mandatory MO required for an MT).
29	Se utiliza cuando este contenido específico no está autorizado en la red / shortcode (Used when this specific content is not permitted on the network / shortcode).
33	Se utiliza cuando el abonado no puede recibir contenido para adultos debido a un control parental (Used when the subscriber cannot receive adult content because of a parental lock).
39	Nuevo fallo del operador (New operator failure).
73	El mensaje ha fallado porque las combinaciones portadas son inaccesibles (The message was failed due to the ported combinations being unreachable).
74	El mensaje ha fallado porque el MSISDN está en itinerancia (The message was failed due to the MSISDN being roaming).
76	El mensaje ha fallado porque las combinaciones portadas están bloqueadas para el cliente (el cliente ha sido incluido en una lista negra para el destino portado) (The message was failed due to the ported combinations being blocked for client (the client has been blacklisted from the ported destination)).
202	El mensaje ha fallado debido a las combinaciones portadas bloqueadas para el cliente. Contacte con el servicio de atención al cliente para más información (The message was failed due to the ported combinations being blocked for the client. Please contact Client Support for additional information).

Los diferentes ID del DLR

Estado	Descripción
0	En creación o pendiente (Creating or pending)
1	Éxito (Success)
2	Fallido (Failed)
4	En espera (Waiting)
8	En búfer (Buffered)
16	En error / no facturado (Error / not billed)

Más información

Interactúe con nuestra comunidad de usuarios.

¿Le ha resultado útil esta página?