Пользовательская инструкция по настройке приложения «Многоцелевой и telegram (телеграм) бот»

---

Установка приложения в Битрикс24

Чтобы начать использовать приложение «Многоцелевой и telegram (телеграм) бот» на вашем портале Битрикс24, необходимо скачать его по ссылке или выполнить следующие действия:

1. Поиск приложения

Перейдите в раздел Маркетплейс вашего портала Битрикс24, в строке поиска введите название «Многоцелевой и telegram (телеграм) бот» и выберите его из предложенного списка.

2. Открытие страницы приложения

После выбора приложения вы попадете на страницу с его описанием. Здесь можно ознакомиться с его функционалом и возможностями.

3. Установка приложения 

Нажмите кнопку «Установить» и проставьте галочки в чекбоксах условий соглашения, а затем снова нажмите на кнопку «Установить». 

4. Доступ к приложению

После завершения установки приложение будет доступно в главном меню вашего портала Битрикс24.

Интерфейс приложения

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

Шапка приложения

В левом верхнем углу "шапка" приложения. Аналогичная есть у всех приложений от IT-Solution. Она содержит следующую информацию: 

№	Название элемента	Описание
1	Другие  приложения	Переход к другим приложениям Маркета Битрикс24
2	Помощь	Переход к чату Битрикс24, где можно задать вопросы по приложению, сообщить о проблеме и пр.
3	Обратная связь	Переход к чату Битрикс24, где можно передать обратную связь по работе с приложением
4	Инструкции	Переход к инструкциям по работе с многоцелевым ботом
5	Обсуждение	Переход в Телеграм-чату, где можно задать вопросы по приложению, сообщить о проблеме и пр

1. Чат бот установлен. Сказать привет

 После того, как вы нажали на "Сказать привет", вам перекинет в чат с ботом. Бот поздоровается с вами, представится и отправит о себе информацию, а именно: ссылку на инструкцию по настройке и использованию бота, описание команд, которые можно отправить боту.

/get_post_link — команда необходима для создания сообщения от лица UNI-бота в любой чат, где присутствует бот.

/invite_other_chat — команда необходима для связки чатов и передачи сообщений между ними (доступно только для групповых чатов).

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

2. Инструкция

 При нажатии на ссылку откроется страница со статьями про возможности и настройки приложения «Многоцелевой и telegram (телеграм) бот».

3. Дополнительные настройки бота для этого портала

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

Указанные "стоп-контакты" будут игнорироваться при ручном вызове команды "/check_contacts" или ее автоматическом срабатывании по тексту нового сообщения. 

Подробнее о том, что такое стоп-контакты, в инструкции .

4. Привязка чатов портала 

При переходе по данной ссылке откроется страница с информацией о чатах, привязанных к порталу Битрикс24.

№	Название столбца таблицы	Описание
1	Телеграм чат	Название телеграм чата
2	Привязанная группа	Если группа/проект вашего портала привязан к телеграм чату с помощью команды /group_bind , то в данном столбце будет кликабельное название привязанной группы. По нажатии на название группы будет осуществлен переход к данной группе на портале Битрикс24. "Привязки нет" означает, что данный чат не привязан ни к одной группе/проекту вашего портала.
3	Привязанная группа (old)	Если группа/проект вашего портала привязан к телеграм чату с помощью команды /bind_group , то в данном столбце будет кликабельное название привязанной группы. По нажатии на название группы будет осуществлен переход к данной группе на портале Битрикс24 "Привязки нет" означает, что данный чат не привязан ни к одной группе/проекту вашего портала.
4	Привязанный пользователь	Если пользователь портала привязан к телеграм чату с помощью команды /user_bind , то в данном столбце будет кликабельное имя привязанного пользователя. По нажатии на имя пользователя будет осуществлен переход в его профиль на портале Битрикс24. "Привязки нет" означает, что к данному чату не привязан ни один пользователь.
5	Привязанный чат в Битрикс	Если телеграм чат привязан к Битрикс чату c помощью команд /invite_other_chat и /join_other_chat, то в данном столбце будет название привязанного чата Битрикс. "Привязки нет" означает, что данный чат не привязан ни к одному чату в Битрикс.

