Отправить сообщение с сайта viber: Как отправить рассылку в Viber?

Как отправить рассылку в Viber?

Создать и отправить рассылку в Viber очень просто — всего 2 шага.

1. Активируйте новое имя отправителя

В вашем SendPulse аккаунте откройте вкладку «РАССЫЛКИ» и кликните кнопку «Отправить Viber».

Нажмите «Добавить новое имя отправителя».

Заполните поля на странице «Добавить новое имя отправителя» своей информацией и кликните «Подать на регистрацию».

Активация занимает от 7 до 30 дней. Как только имя отправителя станет активным, вы можете переходить к следующему шагу.

2. Заполните все поля для отправки.

На вкладке «РАССЫЛКИ» нажмите кнопку «Отправить Viber». Имя отправителя будет заполнено автоматически.

Выберите тип сообщения — рекламное или системное — и добавьте номера телефонов получателей в международном формате вручную или выберите список подписчиков в выпадающем списке «Получатели».

Добавьте содержание сообщения. Сервис позволяет отправлять текст или картинку. Кроме того, вы можете включить переменные в ваше сообщение.

Настройте action-кнопку в сообщении. Укажите текст, который будет отображаться на кнопке, и ссылку на страницу сайта, на которую пользователи будут перенаправлены по нажатию на нее.

Обратите внимание, что при отправке системного сообщения опция вставки action-кнопки недоступна.

Установите время жизни сообщения — период, в течение которого сервис будет пытаться доставить ваше сообщение подписчикам, которые не доступны на момент отправки. Минимальное значение составляет одну минуту, а максимальное — 24 часа.

Укажите время отправки. Рассылка может быть отправлена сразу после ее создания или запланирована на определенную дату и время.

Сервис также предлагает возможность повторной отправки сообщений по SMS, если они не были доставлены по Viber.

Когда ваше сообщение будет готово, проверьте, как ваши получатели увидят его. Для этого нажмите на иконку телефона.

Если сообщение отображается правильно, кликните «Отправить».

Важно: месячная плата в размере €220 является требованием официального Viber канала.

Начните создавать вашу Viber рассылку уже сейчас!

Обновлено: 26.11.2020

Отправка сообщений Viber | Смс рассылка сообщений по всему миру, надежная SMS рассылка для привлечения клиентов

Расширенные возможности это отправка изображений и кнопок. Для подключения услуги свяжитесь с менеджером.

Пример GET-запроса для отправки:

https://auth.terasms.ru/outbox/send_viber?login=login&password=password&target=79XXXXXXXXX&sender=sender&message=Hello+from+terasms.ru

Отправить изображение и кнопку можно только таким способом. Соответствующие параметры запроса (image_id, button_text, button_link) описаны ниже.

Если отправлять изображение или кнопку не требуется, можно воспользоваться общим методом отправки сообщений любых типов outbox/send, если задать для параметра type значение viber.

Описание параметров

Параметр	Описание	Тип	Обязательный
login	Ваш логин на платформе TeraSMS	string	да
password	Ваш пароль на платформе TeraSMS	string	да
target	Телефон получателя	string	да
sender	Имя отправителя, которое увидит клиент *	string	да
message	Текст сообщения **	string	нет
button_text	Текст кнопки, приложенной к сообшению **	string	нет
button_link	Ссылка приложенной к сообщению кнопки **	string	нет
image_id	ID приложенного к сообщению изображения. Изображения необходимо предварительно загружать в систему (см. ниже) **	int32	нет
ttl	Время, в течении которого должно быть доставлено сообщение (в секундах). Сообщения с истекшим TTL считаются недоставленными	int32, мин. значение — 60 (минута), максимальное — 86400 (сутки)	нет (значение по-умолчанию — 86400)

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

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

В качестве ответа на запрос вернётся 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.

Отправить сообщение на Вайбер с компьютера онлайн

Благодаря постоянной работе компании Viber Media, сегодня популярное приложение можно использовать не только на смартфонах, но и на других устройствах – компьютерах, ноутбуках, планшетах. Мобильная версия ничем не отличается от десктопной, но при этом смартфон всегда будет оставаться основным устройством и с него происходит настройка всех функций Вайбера. Если вы хотите добавить удобства использованию мессенжера и всегда оставаться на связи, то вы можете установить Вайбер на свой компьютер и аналогичным образом общаться со своими друзьями без ограничений.

Можно ли отправить сообщение на Вайбер без установки программы

Очень удобным инструментом является браузерная или онлайн-версия программы. Суть ее заключается в том, что вам не нужно устанавливать утилиту на устройство, а можно в онлайн-режиме перейти на ее сайт, авторизоваться и выполнить набор необходимых функций. Подобное решение давно не является новшеством, и многие известные программы практикуют данную возможность. Если говорить конкретно о Вайбере, то разработчики пока не запустили онлайн-версию приложения, а значит, и пытаться найти ее в интернете нет никакого смысла. Не стоит вестись на рекламу или на информацию из неизвестных источников. Работать в Вайбере без установки программы не получится. Поэтому если вы хотите отправить бесплатное сообщение, то вам придется скачать приложение и авторизоваться в нем.

Переписка с ПК или ноутбука

Как уже стало ясным, для отправки сообщений нужно не только подключиться к интернету, но и скачать Вайбер на компьютер. Вся процедура займет у вас всего несколько минут, после чего вы можете в неограниченном количестве переписываться с компьютера.

Скачать и установить Viber на ПК

Скачивание и регистрация в программе

Скачать приложение Viber на свой компьютер или ноутбук можно абсолютно бесплатно. Компания занимается поддержкой всех операционных систем, поэтому Вайбер доступен для Windows, Linux и Mac. Быстро и безопасно вы сможете скачать Viber на нашем сайте, вам достаточно только выбрать свой тип операционной системы и нажать «Скачать». Установочный файл сохранится в папку с загрузками, после чего необходимо выполнить следующие действия:

1. Запускаете установочный файл ViberSetup.exe.
2. Ждете, пока установка программы на компьютер завершится.
3. Переходите к авторизации, нажимаете «Продолжить».
4. Для продолжения работы необходимо ответить на вопрос «Есть ли Viber на вашем телефоне?», отвечаете «Да».
5. Далее нужно будет указать свою страну и номер мобильного телефона, за которым закреплен Вайбер на смартфоне.
6. На экране появится QR-код, который нужно будет отсканировать камерой телефона, через приложение Viber.
7. Далее происходит сопряжение устройств, и мессенджер готов к работе.

Обязательным условием работы Вайбера на компьютере является наличие приложения на смартфоне. Два устройства будут синхронизированы и зарегистрированы под одной учетной записью.

Результатом успешной установки приложения и синхронизации компьютера с телефоном является перенос контактов, настроек и прочих данных с Вайбера мобильной версии на десктопную. В остальном, мессенджер будет иметь схожий интерфейс и набор функций, однако управление будет зафиксировано за основным устройством, а именно за смартфоном.

Как отправить сообщение

После того как вы установили на компьютер мессенджер, можно рассмотреть возможность отправления сообщений с ПК или ноутбука. Здесь нет ничего сложного и функционал схож с мобильной версией, поэтому разобраться не составит труда. Итак, чтобы отправить смс одному из пользователей с компьютера нужно запустить программу и быть подключенным к интернету:

1. Открываете в мессенджере список контактов.
2. Выбираете, чтобы отображались не все контакты из телефонной книги, а только из Viber.
3. Листаете вниз и нажимаете на того, кому хотите отправить сообщение.
4. Из представленных доступных опций выбираете «Бесплатное сообщение» и переходите к текстовому полю для набора смс.
5. При помощи клавиатуры печатаете текст, и справа будет сиреневая кнопка со стрелкой, нажмите и отправьте либо тапните по кнопке «Enter».

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

Если тот, кому вы хотите отправить смс, отсутствует в списке ваших контактов, то вы можете вручную набрать его номер телефона, а после перейти в переписку. Для этого в меню Вайбера нажмите на три точки, возле вкладки «Контакты» и выберите «Номеронабиратель». На экране появится мобильная клавиатура, вы вводите правильно номер телефона и после того, как пользователь появится, заходите в его профиль и используете функцию для отправки сообщения.

Другие онлайн-сервисы для переписки

То, что версии онлайн для Вайбера без предварительной установки программы не существует, мы выяснили. Но что делать, если у вас не отпала необходимость отправить с компьютера смс на номер мобильного телефона. Какие программы можно использовать с этой целью? Ниже вы можете ознакомиться со списком популярных и проверенных интернет-сервисов, где достаточно перейти по ссылке и отправить смс на любой номер телефона:

• smstools.online;
• world-sms.org;
• smscat.ru.

Это прямые ссылки на сайты, где достаточно вставить адрес в строку поиска и перейти сразу к форме заполнения номера телефона и текста. Также вы можете ознакомиться с другими сайтами для бесплатной отправки смс с компьютера через интернет-браузер:

