Регистрация
Подключиться
Я даю согласие на обработку персональных данных
Отправка сообщений через Viber
Через платформу Terasms возможна отправка Viber-сообщений. Для подключения услуги свяжитесь с менеджером.

Отправка сообщений через API.

Интеграция осуществляется по протоколу HTTP.

Для отправки сообщения необходимо произвести GET-запрос вида:

https://auth.terasms.ru/outbox/send_viber?login=login&password=password&target=79XXXXXXXXX&sender=sender&message=Hello+from+terasms.ru Описание параметров:

* имя отправителя необходимо согласовывать с менеджером

** возможны следующие варианты сообщений: только текст, только изображение, текст + кнопка, текст + кнопка + изображение

В качестве ответа на запрос вернётся ID сообщения (целое число, int 32), которое можно затем использовать для проверки статуса, либо код ошибки.

Коды ошибок отправки сообщения:
Массовая отправка сообщений через API

Вы можете отправлять несколько сообщений одним запросом, отправляя POST-запрос по адресу https://auth.terasms.ru/outbox/send_viber_bulk/xml или https://auth.terasms.ru/outbox/send_viber_bulk/json.
При запросе на https://auth.terasms.ru/outbox/send_viber_bulk/xml ваш запрос должен быть представлен в формате XML (ответ платформы также приходит в этом формате), при запросе на https://auth.terasms.ru/outbox/send_viber_bulk/json запрос должен быть в формате json, ответ также будет в json. Параметры сообщений аналогичны параметрам, передаваемым при отправке одиночного сообщения.

Пример запроса в формате xml:

<?xml version="1.0" encoding="utf-8"?> <request> <login>login</login> <password>password</password> <messages> <msg> <target>780011122233</target> <!-- телефон, на который отправится сообщение --> <message>ку-ку</message> <!-- текст сообщения --> <sender>terasms.ru</sender> <!-- имя отправителя --> </msg><<msg> <target>780011122234</target> <message>ку-ку</message> <sender>terasms.ru</sender> </msg> </messages> </request> Ответ:

<?xml version="1.0" encoding="utf-9"?> <response> <messages> <message> <status>0</status> <message_id>1771</message_id> </message> <message> <status>0</status> <message_id>1773</message_id> </message> </messages> </response> Пример запроса в формате json:

{ "login": "login", "password": "password", "messages": [ { "message": "хелло", "target": "78999999999", "sender": "terasms.ru" } ] } Пример ответа:

{ "messages": [ { "status": 0, "message_id": 15304 }, { "message_id": null, "status": -50, "error": "No sender name" } ] }

Загрузка изображений

Загрузка изображений в систему осуществляется POST-запросом (multipart/form-data) по адресу https://auth.terasms.ru/outbox/upload_image

В запросе должны присутствовать следующие поля:

В ответе на запрос придёт ID изображения, которое можно указывать в параметре image_id при отправке сообщений.

Проверка статуса сообщения

Для проверки статуса сообщения необходимо произвести GET/POST запрос по адресу: https://auth.terasms.ru/outbox/viber_status?login=login&password=password&id=message_id

Описание параметров запроса:
Получение статусов нескольких сообщений одним запросом

Вы можете получать статусы нескольких сообщений, выполняя POST-запрос по адресу https://auth.terasms.ru/outbox/viber_status_bulk/xml или https://auth.terasms.ru/outbox/viber_status_bulk/json.

Пример запроса в формате XML: https://auth.terasms.ru/outbox/viber_status_bulk/xml

<?xml version="1.0" encoding="UTF-8" ?> <request> <login>login</login> <password>password</password> <ids> <id>111</id> <id>222</id> <id>333</id> </ids> </request> Ответ:

<?xml version="1.0" encoding="UTF-8" ?> <response> <messages> <message> <status>1</status> <status_name>отправлено</status_name> </message> <message> <status>1</status> <status_name>отправлено</status_name> </message> <message> <status>12</status> <status_name>доставлено</status_name> </message> </messages> </response> Пример запроса в формате JSON: https://auth.terasms.ru/outbox/viber_status_bulk/json

{ "login": "login", "password": "password", "ids": [ 111, 222, 333 ] } Ответ:

{ "messages": [ { "status": 1, "status_name": "отправлено" }, { "status": 1, "status_name": "отправлено" }, { "status": 12, "status_name": "доставлено" } ] }

Описание статусов
«Каскадная» отправка сообщений

Возможна отправка сообщений «каскадом», при которой сначала предпринимается попытка доставить сообщение через Viber, и в случае неудачи сообщение отправляется через SMS.
См. Отправка «каскадных» сообщений.
Регистрация
Подключиться
Я даю согласие на обработку персональных данных
Заказать просчет
It's totally free