5. Запускать бизнес-процесс при получении сообщения 

 Настройка бота для использования в Открытых линиях и чатах. Подробная инструкция представлена в статье.

6. Привязать Telegram-чат 

Позволяет пригласить бота @unibot_log_bot в созданный раннее Телеграм чат , в котором вам будет удобно отслеживать логи приложения.

Передача сообщений между чатами на разных порталах Битрикс24

Обратите внимание, для передачи сообщений между чатами, которые находятся на разных порталах Битрикс24, необходимо, чтобы на каждом из них было установлено приложение «Многоцелевой и telegram (телеграм) бот», и в каждый чат был добавлен UNI-бот.

1. Выполните в чате на Портале №1 команду — /invite_other_chat. В ответ бот пришлет краткую инструкцию и секретную строку для привязки другого чата.

2. Скопируйте команду /join_other_chat <секретный код>, перейдите на Портал №2 и отправьте ее боту.

3. Теперь оба чата с разных порталов связаны. Бот будет пересылать все сообщения между данными чатами.

Отсоединить чаты можно с помощью команды /disconnect_from_all_chats.

• Если выполнить команду из родительского чата (откуда был получен секретный код для привязки), то все привязанные чаты отсоединятся как от данного чата, так и друг от друга. При этом секретный код изменится. 
• Если выполнить команду в дочернем чате (который был присоединен к другому чату с помощью секретного кода), то он будет отсоединен, а все ранее связанные с ним чаты продолжат обмениваться сообщениями. При этом секретный код не изменится.

Передача файлов между чатами на порталах Битрикс24

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

Передача файлов между чатами Telegram

Обратите внимание, между чатами можно пересылать изображения и файлы, которые доступны для прикрепления к сообщению в чате Telegram.

 

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

Передача файлов между чатами на портале Битрикс24 и чатами Telegram

Обратите внимание, между чатами можно пересылать изображения и файлы, которые доступны для прикрепления к сообщению в чате Telegram.

 

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

Многоцелевой бот в MAX

Обратите внимание, возможность связывать чаты в мессенджере MAX доступна только в расширенной версии приложения.

1. Перейдите в MAX и создайте группу, которую хотите связать с чатом на портале Битрикс24, и добавьте Многоцелевого бота. Найти его можно по нику it-solution.

Обратите внимание, чтобы использовать команды бота в чатах MAX, необходимо назначить его администратором группы.

2. Отправьте в чат команду /help. Бот покажет список доступных команд.

3. Перед началом работы необходимо авторизоваться на портале Битрикс24. Для этого отправьте команду /auth <адрес портала Битрикс24>.

4. Чтобы связать чат MAX с чатом Битрикс24 или Telegram, выполните команду /invite_other_chat. Бот сформирует секретную пригласительную ссылку. 

Отправьте ее в чат Битрикс24 или Telegram, где уже добавлен Многоцелевой бот, и завершите привязку.

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

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

Доступные команды

При работе с ботом в чатах MAX доступны следующие команды:

Команда	Описание
/start или /help	Показать список доступных команд
/auth	Авторизоваться на портале Битрикс24
/logout	Отменить авторизацию на портале для текущего чата
/info	Показать информацию о текущем чате и его привязках
/invite_other_chat	Получить секретную ссылку для привязки другого чата
/join_other_chat	Привязать текущий чат по полученной ссылке
/disconnect_from_all_chats	Удалить все привязки текущего чата
/outgoing_message_mute	Приостановить пересылку сообщений из чата MAX в связанные чаты (доступно только в чатах MAX)
/outgoing_message_unmute	Возобновить пересылку сообщений из чата MAX в связанные чаты (доступно только в чатах MAX)