Для отображения персонализированного контента и рекламных сообщений, а также хранения личных настроек на локальном компьютере веб‑сайт 1crm.ru используют технологию cookie и аналогичные. Продолжив использование наших веб‑сайтов, Вы даете согласие на обработку персональных данных, выражаете согласие с Политикой конфиденциальности 1crm.ru и применением этих технологий.
Быстрый старт Блог

Интеграция с Viber

Интеграция с Viber позволяет обмениваться сообщениями с клиентами в  АРМ Диалоги c помощью чат‑бота Viber.

Важно! Данная интеграции  доступна при наличие  активного действующего договора «1С:ИТС Отраслевой». 

Доступ к чат-боту для клиента возможен двумя способами:

  • По прямой ссылке вида: viber://pa?chatURI={botname}.
  • По размещенному QR-коду с данной ссылкой (при его сканировании будет выполняться переход в приложение Viber и подключение к боту). Его можно сгенерировать в любом из онлайн-сервисов по созданию QR‑кодов.

Внимание! Viber не передает номер телефона клиента при общении в чате. Получить номер телефона через канал Viber можно, только если сам клиент укажет его в сообщении.

Регистрация чат-бота Viber

Важно! Для начала создания чат-бота Viber уже должна быть учетная запись Viber. Учетную запись можно создать в приложение на телефоне или на компьютере установить.

Создание чат-бота Viber происходит в  партнерском аккаунте. Для его создания нужно пройти регистрацию (если уже есть партнерский аккаунт, необходимо авторизоваться). При регистрации нужно:

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

После прохождения регистрации или авторизации в панели управления партнерским аккаунтом для создания нового  чат-бота необходимо выполнить команду Create bot Account.

Ключ (Private token)

Создание чат-бота

При создание чат-бота заполняются поля:

  • Account Image — иконка бота, 400х400 пикселей.
  • Account Name — имя бота, которое будет отображаться в Viber у клиентов.
  • Uri — имя в ссылке на бот вида: http://viber.com/Uri.
  • Category и Subcategory — категория и подкатегория тематики вашего будущего бота.
  • Language — язык.
  • Account Description — короткое описание бота.
  • Website Address — адрес вашего сайта (не обязательное поле).
  • Email Address — адрес почты для связи.
  • Location — местоположение.
  • The account contains adult content — установить галку, если бот относится к взрослому контенту.
  • I accept the Terms and Conditions — согласие на пользование сервисом ботов Viber.

Установка сервиса для пересылки сообщений 

Для того чтобы 1С:CRM могла обмениваться сообщениями с чат‑ботом Viber необходимо  установить и настроить специальный сервис. Сервис должен быть установлен на сайте. Сайт должен быть  размещен  на веб‑хостинге со следующими возможностями:

  • поддержка HTTPS и наличие SSL‑сертификата (самоподписанный сертификат не подходит);
  • поддержка PHP.

У вас должен быть доступ в «админку» сайта для размещения файлов. Для установки необходимо создать новый каталог (пример: «viberbot») в структуре сайта и перенести в него содержимое архива viber.zip (обязательно убедиться, что содержимое перенеслось с сохранением структуры папок).

Для обмена сообщениями с  чат-ботом Viber необходим специальный параметр — Token (Ключ).   Token выдается при создании чат-бота Viber:

Ключ (Private token)

Ключ (Private token)

В файле app/config.php необходимо установить значение параметров:

  • apiKey — Token (Ключ), который был выдан при создании чат-бота.
  • webhookUrl — https://<Имя вашего сайта>/<Каталог бота>/app/bot.php (пример: https://mysite.ru/viberbot/app/bot.php).
  • botName — имя бота, как оно будет отображаться в переписке с клиентом.
  • welcomeMessage — приветственное сообщение, которое автоматически выводится при начале диалога. Например «Здравствуйте! Чем вам помочь?»
  • debug — флаг для ведения лога (0 — не ведется, 1 — ведется).

Далее необходимо запустить скрипт (в строке браузера):  https://<Имя вашего сайта>/<Каталог бота>/app/setup.php.  Этот скрипт установит  адрес для отправки webhook на сервере Viber.

Подключение чат-бота Viber

Для подключения чат-бота Viber необходимо открыть окно «Приложения для 1С:CRM» и выбрать приложение Viber.

Подключение приложения для интеграции с Viber

Подключение приложения для интеграции с Viber

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

Подключение чат-бота Viber

Подключение чат-бота Viber

В форме настройки подключения необходимо заполнить поля:

  • Адрес публикации — сайт, на котором установлен сервис для пересылки сообщений.
  • Порт — порт HTTPS (SSL), по умолчанию 443.
  • Запрос получения сообщений — при соблюдении инструкции должны быть «/<Каталог бота>/app/report.php/getMessages».
  • Запрос отправки сообщений — при соблюдении инструкции должны быть «/<Каталог бота>/app/report.php/sendMessages».

Настройки подключения

Настройки подключения

Настройка завершена, можно переходить в «Диалоги» для работы с сообщениями.

Вернуться к списку статей
icon_news

Помогите улучшить статью

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