• mySMSBox;
• SMSFi;
• Messagebird;
• FullonSMS;
• Skebby.

Если у вас возникла временная необходимость отправить сообщение на номер мобильного телефона через компьютер, тогда можно не прибегать к методу с установкой специальной программы. А вот если вы хотите общаться на постоянной основе с ноутбука или ПК, тогда удобнее всего скачать и авторизоваться в Вайбере, тем более, что параллельно вам будут доступны и другие полезные функции.

Похожие вопросы

Как сделать рассылку в вайбере (Viber)

Viber обладает явными преимуществами по сравнению с SMS, в числе которых использование большего объема текста, возможность добавления изображений и кликабельных ссылок. Кроме того, стоимость таких вместительных уведомлений ниже, что позволяет рационально использовать бюджет.

Важно!

Прежде чем создавать рассылки в вайбере, получите имя отправителя. Подайте заявку в личном кабинете eSputnik и делайте рассылки вайбер самостоятельно.

Как получить имя отправителя Viber

Для получения имени отправителя (Sender ID), которое будет отображаться вместо вашего номера телефона, воспользуйтесь любым из трех способов:

1. Зайти в Сообщения — Сообщения — Viber и нажать Создать Viber:

Перед вами откроется редактор нового сообщения. В поле отправителя нажмите кнопку “Добавить”.  Затем появится всплывающее окно.

Нажмите на кнопку “Заявка на подключение”. У вас автоматически откроется чат, где вы сможете получить детальную информацию и обсудить подключение отправителя. Начните с отправки запроса “Я хочу отправлять Viber сообщения”.

2. Перейдите в Настройки — Отправители. Выберите раздел Viber и нажмите “Добавить отправителя”

Перед вами откроется окно, где вы сможете добавить как уже зарегистрированного отправителя, так и получить новое имя.

Чтобы добавить нового отправителя Viber, выберите пункт “Я хочу зарегистрировать нового отправителя” и нажмите на кнопку “Связаться с отделом продаж”:

После этого откроется чат, где специалисты подскажут вам, как зарегистрировать нового отправителя и как правильно сделать первую рассылку в вайбере.

3. Вы можете запросить анкету для подачи заявки, обратившись на почту в отдел продаж: sales@esputnik. com.

Утверждение имени отправителя занимает от двух до четырех недель.

Подробнее о добавлении имени отправителя >>

Создание Viber-сообщения

Чтобы создать viber рассылку своими руками, сначала подготовьте сообщение. Перейдите в раздел “Сообщения”. Выберите канал Viber и нажмите кнопку “Создать Viber”.

Откроется редактор сообщений:

Добавьте название

Так вам будет удобнее найти сообщение в общем списке. Получатель не увидит это название.

Добавьте метки

Метки нужны для удобного поиска и фильтрации сообщений в общем списке. А также для использования их в стратегии частоты рассылок. Если вы задаете новую метку, после ввода нажмите Enter, чтобы добавить ее в созданный список.

Напишите текст сообщения

Добавьте в специальное поле текст, который будет виден в вашем сообщении. Что можно использовать в этом поле:

• текст до 1000 символов,

• смайлики и спецсимволы,

• кликабельные ссылки, что обеспечит дополнительные переходы на сайт и позволит получателю сразу узнать подробности акции или характеристики товара,

• кликабельный номер телефона —  нажав на него, сразу можно совершить звонок,

• персонализацию по любым данным, которые хранятся у ваших контактов в системе eSputnik.

Добавьте изображение

Кликните на блок “Изображение”, чтобы загрузить картинку. Обратите внимание: изображение в формате JPEG или PNG должно быть до 2МБ и может быть любого размера.

Добавьте кнопку и ссылку

Создайте кнопку с призывом и присвойте ей ссылку на нужную страницу.

Уведомления для iOS

Это уведомление, которое высветится пользователю Viber, если сообщение будет доставлено после истечения времени его активности:

Прим. На данный момент функциональность устаревшая и не поддерживается вайбером.

Время активности сообщения

Уведомление о сообщении Viber исчезает через 24 часа после отправки, но можно настроить и меньше. Поэтому данный канал хорошо подходит для оповещения клиентов об акциях с ограниченным периодом действия.

Категории подписки (подключаются по запросу)

Используя категории подписки вы будете знать, каким подписчикам какие письма и уведомления отправлять в соответствии с их ожиданиями и интересами. Тем самым можно предотвратить выгорание базы.

Используйте их, чтобы отправлять сообщения клиентам согласно их интересам:

Чтобы подключить категории подписки, обратитесь в службу поддержки: [email protected]. Эта функциональность бесплатна.

UTM-метки

Если вы активируете эту настройку, к вашим ссылкам будут автоматически добавляться UTM-метки. При желании можно отключить настройку и добавить метки к URL вручную.

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

Внешний вид сообщений может отличаться в зависимости от операционной системы. В окне предпросмотра можно переключиться между вкладками Android и IOS, чтобы оценить внешний вид сообщения.

Использование мультиязычности (подключается по запросу)

Мультиязычность — это возможность создавать сообщения на разных языках в рамках одной рассылки. Чтобы воспользоваться данной функцией, нажмите на иконку мультиязычности в редакторе сообщений:

Выберите язык основного сообщения:

После добавьте языковую версию:

После этого становится доступным добавление дополнительных языковых версий:

При добавлении языковой версии создается копия того сообщения, которое активно в редакторе на данный момент. Так, если у вас открыто сообщение на польском, то добавится полностью идентичное сообщение, а не копия основной версии. Это упрощает работу с похожими языками. Для переключения между версиями воспользуйтесь выпадающим списком. Существующую языковую версию можно заменить или удалить:

Чтобы подключить мультиязычность или получить демо по функциональности, обратитесь в отдел продаж: [email protected].

Перейдите к рассылке

Есть три варианта действий после того, как вы создали сообщение в редакторе. Вы можете:

1. Протестировать — указать номер телефона и отправить на него тест сообщения, не выходя из редактора.

2. Cохранить и выйти — сообщение сохранится в аккаунте, и вы сможете вернуться к его редактированию. 

3. Создать рассылку — перейти к отправке текущего сообщения. Система не даст этого сделать, если не заполнены обязательные поля, например, не указано название сообщения или отправитель.

Если вы выбираете “Создать рассылку”, то система предлагает выбрать группы, отметив галочками нужные сегменты из списка.

Выбрав группы, вы можете стартовать рассылку немедленно или запланировать отправку на определенное время.

Триггерные сообщения

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

Откройте триггеры

1. Вкладка “Триггеры”,

2. Выбрать “Сценарии”,

3. Нажать на “Новый сценарий”

Создайте сценарий

Запустим базовый сценарий, который состоит из набора трёх простых блоков:

1. Начало.

2. Viber.

3. Окончание.

Для первого и третьего блока задавать условия не нужно. В параметрах блока “Viber” обязательно выберите сообщение, которое вы подготовили для уведомления:

К сценарию нужно будет подвязать событие, которое даст сигнал, что триггер пора запускать. Вы можете выбрать существующее событие и привязать его к нужному сценарию в разделе Триггеры — Сценарии. Если необходимо новое событие, перейдите в Триггеры — Типы событий и нажмите кнопку “Добавить тип события”:

где Связанный сценарий — триггер Viber-рассылки с уведомлением о доставленном заказе.

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

Как автоматически отправить SMS тем, у кого нет Viber?

В случае, когда при отправке рассылки вы получаете статус ошибки, что у этого подписчика вайбер не установлен, вы можете запустить на такие контакты СМС-рассылку.

Чтобы продолжить коммуникацию и сообщить подписчику важную информацию, добавьте к цепочке в сценарии следующие блоки:

1. Таймер;

2. Проверку «Доставлено»;

3. Отправку SMS-сообщения.

В таймере после отправки рекомендуем указывать ожидание не менее чем 35 минут, так как минимальный срок жизни сообщения — 30 минут. После этого времени все номера, у которых нет приложения вайбер, попадут в ошибки, а проверка поведет их по ветке “Нет” и отправит смс. Чем больше минут указано в таймере, тем большему количеству людей мессенджер Viber сможет доставить сообщение.

Важно: Если в блоке «Таймер» вы укажете значение менее 30 минут, подписчик может получить два сообщения: и Viber, и sms.

Раздел Отчеты

После того как рассылка начнёт отправляться (вручную или как триггер) — за ней можно будет следить во вкладке «Рассылки» — «Отчёты» — «Viber».

В разделе «Массовые» отображаются рассылки, которые отправлены на группы контактов. Если рассылка происходит в данный момент, то статус ее прогресса будет виден вверху списка массовых рассылок. В разделе «Триггерные» показываются рассылки, отправленные автоматически.

Чтобы сравнить эффективность рассылок, в правом верхнем углу выберите “Отображение” и активируйте переключатель “Выделить лучшие и худшие рассылки”. Зелёным подсветятся лучшие результаты, а красным — худшие. Расчеты производятся в пределах одной страницы отчета.

