Битрикс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. В поле Поиск вставьте имя бота, которое вы указали при создании канала. Перейдите в окно диалога с ботом и отправьте ему активационную фразу, предусмотренную вашим сценарием.

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