Интеграция 1С и Viber с помощью API
Внешняя обработка и расширение для тестирования интеграции с Viber, реализованы базовые методы отправить сообщение, отправить файл, получить сообщения. Подойдет в качестве основы для дальнейшего развития.
- Описание
- Подробнее
Описание
1. Чтобы начать работать с API, необходимо зарегистрировать приложение. Переходим по ссылке и заполняем параметры приложения:
Картинку, название, категорию, email и др., нажимаем "Create", чтобы создать приложение.
2. На странице приложения будет показан токен — уникальный ключ, для работы с ботом, он нам пригодится.
3. Далее будет немного сложно: необходимо опубликовать свой http-сервис в 1С, чтобы мы могли получать уведомления о событиях от Viber. Cервер, где будет выполнена публикация обязательно должен работать через https с действительным SSL сертификатом.
Для упрощения, я подготовил расширение, в котом есть всё необходимое: http-сервис и регистр сведений, куда будут записаны все вызовы от Viber. Публикуем сервис, проверяем в браузере, если по адресу https://localhost/<имя_базы>/hs/viber/webhook отображается {"result": "ok"}, значит, можно переходить к следующему пункту.
4. Регистрируем webhook в Viber. Заходим в 1С, открываем обработку "Интеграция Viber" и заполняем параметры интеграции:
Токен приложения, который мы получили в п.2.
Имя бота, которое будет отображаться в переписке.
Webhook — адрес вашего http-сервиса.
Нажимаем кнопку "Установить", если все настройки выполнены правильно, то ответ от сервера будет, как на скриншоте ("status_message": "ok").
5. Откройте Viber, добавьте бота в контакты и напишите ему какое-нибудь сообщение. Бот не может первым начать диалог.
6. По адресу веб-хука от Viber придет уведомление. Смотрим записи в регистре сведений "Журнал запросов (Viber)".
По сути, нам из него нужно только значение "sender" — "id", чтобы начать отправлять сообщения от имени бота собеседнику.
7. Вписываем значение sender-id в параметры обработки "Интеграция Viber" в поле "Канал". На этом подготовительная часть закончена. На самом деле, после выполненных настроек работать с API совсем не сложно. Чтобы отправлять сообщения нам нужно вызывать только один метод send_message с различными параметрами.
Заполняем параметры, нажимаем кнопку "Отправить", смотрим результат в Viber.
Платформа 8.3.14. Конфигурация — любая. Описание всех методов API — https://developers.viber.com/docs/api/rest-bot-api/#get-started
