7  /  36

Серверное локальное приложение для чат-бота в Битрикс24

Просмотров: 1737 (Статистика ведётся с 06.02.2017)

Пример состоит из одного PHP-файла, который вы должны разместить на своем веб-сервере. Приложение создает чат-бота внутри вашего Битрикс24, который умеет отвечать пользователям.

Скачать архив:

Чат-бот для мессенджера Битрикс24 не является отдельным "типом" приложений. Фактически, чат-бот может быть частью любого серверного приложения, которое просто будет реализовывать логику чат-бота (или даже нескольких сразу), используя соответствующие возможности REST API. При этом, REST для чат-бота в некоторых случаях позволяет обойтись без разработки полной схемы авторизации по протоколу OAuth 2.0, как того требует общий случай серверных приложений без пользовательского интерфейса внутри Битрикс24.

Предлагаемый пример как раз реализует простой кейс, когда чат-бот только отвечает на полученные от пользователей сообщения и поэтому не нуждается в самостоятельном "возобновлении" авторизации по OAuth 2.0. Посмотрев код примера, вы увидите, что все необходимые для работы REST данные, приложение получает в массиве $_REQUEST в нужных для чатбота обработчиках событий.

Для установки локального приложения нужно перейти по цепочке: Приложения 1 - Добавить приложение 2 - Добавить приложение 3:

Нажмите на рисунок, чтобы увеличить

В открывшейся форме заполнить базовые поля и указать необходимые для приложения права (для нашего примера требуются права на создание и управление чатботами), указав URL приложения (это означает, что ваше приложение уже должно быть физически доступно по URL по протоколу HTTPS до того, как вы станете добавлять его в ваш Битрикс24)

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

В этом случае, как вы увидите, в форме будут скрыты поля, в которых обычно указывается название пункта меню для вызова приложения из Битрикс24. Приложения, у которых включена опция Приложение использует только API либо предоставляют пользовательский интерфейс по какому-то своему URL, либо вообще не предоставляют пользовательский интерфейс:

Нажмите на рисунок, чтобы увеличить

Обратите также внимание на то, что мы заполнили поле Укажите ссылку-callback для события установки. Этот URL вызывается только один раз при сохранении формы локального приложения. Именно этот URL служит обработчиком события ONAPPINSTALL, в котором мы и добавляем чатбота в наш Битрикс24. Если вы захотите добавить чатбот заново, вам нужно будет удалить и заново добавить локальное приложение.

После сохранения приложения с чатботом Битрикс24 сразу сообщит о появлении бота в общем чате:

После сохранения новое приложение будет показано в списке локальных приложений в вашем Битрикс24:

Нажмите на рисунок, чтобы увеличить

Можно написать сообщение чатбот, нажав на его название в общем чате. Это начинает индивидуальный чат с чатботом. В нашем примере, чатбот просто будет повторять обратно любой текст, который отправит ему пользователь:


2
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии