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

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

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

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

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

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

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

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

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

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

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

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

На главной странице приложения есть несколько пунктов, которые помогут вам сориентироваться в установке и настройке. Разберем каждый из них:

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

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

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

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

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

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

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

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

Данная ссылка ведет на страницу с дополнительными настройками бота.

• «Стоп-контакты» — добавление элементов в список исключений для поиска. Подробная инструкция представлена в статье.
• «Фильтрация системных комментариев» — отключение пересылки системных комментариев к задачам из чата на портале Битрикс24 в чат Telegram. Подробная инструкция представлена в статье.

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

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

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

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

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

Привязка Telegram-чата для сбора логов (событий).

Создание сообщений в чате от лица бота на стороне портала Битрикс24

Чтобы создать сообщение от лица бота в чате на портале Битрикс24, необходимо выполнить следующие действия:

1. Добавьте бота в чат и выполните команду /get_post_link. В ответ бот пришлет краткую инструкцию по настройке.

2. Перейдите по предложенной ссылке, добавьте в параметр «&message=» необходимый текст, а затем нажмите «Enter». 

Создание сообщений в чате от лица бота на стороне Telegram

Чтобы создать сообщение от лица бота в чате Telegam, необходимо выполнить следующие действия: 

1. Добавьте бота в чат и дайте ему права администратора. 

2. Отправьте команду /get_post_link.

3. Перейдите по предложенной ссылке и добавьте в параметр «&message=» необходимый текста, а затем нажмите «Enter».

Обратите внимание, если указать любое произвольное значение для «&concat_id=», то бот в течение часа будет объединять сообщения с одинаковым concat_id.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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