JAICP

Битрикс24 как входящий канал


Битрикс24 — набор инструментов для организации работы компании: задачи, чат, диск, календарь, группы, рабочие отчеты, бизнес-процессы и другие инструменты для совместной работы.

Для использования Битрикс24 как входящего канала:

  1. Создайте канал в проекте.
  2. Создайте приложение.
  3. Подключите чат-бота.
  4. Добавьте чат-бота в контакты и протестируйте его работу.

Создание канала

Авторизуйтесь на платформе JAICP и перейдите в проект. На панели управления выберите Каналы > Входящие > Создать канал. В разделе Другие выберите канал для подключения Битрикс24.

Настройте параметры канала:

  • Название — укажите название канала или оставьте по умолчанию.
  • Токен — оставьте пустым.
  • Имя.
  • Фамилия.
  • Email.
  • Код приложения — оставьте пустым.
  • Ключ приложения — оставьте пустым.
  • Открытые линии — переведите переключатель в активное положение, если будете использовать Открытые линии.

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

  • Аватар бота — загрузите изображение или вставьте ссылку на него.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

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

Нажмите Создать.

Под названием канала нажмите Получить webhook.

Создание приложения

Авторизуйтесь в личном кабинете Битрикс24 как администратор. На панели управления выберите Ещё > Маркет > Добавить приложение > Другое > Локальное приложение.

Заполните параметры приложения:

  • В качестве типа приложения оставьте Серверное.
  • В поле Путь обработчика вставьте вебхук, который вы получили при подключении канала на платформе.
  • Повторно вставьте вебхук в поле Путь до первоначальной установки.
  • Активируйте опцию Использует только API, так как приложение является внешним.
  • Появится поле Настройка прав. Нажмите + выбрать и добавьте права:
    • Создание и управление Чат-ботами (imbot)
    • Открытые линии (imopenlines)
    • Встраивание приложений (placement)
    • Бизнес-процессы (bizproc)
    • Чат и уведомления (im)

Если вы не планируете использовать Открытые линии, не добавляйте эту опцию в поле Настройка прав. Тогда ваш чат-бот будет доступен только в Битрикс24, но вы сможете подключить дополнительные каналы в платформе JAICP.

Вы также можете добавить другие права доступа. Например, для обновления сделок в системе СRM добавьте CRM (crm).

Нажмите Сохранить. Скопируйте значения полей Код приложения и Ключ приложения.

Добавленное приложение вы сможете отредактировать или удалить на странице Маркет > Добавить приложение > Интеграции.

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

Вернитесь в ваш проект в JAICP. Выберите Каналы > напротив созданного ранее канала Битрикс24 > Редактировать. Теперь вы находитесь в настройках канала.

Вставьте значения для полей Код приложения и Ключ приложения. Сохраните изменения.

Добавление чат-бота

Теперь добавьте чат-бота в список контактов и пообщайтесь с ним.

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

Если вы настроили интеграцию правильно, бот ответит согласно сценарию.