Чтобы посмотреть эффективность одной рассылки, кликните на неё в общем списке отчетов.

При клике на любой из показателей перед вами откроется окно для просмотра соответствующих контактов.

Нажав на кнопку “Экспорт” вы сможете выгрузить контакты:

• в новую группу,

• csv-файлом к себе на почтовый адрес, который используется для логина в системе.

Протестируйте на реальных рассылках

Попробовать

Инструкция по отправке каскадных рассылок Вайбер+СМС из личного кабинета

После согласования официального канала рассылок Вайбер Вам будут доступны как обычные Вайбер рассылки, так и каскадные Вайбер+SMS:

1. Изличного кабинета рассылок sms.targetsms.ru
2. По API

В данной инструкции подробно остановимся на отправке Вайбер рассылок из личного кабинета рассылок sms.targetsms.ru.

Итак, после регистрации канала в Вашем личном кабинете рассылок sms.targetsms.ru появится меню Вайбер, которое содержит следующие подпункты (см. скриншот ниже):

1. Отправка Вайбер сообщений
2. Запланированные рассылки Вайбер
3. Вайбер сообщения ожидающие оплаты
4. Общая статистика Вайбер
5. Детальная статистика Вайбер
6. Сгенерированные отчеты

1.

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

Данный пункт меню позволяет осуществить рассылку Вайбер рассылки.

Важно:

1. Отправка сообщений будет осуществлена только абонентам Вайбер (проверка автоматическая и бесплатная)
2. Оплате подлежат все сообщения, отправленные абонентам Вайбер (не подлежат оплате сообщения, отправленные абонентам, не зарегистрированных в сервисе Вайбер)

2.Для отправки Вайбер-рассылки нужно в форме рассылки:

