Отправка сообщений
Для подключения услуги свяжитесь с менеджером.
Отправка сообщений 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":"Исходное сообщение не найдено"
}