Отправка сообщений WhatsApp

Отправка сообщений

Отправка сообщений WhatsApp осуществляется аналогично отправке SMS, при этом в список передаваемых параметров добавляется параметр type со значением whatsapp.

Отправка WhatsApp-сообщения GET-запросом

https://auth.terasms.ru/outbox/send?login=login&target=78002223344&sender=terasms.ru&message=terasms rulez&type=whatsapp&sign=3e6eb14d4b7c06d77aecd92904d964c2

Формат ответа аналогичен ответу при отправке SMS: либо ID сообщения в виде положительного числа, либо ошибка в виде отрицательного числа.

Коды ошибок

Запрос в формате JSON

Пример запроса
> POST auth.terasms.ru/outbox/send/json

{
  "login": "login",
  "sign": "3e6eb14d4b7c06d77aecd92904d964c2",
  "target": 78001234567,
  "message": "terasms rulez",
  "sender": "terasms.ru",
  "type": "whatsapp"
}
Пример ответа
{
  "status": 0,
  "status_description": "OK",
  "message_infos": [
    {
      "msisdn": "78001234567",
      "id": "123456789",
      "status": null,
      "price": "0.4000"
    }
  ]
}

Запрос в формате XML

Пример запроса
> POST auth.terasms.ru/outbox/send/xml

<?xml version="1.0"?>
<request>
    <login>login</login>
    <sign>3e6eb14d4b7c06d77aecd92904d964c2</sign>
    <target>78001234567</target>
    <message>ку-ку</message>
    <sender>terasms.ru</sender>
    <type>whatsapp</type>
</request>
Пример ответа
<?xml version="1.0"?>
<response>
  <status>0</status>
  <status_description>OK</status_description>
  <message_infos>
    <message_info>
      <msisdn>78001234567</msisdn>
      <id>123456789</id>
      <status/>
    </message_info>
  </message_infos>
</response>

Получение статусов сообщений

Механизм описан в разделе

Получение статусов сообщений

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

Запрос

Запрос можно формировать как GET, так и POST методами. Также возможен прием параметров в формате JSON.

В параметре message_id необходимо указать идентификатор сообщения, который был получен при отправке сообщения.

Пример запроса
> POST auth.terasms.ru/outbox/getMessageAnswers/json

{
  "login": "login",
  "sign": "3e6eb14d4b7c06d77aecd92904d964c2",
  "message_id": "123456789"
}

Ответ

Ответ возвращается только в формате JSON.

Пример ответа
{
  "src_message"
  {
    "id":"123456789",
    "time":"2000-01-01 23:59:59",
    "msisdn":"78001234567"
  },
  "answers":
  [
    {
      "answer_id":"1",
      "answer_time":"2000-01-02 03:59:59",
      "answer_text":"Текст ответа 1"
    },
    {
      "answer_id":"2",
      "answer_time":"2000-01-02 05:59:59",
      "answer_text":"Текст ответа 2"
    }
  ]
}
Пример ответа с ошибкой
{
  "error":"Исходное сообщение не найдено"
}