1. Выбрать имя отправителя из селектора «Отправителель» (там находятся все согласованные Вами имена)
2. Ввести текст рассылки (до 1000 символов). Счетчик символов и сообщений покажет количество введенных символов. При необходимости можно использовать параметры персонификации текста сообщения (инструкция по отправке персонифицированных текстов сообщений тут)
3. При необходимости можно перевести текст сообщения в транслит, нажав кнопку «Транслитерация».
4. Опционально можно добавить кликабельную кнопку, указав ее название до 19 символов включительно (например, ПОДРОБНЕЕ) и ссылку на web-страницу, куда абонент будет перенаправлен при нажатии на кнопку «ПОДРОБНЕЕ» (например, https://targetsms.ru — формат URL важен).
5. Также можно добавить в сообщение картинку (допустимые форматы: png и jpg. Максимальный размер изображения: 1000×1000 пикселей (изображение будет автоматически масштабировано). Максимальный «вес» изображения: 1 МБ.
6. В поле «Настройки планировщика рассылки» можно задать время начала и конца рассылки (в том числе по локальному времени получателей; в том числе плавную рассылку).
7. В «Дополнительных настройках можно задать название рассылки и указать время жизни сообщения (до 72 часов. ВАЖНО: если отправляется каскадная рассылка, то нужно задать время жизни сообщения 1 час).
8. Справа от формы ввода текста нужно выбрать получателей рассылки (из ранее загруженной базы, из файла или из введенных вручную или из буфера отмена номеров).
9. После завершения заполнения формы создания рассылки нажмите кнопку «Отправить», которая находится в низу формы, и подтвердите отправку рассылки, нажав еще раз кнопку «Отправку».

Полностью сформированное Вайбер сообщение на телефонном аппарате абонента может выглядеть таким образом:

3.Для отправка каскадной рассылки Вайбер+SMS нужно:

1. Сформировать Вайбер-рассылку, как описано в инструкции выше
2. Выбрать срок жизни Вайбер 1 час
3. Заполнить форму отправки СМС в пункте «Переотправка через SMS»: выбрать имя отправителя из селектора и ввести текст СМС-сообщения.

Статистика отправленных сообщений доступна в разделах «Общая статистика Вайбер» и «Детальная статистика Вайбер».

4.Дополнительный функционал каскадных рассылок Вайбер+SMS:

1. Очистка баз рассылок от неактивных абонентов
2. Отправка персонифицированных сообщений
3. Отправка отложенных рассылок

Отправка сообщения через viber с подменой номера. Как с компьютера отправить сообщение на вайбер

Мы живем в замечательное время – сегодня связаться с близкими, живущими на другом конце света, и мгновенно получить ответ стало легче легкого – благодаря интернету и категории приложений, именующихся мессенджерами (от английского слова messenge – сообщение). Они позволяют обмениваться текстовыми сообщениями, фотографиями и видео, понравившимися ссылками, создавать групповые чаты и совершать видеозвонки из любой точки мира. Едва ли не самый популярный мессенджер среди россиян – приложение под названием Viber (Вайбер).

Общение будет полностью бесплатным при условии, что у собеседника на смартфоне также установлен Viber. Передача голосового трафика будет происходить посредством интернета на телефоне (то есть, потребуется оплата за интернет-трафик по тарифу вашего мобильного оператора). А при наличии Wi-Fi и за трафик платить не придётся.

Основные преимущества Viber

Высокое качество связи и чёткость звука;
Возможность совершения звонков по всему миру без затрат;
Существенная экономия батареи;
Удобный и интуитивно понятный интерфейс;
Отсутствие необходимости в авторизации;
Возможность шифрования переписки.

Первоначальная разработка приложения Viber (Вайбер) происходила в Минске двумя гражданами Израиля. Представленная на суд широкой публике в 2010 году программа завоевала популярность, которая неуклонно возрастает.

Как установить Вайбер?

Установка Вайбер может производиться из магазина приложений в мобильном устройстве, либо с официального сайта приложения. После нажатия кнопки «Get viber», приложение начнёт скачиваться, и запустится его установка. Установка Вайбера производится как на телефон, так и на компьютер. На планшетах и смартфонах программа Вайбер представлена на русском языке, а на ПК — на английском.

Как установить Viber на телефон и как им пользоваться?

Как пользоваться Вайбером

Интерфейс программы настолько прост, что разобраться в нём за несколько минут можно любому. После этого можно начинать совершать звонки при помощи соединения Wi-Fi или 3G. За звонки на обыкновенные телефонные номера будет взиматься плата, аналогичная Скайпу.

Вайбер на телефоне.

Установка приложения Вайбер предусмотрена на смартфонах на базе Android, BlackBerry OS, iOS, Windows Phone, Symbian, Bada, Windows, OS X, Linux и даже плееров iPOD. На смартфонах Nokia на базе ОС Symbian и обычных телефонах мессенджер не поддерживается.

Как установить Viber на компьютер

Вайбер на компьютере.

Помимо телефона или планшета, приложение Вайбер, может быть установлено на ноутбук или стационарный ПК. В отличие от Skype, предоставляющего современную и доступную видеосвязь, Вайбер символизирует голосовую коммуникацию.
Сначала приложение нужно установить на смартфоне, и только потом уже на компьютере. Потребуется ввести собственный номер, и активировать его, при помощи кода подтверждения, пришедшего на смартфон.

Основное меню Viber

1. Контакты автоматически переносятся с телефона в приложение. Контакты друзей и знакомых, у которых установлена программа, проявляются мгновенно.

2. Чат Viber отличается замечательным визуальным оформлением. По своему усмотрению и настроению можно менять фон. При помощи стикеров, забавных изображений, точнее передаются эмоции, а сообщение становится ярче.
Очень полезна функция в виде аудио сообщения. Также можно отправлять нарисованное. Общаться в чате можно с несколькими собеседниками сразу. Для этого предусмотрена иконка человечка со знаком «+», на которую следует нажать.

3. Звонки.

● Аудиозвонки
в Вайбере следует подразделить на два типа:

1. Бесплатные (телефон подключен к сети Internet)
Совершаются между пользователями Вайбер, подключенными к интернету. Замечательная экономия посредством бесплатной связи.

2. Платные (на номера телефонов) — звонки по Вибер Аут

Если вышеназванных условий не имеется, то звонки на телефоны (стационарные или мобильные) обойдутся совсем недорого. Для этого применяется специальное приложение Viber Out, требующее пополнения счёта.

● Видеозвонки.
Если очень важно не просто слышать, но и видеть своего собеседника, лучшим выходом станет звонок по видеосвязи. Качество картинки будет на уровне, даже, если интернет несколько замедлен.

WhatsApp или Viber

У каждой из этих программ есть свои плюсы и минусы, но если говорить о бесплатных звонках, то WhatsApp подобной возможности не предоставляет, хоть и незаменим для переписки. Гениально простая и фантастически удобная — именно такой является программа Viber (Вайбер)! Она обеспечит существенную экономию средств на звонках и SMS. Для звонков через Viber необходим лишь доступ к интернету.

Популярность программы Viber растет с каждым днем и все больше людей устанавливают себе вайбер на телефон или компьютер. Вполне закономерно, что у многих возникает вопрос: «Как пользоваться Вайбером?». Сегодня мы постараемся подробно рассмотреть все основные возможности и функции данной программы. На сегодняшний день существует несколько версий Viber для различных устройств: для смартфона, вайбер для компьютера или ноутбука, для планшета, но больших различий между ними нет.

Контакты в Вайбер

При первом подключении к сети, программа сразу же проверит Ваш список контактов и автоматически скопирует его в собственную адресную книгу. Также будет определено, кто из знакомых или друзей уже зарегистрирован и использует вайбер. Если Вы добавили вручную контакт в версии для компьютера, то при использовании смартфона произойдет автоматическая синхронизация списка контактов и Вы сможете звонить новым друзьям.

Иногда гораздо приятнее увидеть собеседника и поговорить с ним. Программа позволяет, как в скайпе, осуществить видео звонок, качество изображения при этом очень хорошее, даже при медленном интернете. Более того в Вайбер эта функция реализована очень удобно, интерфейс приятный, а качество видео изображения как уже говорилось на высоте.
Надеемся, что Вам статья понравилась и теперь вы уже знаете какие важные функции есть в Вайбере и как ими пользоваться.

Теперь без проблем сможете звонить и общаться с знакомыми, коллегами, друзьями при помощи Интернета. А для более наглядной демонстрации возможностей Viber посмотрите видео инструкцию.

относится к категории универсальных мессенжеров, с помощью него осуществляется общение между пользователями из различных стран мира. Очень часто случается такое, что у человека возникают трудности при использовании Вайбера. В данном случае вам готова помочь служба поддержки Вайбер. Здесь вы найдете ответы на все ваши вопросы.

Особенности работы

Служба поддержки – это команда высококвалифицированных специалистов, которые знают все о мессенжере. Они готовы выслушать пользователя.

В ходе общения специалисты задают сопутствующие вопросы, что позволяет им максимально точно установить причины ошибок. Задать интересующий вопрос можно методом написания комментария или в FAQ. Независимо от способа обращения клиент получит ответ в течение нескольких часов. Чем чаще пользователи обращаются в техподдержку, тем больше усовершенствуется и обновляется мессенжер. С помощью технической поддержки человек может исправить любую ошибку.

Техподдержка Вайбер рассматривает все вопросы клиентов. Даже если вы думаете, что ваш вопрос бессмысленный, не стесняйтесь. Обращайтесь в техподдержку, вам обязательно ответят на все интересующие вопросы.

Как обратиться в техподдержку?

Для того чтобы подать обращение в техническую поддержку, необходимо воспользоваться сайтом support Viber com
. Для этого необходимо всего лишь зарегистрироваться на сайте и заполнить соответствующую форму. Также для обращения в техническую поддержку можно написать письмо на электронную почту. Вы можете задавать вопросы по поводу установки мессенжера и его настроек. Если во время работы приложения возникают ошибки или наблюдается блокировка номера, тогда необходимо создать тикет в Вайбере. Для этого необходимо зайти на официальный сайт технической поддержки.

Перед вами откроется форма, в которой в обязательном порядке необходимо указать:

• Тему запроса;
• Номер телефона;
• Страну;
• Номер электронной почты.

Также в форме необходимо описать проблему, с которой вы столкнулись. Если у вас возникнет необходимость, то к указанной информации вы можете прикрепить файл. После заполнения всех полей нужно отправить форму. Ответ от представителя технической поддержки придет в максимально короткие сроки. Для того чтобы специалисты как можно быстрее рассмотрели ваш вопрос, необходимо максимально точно задать тему запроса.

Вайбер – это достаточно популярный сервис, который использует огромное количество людей. Но в большинстве из них возникают проблемы с использованием мессенжера. Для их максимально быстрого и эффективного решения необходимо обратиться в техническую поддержку.

Здесь работают опытные сотрудники, которые готовы ответить на любой вопрос и решить задачи различной сложности. Служба поддержки работает круглосуточно, что позволяет клиентам получать ответы на свои вопросы в любое время суток. Предоставляется услуга совершенно бесплатно, что позволяет ней воспользоваться любому клиенту.

Программы связи через интернет часто используются владельцами смартфонов, которые работают на операционной системы Android и iPhone. Подобный вариант соединения, когда не используются услуги оператора, позволяет значительно сэкономить на разговорах и переписке. Именно поэтому многие интересуются о том, как переслать сообщение в Вайбере?

Особенности функции

Функция передачи сообщений присутствует во многих подобных программах, и в каждом случае возможность обмена сообщений реализуется разными способами. Ведь при создании подобной функции учитываются различные особенности: защита данных, скорость передачи, возможность работы в групповом чате и многое другое. Программа стала пользоваться большой популярностью именно из-за того, что все функции реализованы качественно. При этом нет сбоев работы.

Какой тип информации можно передавать?

Для того чтобы понять особенности работы программы отметим возможность передачи следующей информации:

• Текстового сообщения.
• Медиа-файлы. К ним можно отнести фото, видео, другие файлы.
• Смайлы – часто используются для отображения чувств.
• Местоположение. В последнее время стало популярно указывать место, в котором были сделаны фотографии или видео. Также местоположение указывается в других случаях. Для указания местоположения приложение синхронизируется с GPS телефона, и происходит указание координат в сообщении.
• Стикеры – фишка приложения Viber, которая пользуется популярностью. Стикерами называют приложения, которые используются в качестве смайлов, фоновой заставки и в других случаях.

Вышеперечисленный список состоит из информации, которая может передаваться любыми пользователями приложения Viber.

Процесс передачи

При поиске информации того, как в Вибере переслать сообщение другому контакту, следует обратить внимание на следующие моменты:

• Оно может отсылаться конкретному пользователю программы, в закрытый или публичный чат.
• Для отправки следует выбрать контакт и соответствующую функцию.
• Для того чтобы отправить файл из операционной мобильной системы следует нажать на то, что следует передать, после чего выпадет функция «переадресовать через Viper».
• После того как файл для передачи был выбран указываем то, кто станет получателем. Контакты могут быть взяты из записной книжки телефона, так как программа синхронизируется с мобильной операционной системой.

Таким образом, можно передать любой файл пользователю программы.

Когда-то мы рассказывали про «Скрытые чаты в Вайбере». Но недавно в Viber появилась еще одна интересная функция связанная с тематикой нашего сайта. А именно возможность отправить исчезающие сообщения Viber. В этой статье я расскажу в каких ситуациях может понадобиться эта фишка и как ее использовать.

До того как мы перейдем к инструкции хотелось бы вам порекомендовать статью «Проверка APK», в которой мы рассказывали как проверять приложения на вирусы и уязвимости, до их установки на телефон или планшет.

• Предисловие
• Как отправить исчезающие сообщения Viber
• Выводы

Зачем нужны самоудаляющиеся сообщения в Viber?

Представьте себе ситуацию, вам нужно отправить какой-либо важный документ, вы его фотографируете и посылаете собеседнику через Вайбер. Получатель открывает его, просматривает, а потом этот самый документ, скан или фотография личного плана еще долго будут валятся у этого человека на телефоне в галерее и что еще хуже может попасть в руки посторонних людей.

Обратите внимание. Просто отправить текст не получится. Разработчики Вайбера дают возможность отправлять только исчезающие фотографии и видеоролики. Но вы же понимаете, фотку можно засунуть любую, например скаченную из сети, и подписав ее необходимым текстом, сделать исчезающее сообщение.

Как отправить исчезающие сообщения Viber

1. В чате Вайбера в нижней части экрана нажмите на иконку фотоаппарата.

2. Сфотографируйте или выберите из галереи нужное фото или видео.

3. В нижнем левом углу нажмите на иконку в виде перечеркнутого кружочка (бомбы). На iPhone эта иконка будет находится в левом верхнем углу.

4. Выберите время после открытия которого сообщение будет удалено.

5. Иконка кружочка отобразит установленное вами время уничтожения сообщения. После чего нажмите на иконку отправления.

Теперь, после того как собеседник просмотрит сообщение, через несколько секунд оно удалится.

Отменить данную операцию или изменить настройки времени вы можете только до того как получатель откроет сообщение. Для этого просто тапните по отправленному сообщению и выберите необходимый пункт.

Выводы

В принципе это довольно полезная функция. Пользователь, которому вы послали самоудаляющиеся сообщения, не сможет сохранить пришедший к нему контент.

Но имейте ввиду, собеседник всегда сможет снять скрин экрана до того как сообщение самоудалилось. Ведь делать это умеет любой владелец мобильных устройств, без установки дополнительных приложений, встроенной функцией телефона как на Android, так и на iOS.

Если вы являетесь владельцем Андроид-устройства и до сих пор не используете фаервол, тогда я очень рекомендую прочитать статью про защиту телефона от слежки с помощью бесплатного брандмауэра для Android.

Оценка функции «Исчезающие сообщения Вайбер»

Самоудаляющиеся сообщения в Вайбере — это лучше чем нечего, но имеет свои недостатки.

Исчезающие сообщения Viber. Как отправить самоудаляющиеся сообщения в Вайбер

Когда-то мы рассказывали про «Скрытые чаты в Вайбере». Но недавно в Viber появилась еще одна интересная функция связанная с тематикой нашего сайта. А именно возможность отправить исчезающие сообщения Viber. В этой статье я расскажу в каких ситуациях может понадобиться эта фишка и как ее использовать.

До того как мы перейдем к инструкции хотелось бы вам порекомендовать статью «Проверка APK», в которой мы рассказывали как проверять приложения на вирусы и уязвимости, до их установки на телефон или планшет.

Исчезающие сообщения Viber

Содержание

• Предисловие
• Исчезающие сообщения Viber
• Как отправить исчезающие сообщения Viber
• Выводы

Зачем нужны самоудаляющиеся сообщения в Viber?

Представьте себе ситуацию, вам нужно отправить какой-либо важный документ, вы его фотографируете и посылаете собеседнику через Вайбер. Получатель открывает его, просматривает, а потом этот самый документ, скан или фотография личного плана еще долго будут валятся у этого человека на телефоне в галерее и что еще хуже может попасть в руки посторонних людей.

Обратите внимание. Просто отправить текст не получится. Разработчики Вайбера дают возможность отправлять только исчезающие фотографии и видеоролики. Но вы же понимаете, фотку можно засунуть любую, например скаченную из сети, и подписав ее необходимым текстом, сделать исчезающее сообщение.

Как отправить исчезающие сообщения Viber

1. В чате Вайбера в нижней части экрана нажмите на иконку фотоаппарата.

2. Сфотографируйте или выберите из галереи нужное фото или видео.

3. В нижнем левом углу нажмите на иконку в виде перечеркнутого кружочка (бомбы). На iPhone эта иконка будет находится в левом верхнем углу.

4. Выберите время после открытия которого сообщение будет удалено.

5. Иконка кружочка отобразит установленное вами время уничтожения сообщения. После чего нажмите на иконку отправления.

Теперь, после того как собеседник просмотрит сообщение, через несколько секунд оно удалится.

Отменить данную операцию или изменить настройки времени вы можете только до того как получатель откроет сообщение. Для этого просто тапните по отправленному сообщению и выберите необходимый пункт.

Выводы

В принципе это довольно полезная функция. Пользователь, которому вы послали самоудаляющиеся сообщения, не сможет сохранить пришедший к нему контент.

Но имейте ввиду, собеседник всегда сможет снять скрин экрана до того как сообщение самоудалилось. Ведь делать это умеет любой владелец мобильных устройств, без установки дополнительных приложений, встроенной функцией телефона как на Android, так и на iOS.

Если вы являетесь владельцем Андроид-устройства и до сих пор не используете фаервол, тогда я очень рекомендую прочитать статью про защиту телефона от слежки с помощью бесплатного брандмауэра для Android.

Наша оценка

Самоудаляющиеся сообщения в Вайбере — это лучше чем нечего, но имеет свои недостатки.

User Rating:
3.85
( 18 votes)

Viber REST API | Центр разработчиков Viber

Начало работы

Для реализации API вам потребуется:

1. Активная учетная запись Viber на платформе, которая поддерживает ботов (iOS / Android). Эта учетная запись будет автоматически назначена администратором учетной записи в процессе создания учетной записи.
2. Активный бот — Создайте бота здесь.
3. Токен аутентификации учетной записи — уникальный идентификатор учетной записи, используемый для проверки вашей учетной записи во всех запросах API.Как только ваша учетная запись будет создана, ваш токен аутентификации появится на экране «Изменить информацию» учетной записи (только для администраторов). Каждый запрос, отправленный в Viber учетной записью, должен содержать токен.
4. Настройка веб-перехватчика учетной записи — это необходимо сделать один раз в процессе настройки учетной записи, чтобы определить веб-перехватчик и тип ответов, которые вы хотите получать.
   Для реализации API вам потребуется:

Поддерживаемые платформы

Боты в настоящее время поддерживаются на устройствах iOS и Android с Viber версии 6.5 и выше и на компьютере с версии 6.5.3.

Важные примечания для разработчиков ботов:

1. Бот-платформа Viber открыта, и разработчики могут бесплатно создавать ботов в нашей экосистеме.
   После того, как вы создали своего бота, вы можете поделиться им со своими контактами в Viber или продвигать его за пределами Viber на своем веб-сайте или в социальных сетях с помощью deeplink. Обратите внимание, что Viber не несет ответственности за продвижение вашего бота, и что по умолчанию у вашего бота не будет активной целевой страницы в Viber.com после создания. Включение этого URL-адреса является частью платных услуг, которые мы предлагаем официальным партнерам. Точно так же после создания вашего бота он не будет отображаться в результатах поиска в Viber, и включение этого также является частью платных услуг, которые мы предлагаем официальным партнерам.
   Если вы хотите обсудить партнерское соглашение или узнать больше о платных каналах для продвижения вашего бота в Viber, отправьте электронное письмо по адресу [email protected] и укажите данные своей компании, включая страну вашей компании.
2. Мы рекомендуем вам записывать идентификатор подписчика для каждого подписчика, поскольку у вашего бота нет API для получения всех идентификаторов подписчиков.Вы можете найти идентификатор подписчика в свойстве sender.id обратного вызова Message или в свойстве user.id обратного вызова с подпиской. Вы можете увидеть, подписан ли пользователь, в параметре subscribed callback-функции talk_started.
   Обратите внимание, что первое сообщение пользователей боту заставит их подписаться, но не приведет к обратному вызову с подпиской.
3. Если вы хотите отправлять сообщения пользователям по их номерам телефонов и с помощью API, мы предлагаем услугу Business Messages, которая поддерживает это.Заявка на использование этой услуги оформляется через одного из наших официальных партнеров.
   Вы можете увидеть, какие партнеры охватывают ваш географический регион, в их описании по ссылке выше. Наши партнеры смогут предоставить вам более подробную информацию об услуге, например о ценах.

Поток сообщений отправки и получения

Следующая диаграмма описывает поток отправки и получения сообщений учетной записью. Все запросы API и обратные вызовы, упомянутые на схеме, будут объяснены позже в этом документе.

Маркер аутентификации

Маркер аутентификации (также известный как ключ приложения) — это уникальный и секретный идентификатор учетной записи. Он используется для аутентификации запроса в Viber API и предотвращения отправки запросов посторонними лицами от имени бота. Каждый запрос API должен включать HTTP-заголовок X-Viber-Auth-Token , содержащий токен аутентификации учетной записи.

HTTP-заголовок

  X-Viber-Auth-Token: 445da6az1s345z78-dazcczb2542zv51a-e0vc5fva17480im9  

Токен аутентификации генерируется при создании бота и может быть просмотрен администраторами учетной записи на экране «Изменить информацию» своего бота или в панели администратора Viber. .

Примечание. Отказ отправить маркер аутентификации в заголовке приведет к ошибке с сообщением missing_auth_token .

Веб-перехватчики

Получив токен, вы сможете настроить веб-перехватчик своей учетной записи. Этот веб-перехватчик будет использоваться для получения обратных вызовов и сообщений пользователей от Viber.

Настройка веб-перехватчика будет выполняться путем вызова set_webhook API с действующим и сертифицированным URL-адресом.Это действие определяет веб-перехватчик аккаунта и тип событий, о которых аккаунт хочет получать уведомления.

По соображениям безопасности будут разрешены только URL-адреса с действующим и официальным сертификатом SSL от доверенного центра сертификации. Сертификат CA должен быть в списке доверенных корневых сертификатов Sun Java.

После отправки запроса set_webhook Viber отправит обратный вызов веб-перехватчику, чтобы проверить его доступность и вернуть ответ пользователю. Проверка проходит успешно, если сервер Viber получает статус HTTP 200 в ответ на обратный вызов, но не проходит, если получает любой другой статус.Если ваш ответ set_webhook не имеет "status": 0 , убедитесь, что все запросы к URL вашего веб-перехватчика получают в ответ HTTP-статус 200.

Обратите внимание, что как только вы установите веб-перехватчик, общение один на один с вашей учетной записью станет доступно. Чтобы отключить беседу один на один с вашим аккаунтом, вам нужно удалить веб-перехватчик — см. Раздел об удалении веб-перехватчика ниже.

API

Viber позволяет получать имена пользователей и фотографии. Он был обновлен, чтобы соответствовать законам о конфиденциальности и позволить разработчикам, которые не используют имена пользователей и фотографии в рамках своих услуг, отказаться от участия.Если вы не используете фотографии с именами пользователей, откажитесь от значений по умолчанию.

Чтобы установить запрос, передайте флаги send_name и send_photo с запросом set_webhook .

Примечание: Эта функция будет работать, если пользователь разрешил «Персонализацию содержимого» (Подробнее → Конфиденциальность → личные данные). Если пользователь запретил персонализацию контента, вы получите значения заполнителей.

Настройка веб-перехватчика

URL ресурса

  https: // chatapi.viber.com/pa/set_webhook  

Данные публикации

  {
   "url": "https://my.host.com",
   "event_types": [
      "доставлен",
      "видимый",
      "не смогли",
      "подписан",
      "отписался",
      "разговор начался"
   ],
   "send_name": правда,
   "send_photo": правда
}  

Параметры поста

Требуется

Установить ответ веб-перехватчика

  {
   «статус»: 0,
   "status_message": "хорошо",
   "event_types": [
      "доставлен",
      "видимый",
      "не смогли",
      "подписан",
      "отписался",
      "разговор начался"
   ]
}  

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

Фильтрация типов событий

Параметр event_types позволяет учетным записям выбирать, для каких событий они будут получать обратный вызов.
Следующие события являются обязательными и не могут быть отфильтрованы: сообщение , подписан и отписан .
Следующие события могут быть отфильтрованы во время запроса set_webhook : доставлено , просмотрено , не удалось и talk_started .
Отправка запроса set_webhook без параметра event_types означает получение всех событий.
Отправка set_webhook запроса с пустым event_types list ("event_types": []) означает получение только обязательных событий. См. Раздел обратных вызовов для получения полной информации о событиях обратных вызовов.

Установить обратный вызов веб-перехватчика

Для каждого запроса set_webhook Viber отправит обратный вызов на URL-адрес веб-перехватчика, чтобы подтвердить его доступность. Ожидаемый HTTP-ответ на обратный вызов — 200 OK — любой другой ответ будет означать, что веб-перехватчик недоступен. Если веб-перехватчик недоступен, ответ set_webhook , отправленный пользователю, будет иметь статус 1: invalidUrl.

Данные обратного вызова

  {
   "событие": "перехватчик",
   "отметка времени": 1457764197627,
   «message_token»: 241256543215
}  

Параметры обратного вызова

Удаление веб-крючка

После того, как вы установите веб-перехватчик для своего бота, появится кнопка беседы один на один, и пользователи смогут получить к ней доступ.
В настоящее время нет возможности отключить беседу один на один в настройках бота, поэтому, чтобы отключить эту опцию, вам нужно удалить веб-перехватчик, который вы установили для учетной записи. Удаление веб-перехватчика выполняется путем отправки запроса set_webhook с пустой строкой веб-перехватчика.

URL ресурса

  https://chatapi.viber.com/pa/set_webhook  

Данные публикации

  {
   "url": ""
}  

Параметры поста

Требуется

.

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

send_message API позволяет учетным записям отправлять сообщения пользователям Viber, которые подписаны на учетную запись. Отправка сообщения пользователю будет возможна только после того, как пользователь подписался на бота. (см. обратный звонок с подпиской для получения дополнительной информации). Вы можете поделиться своим ботом с пользователями через deeplink.

API поддерживает различные типы сообщений: текст , изображение , видео , файл , местоположение , наклейка , контакт , контент карусели и URL . Ниже приведены конкретные примеры данных сообщений и необходимые параметры для каждого типа сообщений.

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ.

Может отправлять до 100 сообщений пользователю в час (XX: 00-XX: 00) без ответа, счетчик сообщений до предела сбрасывается, когда пользователь отвечает на сообщение.Как только предел будет достигнут, вы получите обратный вызов об ошибке:

  {"status": 12, "status_message": "превышено максимальное количество сообщений от общедоступного аккаунта пользователю Viber без ответа.", "Message_token": XXXXXXXXXXXXXXXXXXX, "chat_hostname": "SN-CHAT-0x_"}  

Ресурс URL

  https://chatapi.viber.com/pa/send_message  

Общие параметры отправки сообщения

Для всех типов сообщений доступны следующие параметры:

Требуется

Требуется

Типы сообщений

Ниже приведен список всех поддерживаемых типов сообщений с примерами данных сообщений.

Текстовое сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "текст",
   "text": "Привет, мир!"
}  

Параметры поста

Требуется

Требуется

Графическое сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "картинка",
   "text": "Описание фото",
   "media": "http: // www.images.com/img.jpg ",
   "thumbnail": "http://www.images.com/thumb.jpg"
}  

