Пакетная (массовая) отправка Viber-сообщений. VIBER JSON API

Получение статуса доставки Viber-сообщений


Получить статус доставки Viber-сообщений можно двумя способами:
1
С помощью API/JSON-запроса на получение статуса доставки нужного Viber-сообщения, инициируемого с вашей стороны. Т. е. вы отправляете запрос — мы в ответ на него отправляем вам статус доставки Viber-сообщения.
2
С помощью вебхука (webhook)
Webhook — это механизм оповещения системы о событиях. Используя вебхуки, после отправки Viber-сообщения, вам не нужно самостоятельно дополнительно запрашивать статус доставки Viber-сообщения, отслеживать его изменение, а также учитывать срок жизни Viber-сообщения и контролировать интервалы отправки запросов. Как только мы получим конечный статус доставки Viber-сообщения (или его изменение) от телефонного аппарата абонента, мы отправим этот статус вам.
Получение статуса доставки Viber-сообщения с помощью API/JSON-запроса
Статусы доставки Viber-сообщения содержат информацию о текущем состоянии Viber-сообщения. В течение срока жизни Viber-сообщения, до момента получения конечного статуса, статусы регулярно обновляют­ся, и могут быть запрошены пользователем в любое время
Тело запроса
{
    "login": "username",
    "password": "password",
    "command": "viber_status",
    "status": {
        "msg": [
            "viber1_id_for_get_status",
            "viberN_id_for_get_status"
        ]
    }
}
Описание параметров и тегов в запросе
login
ваш логин, для доступа в Личный кабинет (ЛК)

password
ваш пароль к API, который генерируется на странице «SMS-рассылка» — «Рассылка по API»

command
тип запроса, всегда viber_status

msg
массив идентификаторов Viber-сообщений, для которых происходит запрос статуса
Тело ответа
{
    "status": {
        "msg": [
            {
                "message_id": 12345678,
                "message_count": "1",
                "operator": "3",
                "message_status": "Delivered",
                "recipient": "+375293262625"
            }
        ]
    }
}
Описание тегов в ответе
msg
массив с информацией по отправленным Viber-сообщениям. Элементы могут содержать следующие параметры:
message_id
числовой идентификатор Viber-сообщения, который вы получили в момент отправки
message_count
фактическое количество Viber-сообщений к отправке
recipient
номер телефона абонента в международном формате, по которому считываем статус
operator
код мобильного оператора
Получение статуса доставки Viber-сообщения с помощью вебхука (webhook)
Вы можете получать на ваш адрес (URL) информацию по статусу доставки Viber-сообщения в момент его изменения на нашей платформе. Отправка информации (отчёт о доставке) происходит на URL, который вы передаете в параметре webhook_url API-запроса на отправку Viber-сообщения.
В ответ на отчёт о доставке, наш сервис должен получить от вас HTTP-код 200. В противном случае, отправку отчёта о доставке мы считаем недоставленной и повторяем попытку в течение суток с интервалом в 10 минут.
Тело отчёта о доставке
{
    "status": {
        "msg": [
            {
                "message_id": 12345678,
                "message_count": "1",
                "operator": "3",
                "message_status": "Delivered",
                "recipient": "+375293262625"
            }
        ]
    }
}
Описание тегов в ответе
msg
массив с информацией по статусам сообщений. Элементы могут содержать следующие параметры:
message_id
числовой идентификатор Viber-сообщения, который вы получили в момент отправки
message_count
фактическое количество Viber-сообщений к отправке
recipient
номер телефона абонента в международном формате, по которому считываем статус
operator
код мобильного оператора
Ещё в этом разделе