SMS API

createSMSMessage

Используется для отправки SMS-уведомлений пользователям.

POST https://api.wavesend.ru/json/1.3/createSMSMessage

Тело запроса

Имя	Обязательный	Тип	Описание
auth*	Да	string	API access token из Control Panel Wavesend.
application*	Да	string	Application code Wavesend
notifications*	Да	array	Настройки контента. JSON-массив параметров сообщения. Подробности см. ниже.

Параметры уведомления

Имя	Обязательный	Тип	Описание
send_date*	Да	string	Дата и время отправки уведомления. Используйте формат `YYYY-MM-DD HH:mm` или `now` для немедленной отправки.
content*	Да	string	Текстовое содержимое SMS-сообщения.
devices*	Да	array	Номер телефона клиента (должен быть связан с UserId с помощью `/registerDevice` и указан в параметре `hwid` или с использованием `use_auto_registration`). Здесь можно указать только один номер.
use_auto_registration	Нет	boolean	Если установлено значение `true`, номер телефона, указанный в параметре `devices`, будет зарегистрирован автоматически.
dynamic_content_placeholders	Нет	object	Плейсхолдеры для динамического контента для кастомизации содержимого сообщения. Каждый плейсхолдер будет заменен соответствующими динамическими значениями.
preset	Нет	string	Код SMS Preset из вашей Control Panel.

Пример запроса

{
  "request": {
    "application": "12345-67891",    // обязательно. Application code Wavesend.
    "auth": "yxoPUlwqm…………pIyEX4H",  // обязательно. API access token из Control Panel Wavesend.
    "notifications": [{
      "send_date": "now",            // обязательно. YYYY-MM-DD HH:mm ИЛИ "now".
      "content": "Hello!",           // обязательно. Текст SMS (строка).
      "devices": ["+1234567890"],    // обязательно. Номер телефона клиента (должен быть связан
                                     // с UserId с помощью /registerDevice и указан
                                     // в параметре "hwid" или с использованием "use_auto_registration").
                                     // Здесь можно указать только один номер.
      "preset": "XXXXX-XXXXX",       // необязательно. Код SMS Preset из вашей Control Panel.
      "use_auto_registration": true  // необязательно. Автоматически регистрирует номер телефона, указанный
                                     // в параметре "devices".
    }]
  }
}

Пример ответа

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

Ответ с ошибкой

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

Чтобы получить статистику по SMS, используйте метод totalsByIntervals.

Вы также можете просмотреть статистику по каждому сообщению в разделе Message History.