Параметры поста

Требуется

Требуется

Требуется

Видео сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "видео",
   "media": "http://www.images.com/video.mp4",
   "thumbnail": "http://www.images.com/thumb.jpg",
   «размер»: 10000,
   «продолжительность»: 10
}  

Параметры поста

Требуется

Требуется

Файловое сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "файл",
   "media": "http: // www.images.com/file.doc ",
   «размер»: 10000,
   "имя_файла": "имя_файла.doc"
}  

Параметры поста

Требуется

Требуется

Требуется

Контактное сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "контакт",
   "контакт":{
      "name": "Итамар",
      "phone_number": "+ 972511123123"
   }
}  

Параметры поста

Требуется

Требуется

Требуется

Сообщение о местоположении

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   "tracking_data": "данные отслеживания",
   "тип": "местоположение",
   "расположение":{
      "lat": "37,7898",
      "лон": "- 122.3942"
   }
}  

Параметры поста

Требуется

Требуется

URL-сообщение

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "URL",
   "media": "http://www.website.com/go_here"
}  

Параметры поста

Требуется

Требуется

Наклейка с сообщением

Данные сообщения

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "наклейка",
   "sticker_id": 46105
}  

Параметры поста

Требуется

.

Сообщение Rich Media / Сообщение с содержанием карусели

