Описание приложения


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


Существует лишь базовая версия данного приложения (расширенной версии нет). Ранее Многоцелевой бот был известен под названием чат-бот REST Активити, но в какой-то момент он стал отдельным приложением "Многоцелевой и телеграм бот" 






Больше видео, демонстрирующих настройку и возможности использования Многоцелевого бота, можно найти в плейлисте по ссылке


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

А также нужно, чтобы бот был добавлен эти чаты. Как создавать чаты на портале Битрикс 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 в другой чат Битрикс24


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





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





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

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


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




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



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