Основная информация про бота


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

Существует лишь базовая версия данного приложения (расширенной версии нет).


Ранее Многоцелевой бот был известен под названием чат-бот REST Активити, но в какой-то момент он стал отдельным приложением "Многоцелевой и телеграм бот" 




Больше видео, демонстрирующих настройку и возможности использования Многоцелевого бота можно найти в плейлисте по ссылке: https://youtube.com/playlist?list=PLOEsyFAuoTfVGnB2eNsEAoS-wnTtd-Dmy&si=OPxaNwxSpsCKuo2R





Знакомимся с ботом 

Переходим в установленное приложение на портале Битрикс24 и нажимаем "Сказать привет". 



Бот отправляет в чат на портале Битрикс24 приветствие и некоторую информацию о себе. Если вдруг в процессе настройки и использования бота эта инструкция затеряется, ее всегда можно вызвать, отправив боту команду /help.

 






Передаем сообщения между чатами

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


В чат на портале 1 отправляем команду /invite_other_chat. В ответ бот присылает нам секретную строку для привязки другого чата. Копируем /join_other_chat <секретный код>


Переходим на портал 2 и отправляем скопированную раннее часть сообщения. Теперь два чата на разных порталах Битрикс24 связаны между собой. 


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


Отсоединить привязанный чат(-ы) можно с помощью команды /disconnect_from_all_chats:

1. Если выполнить команду в родительском чате, то все привязанные чаты отсоединятся и от этого чата, и друг от друга, и не смогут обмениваться сообщениями, пока снова не будут связаны. Секретный код в родительском чате при этом изменится. 

2. Если выполнить команду в дочернем чате, то он отсоединится, но все остальные ранее связанные с ним чаты продолжат обмениваться сообщениями, и код привязки родительского чата не изменится. 

Родительский чат - чат, откуда был получен секретный код для привязки других чатов. Дочерний чат - чат, который присоединился к родительскому по присланному секретному коду



Пишем в чат от лица бота 

Вы можете написать боту в его собственный чат, либо добавить его в нужный вам чат с другими пользователями. Любой пользователь может отправить боту команду /get_post_link и с ее помощью создать в чате, где он ее вызвал, сообщение от лица бота. 

Важно: выполнять эту команду можно и в чатах Битрикс24, и в Телеграм-чатах 


В ответ на команду /get_post_link бот дает ссылку для создания сообщения от лица бота в текущем чате.


Переходим по ссылке, которую отправил бот, и в адресной строке после знака равно прописываем текст, который хотим отправить в чат от лица бота. Нажимаем на Enter. 

Обратите внимание, что значение в параметре key подойдет только для чата, из которого команда была вызвана. 


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


Если вы выполняете команду в Телеграме, вы можете указать любое произвольное значение для &concat_id= чтобы в течение часа объединять сообщения с одинаковым concat_id. (Вместо новых сообщений редактировать одно сообщение, дописывая в него текст)
Результат (отправили несколько сообщений, и они все соединились в одно, каждое отправленное сообщение с новой строки)

Такое объединение сообщений пока доступно только в Телеграме. 



Связываем группу Битрикс24 и Телеграм чат

1. Заходим в Телеграм, создаем новую группу и сразу же в процессе создания приглашаем туда бота @its_bitrix24_bot 







2. Делаем @its_bitrix24_bot администратором группы






3. Включаем темы в Телеграм-чате 




4. В топике #General пишем боту /auth адрес портала Битрикс 24




5. Создаем группу в Битикс24





5. Возвращаемся в созданный Телеграм-чат, в топике #General пишем боту /group_bind <ID созданной в Битрикс24 группы>




6. Теперь группа Битрикс24 связана с Телеграм-чатом

Замечаем, что автоматически появился топик  "Новости группы", туда будут отправляться текстовые комментарии, которые пользователи оставляют на портале Битрикс24 в группе в разделе "Новости". 

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

Если в Телеграме вручную создать топик, то бот сам предложит создать по нему задачу с помощью команды /task_new. 





Передаем файлы между чатами

Пересылка различает два вида файлов: картинка и все остальное. Все остальное - это любые файлы, которые можно прикрепить к сообщению в Телеграм.  

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

Ниже описаны особенности передачи файлов в зависимости от того, куда и откуда они отправлены. 


Из чата Битрикс24 в другой чат Битрикс24


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





Все остальное отображается в дочернем чате так, как на скрине ниже. По клику на файл открывается новая вкладка, на которой происходит скачивание файла.





Из чата Битрикс24 в чат Телеграм 

Отправка любого файла будет в виде Документа, в том числе отправка картинок. Так сделано потому, что в противном случае Телеграм пережимает картинку, а мы хотели оставить качество неизменным.

Результат пересылки выглядит так:




Из чата Телеграм в чат Битрикс24

Отдельные фото и/или документы из Телеграма передаются в Б24 в таком виде:



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

Приписка передается в Б24 отдельным сообщением перед файлом.



Альбом Фото передается как несколько отдельных картинок, а приписка к альбому —  отдельным сообщением перед файлами.




Из одного Телеграм-чата в другой Телеграм-чат

Фото пересылается как Фото. При этом оно теряет оригинальное название файла - потому что Телеграм так делает с Фото.

Документ пересылается как Докумен:

Приписка передается отдельным сообщением перед файлом:

Альбом Фото передается как несколько отдельных Фото, а приписка к альбому —  отдельным сообщением перед файлами.