Тип сообщения Rich Media позволяет отправлять сообщения с заранее заданным макетом, включая высоту (количество строк), ширину (количество столбцов), текст, изображения и кнопки.

Ниже вы найдете пример сообщения содержимого карусели, которое позволяет пользователю прокручивать список элементов, каждый из которых состоит из изображения, описания и кнопки призыва к действию.

Каждый элемент списка, отображаемый пользователю, представляет собой кнопку в массиве «Buttons» сообщения Rich Media. Также разрешена отправка одной кнопки.

Параметры сообщения Rich Media и его кнопки также используются для клавиатуры. Вы можете найти дополнительную информацию о них в следующей статье.

Примечания:

1. Сообщение о содержимом карусели поддерживается на устройствах под управлением Viber версии 6.7 и выше.
2. Каждая кнопка может содержать не более 7 рядов.
3. Пересылка не поддерживается для сообщений Rich Media.

Почтовые данные

  {
   "приемник": "nsId6t9MWy3mq09RAeXiug ==",
   "тип": "rich_media",
   «min_api_version»: 7,
   "мультимедиа":{
      «Тип»: «rich_media»,
      «ButtonsGroupColumns»: 6,
      «ButtonsGroupRows»: 7,
      "BgColor": "# FFFFFF",
      «Кнопки»: [
         {
            «Колонны»: 6,
            «Рядов»: 3,
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com ",
            "Изображение": "http: // html-test: 8080 / myweb / guy / assets / imageRMsmall2.png"
         },
         {
            «Колонны»: 6,
            «Рядов»: 2,
            "Text": "  Наушники с микрофоном, накладные проводные наушники    
 Sound Intone   17,99 долл. США  ",
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com",
            "TextSize": "средний",
            "TextVAlign": "средний",
            "TextHAlign": "слева"
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https: // www.google.com ",
            "Text": " Купить ",
            "TextSize": "большой",
            "TextVAlign": "средний",
            "TextHAlign": "средний",
            «Изображение»: «https://s14.postimg.org/4mmt4rw1t/Button.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https://www.google.com",
            "Text": " ПОДРОБНЕЕ ",
            "TextSize": "маленький",
            "TextVAlign": "средний",
            «TextHAlign»: «средний»
         },
         {
            «Колонны»: 6,
            «Рядов»: 3,
            "ActionType": "открытый URL",
            "ActionBody": "https: // www.google.com ",
            «Изображение»: «https://s16.postimg.org/wi8jx20wl/image_RMsmall2.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 2,
            "Text": "  Мужская футболка с изображением юмора Hanes    
 Hanes   10,99 долл. США  ",
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com",
            "TextSize": "средний",
            "TextVAlign": "средний",
            "TextHAlign": "слева"
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https: // www.google.com ",
            "Text": " Купить ",
            "TextSize": "большой",
            "TextVAlign": "средний",
            "TextHAlign": "средний",
            «Изображение»: «https://s14.postimg.org/4mmt4rw1t/Button.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https://www.google.com",
            "Text": " ПОДРОБНЕЕ ",
            "TextSize": "маленький",
            "TextVAlign": "средний",
            «TextHAlign»: «средний»
         }
      ]
   }
}  

Параметры поста

Кнопочный элемент

Клавиатуры

API Viber позволяет отправлять настраиваемую клавиатуру с помощью send_message API, чтобы предоставить пользователю набор предопределенных ответов или действий. Клавиатуру можно прикрепить к любому типу сообщений или отправить с ней. После получения клавиатура будет отображаться для пользователя вместо встроенной клавиатуры устройства.Клавиатуры полностью настраиваются и могут быть созданы и разработаны специально для нужд учетной записи. Клиент всегда будет отображать последнюю отправленную ему клавиатуру.

