API de SMS

createSMSMessage

Se utiliza para enviar notificaciones SMS a los usuarios

POST https://api.pushwoosh.com/json/1.3/createSMSMessage

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
auth*	Sí	string	Token de acceso a la API del Panel de Control de Pushwoosh.
application*	Sí	string	Código de aplicación de Pushwoosh
notifications*	Sí	array	Configuración de contenido. Array JSON de parámetros del mensaje. Ver detalles a continuación.

Parámetros de notificación

Nombre	Requerido	Tipo	Descripción
send_date*	Sí	string	Fecha y hora para enviar la notificación. Use el formato `YYYY-MM-DD HH:mm` o `now` para enviar inmediatamente.
content*	Sí	string	Contenido de texto del mensaje SMS.
devices*	Sí	array	Número de teléfono del cliente (debe estar asociado con un UserId usando `/registerDevice` y especificado en el parámetro `hwid` o usar `use_auto_registration`). Solo se puede especificar un número aquí.
use_auto_registration	No	boolean	Si se establece en `true`, el número de teléfono especificado en el parámetro `devices` se registrará automáticamente.
dynamic_content_placeholders	No	object	Marcadores de posición de contenido dinámico para personalizar el contenido del mensaje. Cada marcador será reemplazado con los valores dinámicos correspondientes.
preset	No	string	Código de Preset de SMS de su Panel de Control.

Ejemplo de solicitud

{
  "request": {
    "application": "12345-67891",    // requerido. Código de aplicación de Pushwoosh.
    "auth": "yxoPUlwqm…………pIyEX4H",  // requerido. Token de acceso a la API del Panel de Control de Pushwoosh.
    "notifications": [{
      "send_date": "now",            // requerido. YYYY-MM-DD HH:mm O "now".
      "content": "Hello!",           // requerido. Texto del SMS (string).
      "devices": ["+1234567890"],    // requerido. Número de teléfono del cliente (debe estar asociado
                                     //           con un UserId usando /registerDevice y especificado en
                                     //           el parámetro "hwid" o usar "use_auto_registration").
                                     //           Solo se puede especificar un número aquí.
      "preset": "XXXXX-XXXXX",       // opcional. Código de Preset de SMS de su Panel de Control.
      "use_auto_registration": true  // opcional. Registrar automáticamente el número de teléfono especificado
                                     //           en el parámetro "devices".
    }]
  }
}

Ejemplo de respuesta

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "9648-0B10ECB6-0D9F214D"
    ]
  }
}

Respuesta de error

{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}

Para obtener estadísticas de SMS, utilice el método totalsByIntervals.

También puede ver las estadísticas de cada mensaje en la sección Historial de Mensajes.