SMS API


SMS API

La API es un servicio simple y fiable que permite enviar SMS en todo el mundo.

Integre el envío de SMS en sus algoritmos y procedimientos para disfrutar de un medio de comunicación instantáneo y universal.

 

Casos de uso

Recordatorios y citas por SMS

Recordar las citas por SMS es una forma muy fiable de asegurar la asistencia y la puntualidad de los destinatarios del mensaje. Si atiende a sus clientes o pacientes con cita previa, envíeles recordatorios por SMS para evitar olvidos y retrasos en sus citas concertadas.

RECORDATORIO: Tiene una cita el 15/09/23 a las 11:00 en el centro médico San Gabriel.

SMS marketing

Aproveche la elevada tasa de lectura que ofrecen los SMS para optimizar los resultados de sus campañas de marketing por SMS, anunciar eventos, etc. Puede utilizar el envío masivo, flash o diferido para contactar en un clic con todos o parte de sus contactos.

¡Feliz cumpleaños, ERIC! Durante el mes de su cumpleaños, sus puntos de fidelidad valen el doble :)

SMS transaccionales

Manténgase en contacto con sus clientes, informe automáticamente a los destinatarios de un paquete enviado y gestione las tareas de sus equipos por SMS. Envíe recordatorios y alertas con acuse de recibo.

Ya puede recoger su paquete 13618678 antes del 05/11/23 en el punto de recogida seleccionado.

Alerta y monitorización por SMS

Monitorice el estado de un dispositivo, un servidor... Con nuestra API puede transformar cualquier objeto conectado a internet en un objeto que se comunica por SMS.

La alarma de vigilancia se ha activado el 04/08/2022 a las 14:48 horas en la zona C, edificio 3.

Ventajas

API REST

Icons/concept/Pen Created with Sketch.

Remitente personalizable

Icons/concept/Cloud/Cloud Eye Created with Sketch.

Acuse de recibo

Envío diferido

Icons/concept/Envelop/Envelop Created with Sketch.

200 000 SMS

Icons/concept/Gear/Gear Arrow Created with Sketch.

Alta tasa de entrega y rutas redundadas

Icons/concept/Hands/Hand World Created with Sketch.

Cobertura mundial con más de 600 operadores

Más información sobre el envío de SMS a través de aplicaciones

Enviar un primer SMS

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs
{
  "message": "Test message",
  "receivers": ["+33601020304"],
  "senderForResponse": true
}

El destinatario recibirá un SMS procedente de un número corto con el contenido del campo «message», en este caso, «Test message».
La API devolverá el número de créditos consumidos, los destinatarios válidos y no válidos, y los identificadores de los SMS para poder consultar su estado.

 

Programar el envío de un SMS

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs
{
  "message": "Test message",
  "receivers": ["+33601020304"],
  "diferedPeriod": 120,
  "senderForResponse": true
}

Es posible programar el envío de un SMS en una fecha posterior.


El campo «differedPeriod» permite posponer el envío. En el ejemplo, el envío se ha retrasado 120 minutos.

 

Monitorizar el envío de un SMS

Puede consultar el estado del SMS utilizando la siguiente llamada, en el campo «deliveryReceipt»:

GET https://api.ovh.com/1.0/sms/sms-aa1-1/outgoing/123456

El campo «deliveryReceipt» puede contener los siguientes valores:

  • 0 → Enviando
  • 1 → Entregado
  • 2 → Rechazado o expirado
  • 4 → En espera en la red del operador del destinatario
  • 8 → Transmitido a la red del operador del destinatario
  • 16 → No distribuible

El campo «ptt» contiene información adicional.

Dicha información se presenta en forma de código, cuya descripción puede consultarse utilizando la siguiente llamada:

https://api.ovh.com/1.0/sms/ptts
{
  "ptt":  4
}

Recibir una notificación cuando cambie el estado de un SMS

OVHcloud puede informarle en tiempo real del cambio de estado de un SMS mediante una llamada HTTP.

Para configurar la URL a la que quiere que se realice la llamada:

PUT https://api.ovh.com/1.0/sms/sms-aa1-1                        {                            "callBack": "http://www.misitio.com/callbackSmsOvh.php"                        }                    

Una vez configuradas las notificaciones, con cada cambio de estado de un SMS, se realizará una llamada a la URL indicada con los siguientes parámetros:

  • Id → ID del SMS
  • dlr → Estado de «deliveryReceipt»
  • ptt → Estado de «ptt»
  • date → Fecha de actualización del estado
  • sender → Remitente del SMS
  • receiver → Número del destinatario del SMS

Recargar manualmente una cuenta de SMS

Puede generar una orden de pedido a través de la API de OVHcloud:

POST https://api.ovh.com/1.0/order/sms/sms-aa1-1/credits                        {                            "quantity":     100                        }                    

Recargar la cuenta automáticamente al alcanzar un umbral determinado

OVHcloud le permite recargar su cuenta de SMS automáticamente cuando baje de un número de créditos determinado.


En ese caso, se generará automáticamente una orden de pedido, que será abonada también de forma automática utilizando la forma de pago configurada en su cuenta de cliente de OVHcloud.


Para configurar la recarga automática de 100 créditos cuando la cuenta tenga menos de 10 créditos:

PUT https://api.ovh.com/1.0/sms/sms-aa1-1                        {                            "automaticRecreditAmount":              100,                            "creditThresholdForAutomaticRecredit":  10,                        }                    

Consultar el precio de los SMS hacia un destino

Para conocer con antelación el precio de su envío, puede utilizar la siguiente llamada:

GET https://api.ovh.com/1.0//sms/sms-aa1-1/seeOffers)                        {                            "countryDestination": "es",                            "countryCurrencyPrice": "es",                            "quantity": 1000,                        }                    

La llamada del ejemplo devuelve el precio del envío de 1000 SMS a España en la divisa utilizada en ese país (euros, en este caso).

Enviar una campaña de SMS a un gran número de destinatarios

Para optimizar el envío de SMS masivo, es posible precargar los destinatarios en un archivo CSV.

Para crear un archivo de destinatarios:

POST https://api.ovh.com/1.0/sms/sms-aa1-1/receivers                        {                            "csvUrl":       "http://misitio.com/mis_destinatarios.csv",                            "description":  "Lista de clientes",                            "slotId":       1                        }                    

El archivo debe incluir al menos una columna «number» con el número de teléfono de los destinatarios. Opcionalmente, puede incluir otras columnas, que se utilizarán para sustituir variables en los envíos. Ejemplo de archivo:

number;name;age                        +33601020304;García;47                        +33602030405;Martín;36                        +33603040506;López;39                    

Para enviar un SMS a todos los destinatarios del archivo anterior, utilice la siguiente llamada:

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs                        {                            "message":              "Hola, Sr. #NAME#. ¡Felicidades por su #AGE# cumpleaños!",                            "receiversSlotId":      1,                            "senderForResponse":    true                            "tag": "MiCampaña"                        }                    

Con esta llamada, los tres destinatarios recibirán un mensaje personalizado.
Por ejemplo, el señor García recibirá el mensaje «Hola, Sr. García. ¡Felicidades por su 47 cumpleaños!».

Si, además, añade el parámetro «tag», podrá buscar los SMS correspondientes al envío mediante la siguiente llamada:

GET https://api.ovh.com/1.0//sms/sms-aa1-1/outgoing)                            {                                "tag": "MiCampaña"                        }                    

Tenga en cuenta que, de este modo, la llamada no devolverá los ID de los SMS, ya que el envío se realizará de forma asíncrona.

SDK para enviar SMS desde PHP