Прочтите следующую статью, чтобы узнать больше о клавиатурах.

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ.

URL ресурса

  https://chatapi.viber.com/pa/send_message  

Данные публикации

Клавиатуры можно прикреплять к сообщениям любого типа и отправлять и отображать вместе.Чтобы прикрепить клавиатуру к сообщению, просто добавьте параметры клавиатуры в JSON сообщения.
В приведенном ниже примере показана клавиатура, отправленная с текстовым сообщением (обратите внимание, что клавиатура не содержит всех необязательных значений).

  {
   "получатель": "01234567890A =",
   «min_api_version»: 7,
   "тип": "текст",
   "text": "Привет, мир",
   "keyboard": {
      "Тип": "клавиатура",
      "DefaultHeight": true,
      «Кнопки»: [
         {
            "ActionType": "ответить",
            "ActionBody": "ответь мне",
            «Текст»: «Ключевой текст»,
            "TextSize": "обычный"
         }
      ]
   }
}  

Широковещательное сообщение

broadcast_message API позволяет учетным записям отправлять сообщения нескольким пользователям Viber, которые подписаны на учетную запись.Отправка сообщения пользователю будет возможна только после того, как пользователь подписался на бота, отправив сообщение боту.

API поддерживает различные типы сообщений: текст , изображение , видео , файл , местоположение , наклейка , контакт , контент карусели и URL .

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ. Максимальная длина списка — 300 получателей.Широковещательный API используется для отправки сообщений нескольким получателям с ограничением скорости 500 запросов в 10-секундном окне.

URL ресурса

  https://chatapi.viber.com/pa/broadcast_message  

Параметры сообщения

Этот метод API использует те же параметры, что и метод send REST API с несколькими вариантами, описанными ниже.

broadcast_list

Этот обязательный параметр определяет получателей сообщения.Каждый пользователь должен быть подписан и иметь действующий идентификатор пользователя. Максимальная длина списка — 300 получателей. Например (это должно быть частью полного тела JSON):

  {
   "Список вещания":[
      "ABB102akPCRKFaqxWnafEIA ==",
      "ABB102akPCRKFaqxWna111 ==",
      "ABB102akPCRKFaqxWnaf222 =="
   ]
}  

Держатели мест

Широковещательное сообщение может содержать заполнители, которые будут заменены информацией о получателе (каждый получатель получит свою информацию).Заполнители могут появляться в любом месте сообщения, даже в данных отслеживания. Список обладателей:

• replace_me_with_receiver_id — будет заменен на идентификатор получателя
• replace_me_with_url_encoded_receiver_id — будет заменен идентификатором получателя в кодировке URL
• replace_me_with_user_name — будет заменено именем пользователя получателя

Пример сообщения

В следующем примере демонстрируется отправка содержимого карусели с заполнителями ( replace_me_with_receiver_id , replace_me_with_url_encoded_receiver_id , replace_me_with_user_name ) 4 получателям:

  {
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   «min_api_version»: 2,
   "тип": "rich_media",
   "Список вещания":[
      "pttm25kSGUo1919sBORWyA ==",
      "2yBSIsbzs7sSrh5oLm2hdQ ==",
      "EGAZ3SZRi6zW1D0uNYhQHg ==",
      "kBQYX9LrGyF5mm8JTxdmpw =="
   ],
   "мультимедиа":{
      «Тип»: «rich_media»,
      "BgColor": "# FFFFFF",
      «Кнопки»: [
         {
            "ActionBody": "https://www.google.com",
            "ActionType": "открытый URL",
            "Text": "Должен вернуть мой ID вместо replace_me_with_receiver_id"
         },
         {
            "ActionBody": "https: // www.google.com ",
            "ActionType": "открытый URL",
            "Text": "Должен получить обратно мой URL-кодированный идентификатор вместо replace_me_with_url_encoded_receiver_id"
         },
         {
            "ActionBody": "https://www.google.com",
            "ActionType": "открытый URL",
            "Текст": "Должен вернуть мое имя вместо replace_me_with_user_name"
         }
      ]
   }
}  

Ответ

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

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

  {
   "message_token": 408088712,
   «статус»: 0,
   "status_message": "хорошо",
   "failed_list": [
      {
         "приемник": "pttm25kSGUo1919sBORWyA ==",
         «статус»: 6,
         "status_message": "Не подписан"
      },
      {
         "приемник": "EGAZ3SZRi6zW1D0uNYhQHg ==",
         «статус»: 5,
         "status_message": "Не найдено"
      }
   ]
}  

Получить информацию об аккаунте

Запрос get_account_info получит данные учетной записи, зарегистрированные в Viber.Администратор аккаунта сможет редактировать большую часть этих данных в своем клиенте Viber.

URL ресурса

  https://chatapi.viber.com/pa/get_account_info  

Данные публикации

  {
}  

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   "id": "pa: 753465468546724",
   "name": "имя учетной записи",
   "uri": "accountUri",
   "icon": "http://example.com",
   "фон": "http://example.com",
   "категория": "категория",
   «подкатегория»: «подкатегория»,
   "расположение":{
      «лон»: 0.1,
      «шир»: 0,2
   },
   "страна": "Великобритания",
   "webhook": "https://my.site.com",
   "event_types": [
      "доставлен",
      "видимый"
   ],
   "subscribers_count": 35,
   "members": [
      {
         "id": "01234567890A =",
         "name": "мое имя",
         "аватар": "http://example.com",
         "роль": "администратор"
      }
   ]
}  

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

Получить сведения о пользователе

Запрос get_user_details будет извлекать сведения о конкретном пользователе Viber на основе его уникального идентификатора пользователя. Идентификатор пользователя может быть получен из обратных вызовов, отправленных в учетную запись относительно действий пользователя. Этот запрос может быть отправлен дважды в течение 12 часов для каждого идентификатора пользователя.

URL ресурса

  https://chatapi.viber.com/pa/get_user_details  

Данные публикации

  {
   "id": "01234567890A ="
}  

Параметры поста

Требуется

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   message_token: 41846655238145,
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com",
      "страна": "Великобритания",
      "language": "en",
      "primary_device_os": "android 7.1",
      "api_version": 1,
      "viber_version": "6.5.0",
      «mcc»: ​​1,
      «mnc»: 1,
      "device_type": "iPhone9,4"
   }
}  

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

Подключиться к Интернету

Запрос get_online извлекает онлайн-статус заданных подписанных участников учетной записи. API поддерживает до 100 идентификаторов пользователей на запрос, и эти пользователи должны быть подписаны на учетную запись.

URL ресурса

  https://chatapi.viber.com/pa/get_online  

Данные публикации

  {
   "идентификаторы": [
      "01234567890 =",
      "01234567891 =",
      "01234567893 ="
   ]
}  

Параметры поста

Требуется

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   "пользователи": [
      {
         "id": "01234567890 =",
         "online_status": 0,
         "online_status_message": "онлайн"
      },
      {
         "id": "01234567891 =",
         "online_status": 1,
         "online_status_message": "офлайн",
         "last_online": 1457764197627
      },
      {
         "id": "01234567893 =",
         "online_status": 3,
         "online_status_message": "tryLater"
      }
   ]
}  

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

Обратный звонок

Каждый обратный вызов будет содержать подпись JSON, переданного обратному вызову. Подпись — это HMAC с SHA256, который будет использовать токен аутентификации в качестве ключа и JSON в качестве значения. Результат будет передан как HTTP Header X-Viber-Content-Signature , чтобы получатель мог определить источник сообщения.

Логика повторной попытки

Если веб-перехватчик отключен, Viber будет повторно пытаться доставить обратный вызов до тех пор, пока не будет получен код состояния HTTP 200 .Будет повторная попытка через 5 секунд, а затем еще одна через 1 минуту 5 секунд.

Вход

Ключ (токен аутентификации вашего бота):

  4453b6ac12345678-e02c5f12174805f9-daec9cbb5448c51f  

Значение:

  {
   "событие": "доставлено",
   "отметка времени": 1457764197627,
   message_token: 4184665523145,
   "user_id": "01234567890A ="
}  

Выход

HTTP-заголовок

  X-Viber-Content-Signature: 9d3941b33d45c165400d84dba9328ee0b687a5a18b347617091be0a56d  

Подписан

Прежде чем учетная запись сможет отправлять сообщения пользователю, пользователю необходимо подписаться на учетную запись.Подписка может иметь место, если пользователь отправляет сообщение боту — когда пользователь отправляет свое первое сообщение боту, пользователь автоматически подписывается на бота. Отправка первого сообщения не вызовет обратный вызов подписки, только обратный вызов сообщения (см. Раздел получение сообщения от пользователя).

Вы получите событие с подпиской, когда отписавшиеся пользователи сделают следующее:

1. Открытый разговор с ботом.
2. Нажмите на кнопку с тремя точками в правом верхнем углу, а затем на «Информация о чате».
3. Нажмите на «Получать сообщения».

