Битрикс24 как входящий канал
Битрикс24 — набор инструментов для организации работы компании: задачи, чат, диск, календарь, группы, рабочие отчеты, бизнес-процессы и другие инструменты для совместной работы.
Для использования Битрикс24 как входящего канала:
- Создайте канал в проекте.
- Создайте приложение.
- Подключите чатбота.
- Добавьте чатбота в контакты и протестируйте его работу.
Создание канала
Авторизуйтесь на платформе JAICP, перейдите в проект. Кликните на панели управления Каналы > Входящие > Создать канал. В разделе Другие выберите канал для подключения Bitrix24.
Заполните поля:
- Название — укажите название канала или оставьте по умолчанию.
- Токен — оставьте пустым.
- Имя — укажите имя бота.
- Фамилия — укажите фамилию бота.
- Email — укажите адрес электронной почты.
- Код приложения — оставьте пустым.
- Ключ приложения — оставьте пустым.
- Открытые линии — переведите переключатель в активное положение, если будут использоваться Открытые линии.
Открытые линии собирают сообщения из разных каналов в Битрикс24, распределяют по правилам очереди между сотрудниками и сохраняют в CRM.
- Аватар бота — загрузите или вставьте ссылку на изображение.
- Ветка — укажите ветку проекта, которую хотите развернуть в канал, по умолчанию
master. - Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
Обратите внимание на переключатель Публикация. Публикацию или деплой сценария следует выполнять перед запуском чатбота. На этом этапе происходит сборка чатбота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.
Кликните Создать.
Под названием канала кликните Получить webhook
Создание приложения
Авторизуйтесь в личном кабинете Битрикс24 как администратор.
Нажмите на панели управления Ещё > Приложения > Добавить приложение.
Заполните поля:
- Название приложения — укажите название приложения.
- Приложение использует только API — переведите переключатель в активное положение, так как приложение является внешним.
- Права доступа — переведите переключатель в активное положение на пунктах Создание и управление Чат-ботами, Открытые линии, Встраивание приложений.
Если вы не планируете использовать Открытые линии, оставьте переключатель неактивным. Тогда ваш чатбот будет доступен только в Битрикс24. Но вы можете подключить дополнительные каналы в платформе JAICP.
Вы также можете активировать другие переключатели прав доступа. Например, для обновления сделок в системе СRM активируйте переключатель CRM.
Для использования роботов активируйте переключатель Бизнес-процессы при настройке приложения.
- Укажите ссылку - вставьте вебхук, который был создан при подключении канала на платформе.
- Укажите ссылку-callback для события установки - повторно вставьте вебхук, который был создан при подключении канала на платформе.
Нажмите Сохранить. Скопируйте вверху страницы значения полей Код приложения и Ключ приложения.
Добавленное приложение вы можете отредактировать или удалить в меню Мои приложения.
Подключение чатбота
Перейдите на страницу Каналы платформы JACIP > нажмите на иконку
напротив созданного ранее канала Bitrix 24 > Редактировать. Теперь вы находитесь в настройках канала.
Вставьте значения для полей Код приложения и Ключ приложения, сохраните изменения.
Добавление чатбота
Теперь добавим чатбота в список контактов и пообщаемся с ним.
Для этого нажмите Чат и звонки на панели управления. В поле Поиск вставьте имя бота, которое указали при создании канала. Перейдите в окно диалога с ботом и отправьте ему приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.