Примечание: Событие подписки удалит любую информацию context или tracking_data , связанную с диалогом. Это означает, что если пользователь разговаривал с сервисом, а затем решил отказаться от подписки и подписаться снова,
новый разговор будет начат без какой-либо информации, относящейся к старому разговору.

Данные обратного вызова

  {
   "событие": "подписан",
   "отметка времени": 1457764197627,
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   message_token: 41846655238145
}  

Параметры обратного вызова

Отписался

У пользователя будет возможность отказаться от подписки на PA. Это вызовет обратный вызов для отказа от подписки.

Данные обратного вызова

  {
   "событие": "отписался",
   "отметка времени": 1457764197627,
   "user_id": "01234567890A =",
   message_token: 41846655238145
}  

Параметры обратного вызова

Разговор начат

Событие начала беседы возникает, когда пользователь открывает беседу с ботом, используя кнопку «сообщение» (находится на экране информации учетной записи) или используя глубокую ссылку.

Это событие , а не , считается событием подписки и не позволяет учетной записи отправлять сообщения пользователю; однако это позволит отправить пользователю одно «приветственное сообщение». См. Отправку приветственного сообщения ниже для получения дополнительной информации.

После получения обратного вызова talk_started служба сможет ответить JSON, содержащим те же параметры, что и запрос send_message . Параметр приемника - , а не в данном случае.

Примечание. Обратный вызов talk_started не содержит по умолчанию параметр context .

Чтобы добавить этот параметр и определить его значение, вы можете использовать deeplink следующим образом:
viber: // pa? ChatURI = your_bot_URI & context = your_context

Данные обратного вызова

  {
   "событие": "начало_ беседы",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "тип": "открытый",
   "context": "контекстная информация",
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   "подписан": ложь
}  

Параметры обратного вызова

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

API Viber позволяет отправлять сообщения пользователям только после того, как они подпишутся на аккаунт.Однако Viber позволит учетной записи отправлять пользователю одно «приветственное сообщение», когда пользователь открывает беседу, прежде чем пользователь подпишется.

Приветственное сообщение будет отправлено как ответ на обратный вызов talk_started , который будет получен от Viber, как только пользователь откроет беседу с учетной записью. Чтобы узнать больше об этом событии и когда оно запускается, см. Разговор начался в разделе обратных вызовов.

Поток приветственного сообщения

Отправка приветственного сообщения будет происходить в следующем порядке:

1. Пользователь открывает беседу один на один со своей учетной записью.
2. Сервер Viber отправляет обратный вызов chat_started на веб-перехватчик бота.
3. Учетная запись получает обратный вызов talk_started и отвечает HTTP-ответом, который включает приветственное сообщение в качестве тела ответа.

Приветственное сообщение будет представлять собой JSON, созданный в соответствии со структурой запросов send_message , но без параметра приемника . Пример приветственного сообщения будет выглядеть так:

  {
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   "tracking_data": "данные отслеживания",
   "тип": "картинка",
   "text": "Добро пожаловать в наш бот!",
   "media": "http://www.images.com/img.jpg",
   "thumbnail": "http://www.images.com/thumb.jpg"
}  

Примечание: Приветственное сообщение должно быть отправлено как тело HTTP-ответа на обратный вызов talk_started , а не на конечную точку send_message .

Получение сообщений, обратные вызовы

Viber предлагает обновления статуса сообщения для каждого отправленного сообщения, позволяя учетной записи получать уведомления, когда сообщение было доставлено на устройство пользователя (статус доставки ) и когда был открыт диалог, содержащий сообщение ( виден статус ).

Обнаруженный обратный вызов будет отправлен только один раз, когда пользователь прочитает непрочитанные сообщения, независимо от количества отправленных им сообщений или количества устройств, которые они используют.

Если получатель сообщения использует свою учетную запись Viber на нескольких устройствах, каждое из устройств вернет доставленное, что означает, что для одного сообщения можно получить несколько доставленных обратных вызовов.

Если Viber не может доставить сообщение клиенту, он попытается доставить его в течение 14 дней.Если сообщение не было доставлено в течение 14 дней, оно не будет доставлено, и для него не будет получено никаких обратных вызовов «доставлено» или «просмотрено».

Данные обратного вызова

Доставлено

  {
   "событие": "доставлено",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A ="
}  

Просмотрели

  {
   "событие": "видел",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A ="
}  

Параметры обратного вызова

Неудачный обратный вызов

«Неудачный» обратный вызов будет запущен, если сообщение достигло клиента, но не удалось выполнить какую-либо из проверок клиента.

Поскольку некоторые проверки сообщений происходят на сервере, а другие - на клиенте, некоторые сообщения могут завершиться ошибкой только после достижения клиента. В таких случаях поток будет следующим:

1. Сообщение отправлено.
2. Получен ответ со статусом 0, указывающий на успешный запрос.
3. Сообщение достигает клиента и не проходит проверку клиента.
4. Обратный вызов «Failed» отправляется на веб-перехватчик, содержащий уникальный токен сообщения и строку, объясняющую сбой.

Такое сообщение не будет отображаться получателю, и для него не будут возвращены обратные вызовы «доставлено» или «увидено».

Данные обратного вызова

  {
   "событие": "не удалось",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A =",
   "desc": "описание ошибки"
}  

Параметры обратного вызова

Получить сообщение от пользователя

API чата позволяет пользователю отправлять сообщения в PA.За исключением файла типа , поддерживаются все типы сообщений для отправки от бота к пользователю и от пользователя к боту. К ним относятся: текст , изображение , видео , контакт , URL и местоположение . Следующие данные обратного вызова описывают структуру сообщений, отправляемых пользователем в PA.

Данные обратного вызова

  {
   "событие": "сообщение",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "отправитель": {
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   "сообщение":{
      "тип": "текст",
      "текст": "сообщение в службу",
      "media": "http://example.com",
      "расположение":{
         «шир»: 50,76891,
         "lon": 6.11499
      },
      "tracking_data": "данные отслеживания"
   }
}  

Общие параметры обратного вызова

Параметры сообщения обратного вызова

Параметры сообщения обратного вызова зависят от типа сообщения.Для каждого типа сообщения будут получены только соответствующие параметры.

Статус сообщения

После получения ответа 200 OK от PA статус сообщения изменится на доставлено на стороне пользователя.Статус «Просмотрено» в настоящее время не поддерживается для сообщений, отправленных от пользователя к PA.

Коды ошибок

В ответах API будут возвращены следующие коды ошибок. Параметр status будет включать значение кода ошибки, а параметр status_message будет включать имя ошибки или более конкретную строку, описывающую ошибку.

не установлен вебхук.


Примечание: Отказ отправить маркер аутентификации в заголовке приведет к ошибке с сообщением об отсутствии auth_token .

Запрещенные форматы файлов

Клавиатуры | Центр разработчиков Viber

API чат-бота позволяет отправлять настраиваемую клавиатуру с каждым сообщением, чтобы предоставить пользователю набор предопределенных ответов или действий.Клавиатуру можно прикрепить к любому типу сообщений или отправить с ней. После получения клавиатура будет отображаться для пользователя вместо встроенной клавиатуры устройства. Клавиатуры полностью настраиваются и могут быть созданы и спроектированы специально для нужд PA.

Клиент всегда будет отображать последнюю отправленную ему клавиатуру.

Прикрепление клавиатуры к сообщению

Клавиатуры можно прикреплять к сообщениям любого типа и отправлять и отображать вместе. Чтобы прикрепить клавиатуру к сообщению, просто добавьте параметры клавиатуры в JSON сообщения.
JSON-объект клавиатуры определяет различные визуальные и логические атрибуты. От цвета фона, количества кнопок и так далее.

В приведенном ниже примере показана клавиатура, отправляемая с одним сообщением.

  {
"keyboard": {
"DefaultHeight": true,
"BgColor": "#FFFFFF",
«Кнопки»: [{
«Колонны»: 6,
«Рядов»: 1,
"BgColor": "# 2db9b9",
"BgMediaType": "gif",
"BgMedia": "http://www.url.by/test.gif",
"BgLoop": правда,
"ActionType": "открытый URL",
"ActionBody": "www.tut.by ",
«Изображение»: «www.tut.by/img.jpg»,
«Текст»: «Ключевой текст»,
"TextVAlign": "средний",
"TextHAlign": "центр",
«TextOpacity»: 60,
"TextSize": "обычный"
}]
}
}  

Что, в свою очередь, будет выглядеть так:

Общие параметры клавиатуры

Обратите внимание: api level 3 поддерживается на устройствах под управлением Viber версии 7.6 и выше. Если вы используете параметры api level 3 , вам также необходимо установить параметр min_api_version на правом уровне api.

Требуется

.

.

Параметры кнопок

Следующие параметры могут быть определены отдельно для каждой кнопки в массиве кнопок.Каждая кнопка должна содержать хотя бы один из следующих необязательных параметров: текст, BgMedia, изображение, BgColor.

Требуется