Инструкция для Многоцелевого бота от IT-Solution

Ссылка на чат-бота для Битрикс24
https://www.bitrix24.ru/apps/?app=itsolutionru.unibot

Все команды для Телеграм Бота здесь

Общие сведения

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

Связываем чаты на порталах Битрикс24

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

"/get_post_link" - дает ссылку для создания сообщения от лица бота в текущем чате. Перейдите по ссылке, допишите нужное сообщение в адресной строке после параметра message и перейдите по получившейся ссылке еще раз. 

После этого в чате с ботом появится сообщение, написанное от лица бота с вашим текстом. 

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

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

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


"/invite_other_chat" - введите эту команду, чтобы получить заполненное значение для команды /join_other_chat. Параметр содержит секретный код для передачи сообщений между двумя чатами, в том числе на разных порталах. Если чаты на разных порталах, бота необходимо установить на оба портала.
Пример вывода:

Получите код в первом чате, добавьте во второй чат Rest-бота и выполните там получившуюся команду. После этого бот начнет пересылать сообщения между чатами. Команда работает и внутри разных чатов на одном портале, и внутри разных чатов на разных порталах. Когда кто-то напишет сообщение в одном чате, бот перешлет в другой вот в таком виде: 

 


"/join_other_chat" - требуется для того, чтобы присоединять чаты с помощью секретного кода, описанного в пункте 2. Чтобы получить эту команду с заполненным секретным кодом, выполните команду /invite_other_chat. 

"/disconnect_from_all_chats" - команда для того, чтобы отсоединять чат. Если выполнить ее в родительском чате — том, откуда был получен код для приглашения других чатов, — все привязанные чаты отсоединятся и от этого чата, и друг от друга, и не смогут обмениваться сообщениями, пока снова не будут связаны. Также после выполнения этой команды в родительском чате, при вызове команды "/invite_other_chat " код привязки изменится. 

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

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


Администраторам порталов

У пользователей с правами администраторов есть возможность получить ссылку для создания сообщения в любой чат. Для этого администратор портала должен написать в личный чат UNI бота его команду get_post_link, и тогда, помимо ссылки на создание сообщения в конкретном чате, он получит вторую ссылку с другим ключом, которая является универсальной. В нее можно подставлять номер группового или личного чата, куда бот отправит сообщение, заданное в параметре message.

Пример универсальной ссылки:


Подставьте вместо части НОМЕРЧАТА ID сотрудника на портале, если нужно, чтобы бот написал ему в личный чат. Например, ID администратора, который создал портал, всегда 1, чтобы бот написал ему в личный чат, нужно подставить его в универсальную ссылку так: (...)/1&key=(...)

Подставьте вместо части НОМЕРЧАТА номер чата, если нужно, чтобы бот написал в групповой чат. Например, номер чата 123 выглядит так: chat123, его нужно подставлять в универсальную ссылку так: (...)/chat123&key=(...).
Если вы не знаете номер группового чата, его можно увидеть, выполнив в этом чате команду "/get_post_link". В полученной ссылке будет присутствовать id чата.


Бронирование ресурсов

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

Создайте пользовательское поле с таким типом, затем перейдите в настройки поля:

В настройках можно будет создать Ресурсы: 

После этого вы сможете выбирать нужные время и ресурс (например, "15:00 - комната совещаний" и т.п.)

Когда вы вызываете в чате команду /booking_show Многоцелевой Бот в ответ покажет, какие ресурсы забронированы на портале, где авторизован пользователь, вызвавший команду.

Пересылка скрытых сообщений из Открытых Линий Битрикс24




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

До мая 2022 года Многоцелевой бот пересылал эти сообщения в связанные чаты. Если вам, к примеру, требовалось транслировать все содержимое чата ОЛ куда-то еще, бот позволял это сделать и пересылать все сообщения, включая скрытые.

С мая 2022 года вы можете управлять возможностью пересылки. На стороне Битрикс24 у Многоцелевого бота появилась новая команда:

/mute_silent_connector

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

Внимание! По умолчанию пересылка скрытых сообщений ОТКЛЮЧЕНА.

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

/mute_silent_connector 0

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

/mute_silent_connector 1


Взаимодействие с Telegram

Передачу сообщений между несколькими чатами можно настроить не только для чатов Битрикс24, но и для чатов в Telegram.
Можно создавать связи между Telegram-чатами и Битрикс24-чатами в любых сочетаниях.
Для этого можно использовать аналогичного Telegram бота
https://t.me/its_bitrix24_bot
Этот Telegram бот обладает аналогичными командами "/invite_other_chat" , "/join_other_chat" и "/disconnect_from_all_chats"

Видео ниже демонстрирует связь чатов с помощью бота, когда он еще был частью другого приложения. С тех пор он перерос в отдельное приложение, которое вы используете сейчас, адрес бота Телеграм изменился на https://t.me/its_bitrix24_bot ,  но принцип работы остался тот же.



Требования к группам

Важно! Привязывать можно только ЧАТЫ, но не КАНАЛЫ

Группа может быть как обычной, так и Супергруппой Телеграм. С 25.01.2022 по 11.03.2022 авторизация работала только в Супергруппах, однако это требование было отменено в связи с тем, что у пользователя Телеграм может быть ограниченное количество Супергрупп, а мы хотим, чтобы Многоцелевой бот работал без ограничений, в любом количестве групп. 

устаревшие требования

Группа должна быть Супергруппой Телеграм. (Требование вступило в силу 25.01.2022)

При создании новой группы в Telegram система по умолчанию создаст базовую группу. Чтобы превратить обычную группу в Супергруппу, нужно выполнить одно из этих действий:

— Изменить тип группы на публичный (после можно вернуть обратно, она также останется супергруппой).
— Изменить настройки «видимость истории» для новых пользователей.
— Выдать любому пользователю админ права с кастомной ролью.
— Настроить любой параметр глобальных прав для всей группы.
— Активировать медленный режим.
— Ограничить любого участника.
— Привязать группу к каналу.

Именно в Супегруппе вам станет доступна команда бота 

/auth

Убедтесь, что ваша группа была сконвертирована в Супергруппу, прежде, чем начать работу с Многоцелевым ботом. 


Информация по задачам из групп Битрикс24 в чатах Телеграм

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

Чтобы начать получать информацию о задачах, выполните следующие шаги:

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

2. Пригласите бота @its_bitrix24_bot в нужный вам чат Телеграм и вызовите команду "/auth адрес_портала" в этом чате, чтобы авторизоваться.

3. Бот даст вам ссылку "Авторизоваться". Нажмите ее и залогиньтесь на портале. После перехода по ссылке и авторизации вы должны увидеть сообщение на портале:

и в чате Телеграм:

4. Теперь можно привязывать группы к чату. Чтобы привязать группу, используйте в чате Телеграм команду "/bind_group id_группы" .(например, /bind_group 10 для группы с id 10). Узнать id группы можно на ее странице в адресной строке, либо во всплывающей подсказке внизу, которая появляется при наведении курсора на название группы в списке. 

Когда группа будет привязана, бот уведомит вас об этом в чате. 

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

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

Количество привязываемых групп неограниченно. 

5. Вы можете получить полный список незавершенных задач в привязанных группах на том портале, где вы совершили последнюю авторизацию. Для этого выполните в чате команду "/get_groups_tasks"

6. /unbind group команда для отвязывания группы. Введите эту команду и id группы, чтобы отвязать группу, например /unbind group 10. 

7.  /binded_groups_list показывает список всех групп, привязанных к чату, для портала, на котором авторизован пользователь, выполнивший команду. 

 

REST запросы в чате Телеграм

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

/restcall команда для вызова REST-запроса к порталу, где вы авторизованы. Напишите нужный запрос, укажите параметры, если необходимо, и Многоцелевой бот пришлет ответ в чат. Синтаксис: /restcall ["рест-метод", {"параметр":"значение"}]

Вот пример запроса user.get на ID Битриксового Чат-Бота Марты:

Вот пример выполнения метода app.info, без параметров:

Пересылаем файлы между Битрикс4 и Телеграм

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

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

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

Отправка из чата Битрикс24 в чат Битрикс24

Любой файл, который НЕ является картинкой, пересылается в виде файла и выглядит так:

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

Пересланная картинка имеет превью:

На картинку можно кликнуть, и тогда откроется новая вкладка, где она откроется в полном размере.

Отправка из Битрикс24 в Телеграм

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

Отправка файлов из Телеграм - общие особенности

В Телеграм можно отправить файл как Фото (так можно отправить только картинки, но тогда они ужимаются) или как Документ.

Фото выглядит так:

А вот как выглядит Документ:

В оба вида отправки файлов можно добавить приписку (сам Телеграм даст поле для нее при отправке). Результат выглядит так:

Отравляя несколько картинок сразу из Телеграма, вы можете отправить их как Альбом, к нему также можно добавлять приписку:

Можно еще отправить "как несколько отдельных фото" или "как несколько отдельных документов":

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

Отправка из Телеграм в Битрикс24

Единичные "Документы" или "Фото" из Телеграма передаются в Б24 в таком виде:

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

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

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

Отправка из одного Телеграм чата в другой Телеграм чат

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

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

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

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

Запуск Бизнес-процесса по сообщению в чатах

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

Многоцелевой бот в Открытых Линиях


В настройках нужной вам открытой линии выберите Настроить>Чат-боты и сделайте следующие настройки:

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

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

Требования к бизнес-процессу:

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

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

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

seconds_from_previous_message Сколько секунд прошло после предыдущего сообщения в этом чате
dialog_id id Диалога
message_id id Сообщения
text Текст сообщения
chat_type Тип чата (открытая линия / групповой чат и т.д.)
chat_entity_type Дополнительный параметр о типе чата
lead_id id Лида связанного с чатом (если есть)
company_id id Компании связанной с чатом (если есть)
contact_id id Контакта связанного с чатом (если есть)
deal_id id Сделки связанной с чатом (если есть)
message_type Тип сообщения
author_user_id id пользователя Б24, который написал сообщение
author_full_name Полное имя автора сообщения
author_first_name Имя автора сообщения (без фамилии)
author_last_name Фамилия автора сообщения
author_is_extranet Автор относится к extranet
author_is_network Автор относится к network
author_work_position Должность автора сообщения
author_gender Пол автора сообщения
to_user_id id пользователя Б24, которому адресовано сообщение
current_dialog_number     Номер диалога в чате открытой линии. (номер диалога меняется, например, после повторного обращения того же клиента через некоторое время)

Чтобы использовать параметры из приложения в бизнес-процессах, добавьте ссответствующий параметр в шаблон бизнес-процесса. ОБЯЗАТЕЛЬНО введите название параметра из приложения в поле Идентификатор при создании параметра в шаблоне. Например, если в бизнес-процессе требуется параметр author_last_name, именно так и нужно задать его идентификатор:

Результат каждого выполнения бизнес-процесса будет сохраняться в инфоблоке. В поле Название по умолчанию сохранится время сообщения в формате unix timestamp. Другими данными лучше это поле не заполнять. 

Многоцелевой бот во внутренних чатах сотрудников на портале


Пригласите бота в нужный вам внутренний чат на портале. 

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

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


Поиск компании в чатах Телеграм

Если вам требуется поделиться ссылкой на компанию в чате Телеграм, вы можете легко это сделать с помощью многоцелевого бота. Авторизуйтесь на портале, где вам требуется производить поиск, с помощью команды /auth, а затем напишите новое сообщение, в начале которого обратитесь к боту по его никнейму: @its_bitrix24_bot. Вы увидите, что в поле сообщения появится подсказка "введите название компании". 

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

Кликните на нужный вам вариант, и в чат отправится ссылка на компанию. 

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


Добавление лидов через чат Телеграм

С помощью многоцелевого бота вы можете создавать лидов на авторизованном портале прямо через чат Телеграм. Авторизуйтесь на портале, где вам требуется создавать лидов, с помощью команды /auth, а затем выполните команду:

/new_lead@its_bitrix24_bot *имя, телефон, почта, веб-адрес*  и т.п.

После команды в принципе можно ввести любой текст, например:


Отправив команду с этими данными, получим ссылку на созданный лид

Бот определит, что из введенного вами было телефоном, почтой  и адресом, и расставит все в соответствующие поля лида. 


Создание задач в группе через чаты Телеграм


Вы можете создавать задачи через чат в группу, которую вы привязали к чату. 

/put_task@its_bitrix24_bot  - создать задачу в привязанной группе. Пример: /put_task@its_bitrix24_bot  текст_задачи

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

Чтобы создавать задачи и указывать ответственными других пользователей, на портале в профиле сотрудника требуется заполнить дефолтное поле Xing юзернеймом сотрудника в телеграме.


Когда сотрудники укажут свои юзернеймы в этом поле на портале, им можно будет ставить задачи через телеграм-бот:

 /put_task@its_bitrix24_bot  текст_задачи @юзернейм_сотрудника


Внимание! Этот функционал подразумевает то, что в чат вы привязали только одну группу, для которой планируете  ставить задачи. Возможность выбора между несколькими группами при постановке задачи через чат отсутствует. Если привязано несколько групп, задача создастся в случайно выбранной группе.


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

Фильтрация системных сообщений о задачах в группах


Приложение Многоцелевой бот уже давно умеет передавать события из задач Битрикс24 в чаты Телеграм. Но что, если вам не хочется получать все существующие системные сообщения (так называемые пинги Битрикс24), потому что чат забивается ими и его становится неудобно читать?

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

Особенности работы:

  • Настройки доступны только администраторам
  • При включенной фильтрации некоторые системные комментарии к задачам не будут пересылаться в telegram.
  • Эта настройка применяется сразу ко всему порталу Б24. 
  • Типы системных комментариев, которые отфильтровываются:

            "Крайний срок изменен на: ..."

            "Задача почти просрочена. Завершите задачу или передвиньте срок."


Чтобы воспользоваться настроками

- со стороны портала Битрикс24, нажмите здесь: 

- со стороны Телеграм, выполните команду

/info@its_bitrix24_bot

В полученном ответном сообщении нажмите здесь

Комментарии с картинками к задачам в Битрикс24 через чаты Телеграм


Вы можете добавлять комментарии к задачам прямо через чаты Телеграм. Опубликуйте ответ на сообщение с уведомлением о том, что задача создана. При желании можно добавлять картинки. Когда вы отправите ответ на сообщение, в задаче на портале Многоцелевой бот создаст комментарий с текстом и картинкой из вашего ответа.

Пример комментария с картинкой

Результаты на портале:


Быстрый контекст задачи, созданной через Телеграм

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

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

Это быстро и удобно! Демонстрация функционала на видео ниже:




Upd 22.09.21 Кнопки с командами

Добавлены кнопки, некоторые команды теперь можно не только выполнять вручную, но и по нажатию кнопок прямо в чате.

Чтобы попасть в меню с кнопками, введите в чате

 /groups@its_bitrix24_bot 

В ответ на выполнение команды, появится сообщение со списком привязанных групп и кнопками.

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

Вы также можете привязывать группу по ID


Время в отчете выводится в таблице, одна запись — один отрезок времени, внесенный в задачу.

Внимание! В отчете видны только  завершенные отрезки времени! Если в задаче имеется запущенный счетчик времени, информация попадет в отчет только после того, как счетчик будет остановлен.

Запущенный счетчик времени (время не попадает в отчет, пока счетчик не остановлен)

Остановленный счетчик времени (время попадет в отчет)


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

/tasks@its_bitrix24_bot — Выводит список задач из групп, привязанных к чату Телеграм. Список покажет количество задач в каждой стадии канбана группы. 

Внимание! В Битриксе на текущий момент может не передаваться название первой стадии канбана, в зависимости от того, каким образом была создана задача. Если мы не получили информацию о названии стадии, то бот напишет "стадия не указана"





Создание постов в ленту новостей группы через чат Телеграм


Создавайте посты в группу через чат Телеграм:

/put_blogpost@its_bitrix24_bot - создать пост в группу. Пример /put_blogpost@its_bitrix24_bot текст_поста

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

в результате получаем такой пост в группе:

Внимание! Этот функционал подразумевает то, что в чат вы привязали только одну группу, для которой планируете создавать посты. Возможность выбора между несколькими группами при создании поста через чат отсутствует. Если к чату привязано несколько групп, то пост будет создан во всех этих группах.


/put_blogpic@its_bitrix24_bot - Создать пост, состоящий из картинки с текстом. Введите требуемый текст после этой команды, и получите пост в группе с картинкой, на которой написан ваш текст.
Пример:
/put_blogpic@its_bitrix24_bot текст_который_надо_написать_на_картинке

в результате получается:

Внимание! Этот функционал подразумевает то, что в чат вы привязали только одну группу, для которой планируете  создавать посты. Возможность выбора между несколькими группами при создании поста через чат отсутствует. Если к чату привязано несколько групп, то пост будет создан во всех этих группах.


Привязываем направления сделок к чату Телеграм


Появилась возможность привязывать к чату Телеграм направление сделок из CRM. Доступно только для администраторов портала.
В чат будут прилетать уведомления о движениях сделок по выбранной воронке.

Привязывать можно несколько направлений.

Привязка осуществляется по id направления. Id общего направления сделок (направления по умолчанию) — всегда 0. Если у вас на портале более одного направления, вы сможете увидеть ID в адресной строке: https://адрес_портала/crm/deal/kanban/category/id/

Пример вызова команды (привязываем общее направление):
/bind_dealcategory@its_bitrix24_bot 0 

Уведомления в чате будут выглядеть так:

Чтобы посмотреть список привязанных команд, выполните:

/binded_dealcategories_list@its_bitrix24_bot

Чтобы отвязать направление, введите команду отвязывания и id направления. Пример:

/unbind_dealcategory@its_bitrix24_bot 0

Управление CRM


/crm@its_bitrix24_bot — Управление CRM. В ответ появляется список кнопок: Посмотреть дела, Проверить контакты в CRM, Поиск компании по названию, Выбрать непривязанное направление сделок, Привязать направление сделок по ID.


По кнопке Посмотреть дела покажется 4 кнопки на выбор, в скобках будет число дел, попавших в категорию.

По клику на категорию бот выдаст список дел в ней со ссылками на портал.

Например, выбираем "На сегодня", получаем в ответ список дел на текущую дату со ссылками:

/search_company@its_bitrix24_bot — Поиск компании в CRM. В ответ возвращает ссылку на компанию на портале. Аналонично вводу команды работает кнопка Поиск компании по названию. Чтобы пользоваться поиском, передайте название компании. 

Проверка контактов

По кнопке Проверить контакты в CRM будет поиск, аналогичный команде /check_contacts@its_bitrix24_bot — поиск по почте или телефону

Работа со сделками

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

Обратите внимание, что слева от названия направления в скобках указано его ID.

Вы также можете привязывать направления по ID, с помощью кнопки Привязать направление сделок по ID.

В привязанных направлениях вы можете создавать сделки. 

В результате бот создаст сделку и вернет ссылку на нее.

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



Отслеживание рабочего дня в чатах Телеграм


В 6 версии Многоцелевого бота добавилась возможность вести учет рабочего времени в чате Телеграм, а также на портале Битрикс24, если ваш тариф позволяет использовать учет рабочего времени.

Авторизуйтесь в чате Телеграм с помощью команды /auth (адрес нужного вам портала). 

Установите начало рабочего дня с помощью команды /time_start_workday@its_bitrix24_bot. Она запускает отсчет времени рабочего дня, время зафиксируется в чате Телеграм. Если на вашем портале доступно отслеживание рабочего дня, после выполнения команды кнопка рабочего дня на портале также включится. После запуска команды каждый час будет появляться напоминание о том, что следует записать, что вы делали за прошедший час, используя команду /time_checkpoint@its_bitrix24_bot

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


Вносите записи в отчет с помощью команды /time_checkpoint@its_bitrix24_bot

После команды /time_checkpoint@its_bitrix24_bot через пробел нужно описать что вы сделали за предыдущий интервал

Пример:

/time_checkpoint@its_bitrix24_bot посмотрел видеоурок про установку 1С
посмотрел урок про типы переменных
установил и запустил 1с

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


Просматривайте список внесенных дел в течение рабочего дня с помощью команды /time_status@its_bitrix24_bot



Завершите рабочий день с помощью команды /time_stop_workday@its_bitrix24_bot.

Она останавливает отсчет времени рабочего дня, время зафиксируется в чате Телеграм. Если на вашем портале доступно отслеживание рабочего дня, после выполнения команды кнопка рабочего дня на портале также выключится. 


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


/time@its_bitrix24_bot — вызывает меню с кнопками управления рабочим днем: Запустить рабочий день, Остановить рабочий день, Зафиксировать работы, Статус рабочего дня.

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

Стоп-контакты

Вы можете настроить список исключений для поиска, который Многоцелевой бот выполняет, когда в чате Телеграм кто-то присылает адрес сайта, почту или телефонный номер.

Выполните в авторизованном чате Телеграм команду /info@its_bitrix24_bot

Перейдите по ссылке "Настройки бота для портала Б24" из ответного сообщения бота.

Вы попадете на страницу создания стоп-контактов.

Указанные "стоп-контакты" будут игнорироваться при ручном вызове команды "/check_contacts" или ее автоматическом срабатывании по тексту нового сообщения. Можно использовать маски: "?" - один любой символ, "*" - любое кол-во любых символов.

Стоп-контакты нужны, чтобы убирать ненужные данные из поиска бота, например, чтобы поиск не срабатывал на адрес вашего сайта. Маска дает возможность исключить из поиска поддомены вашего сайта, например запись *.it-solution.ru — засчет звездочки включает и snapi.it-solution.ru и b24-hr.it-solution.ru и так далее.

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



Календарь: получение списка запланированных событий в чат Телеграм


/calendar@its_bitrix24_bot — Показывает список событий, запланированных в календаре. После вызова команды появляется кнопка "Мой график на ближайшие N дней", нажмите ее и введите желаемое количество дней. В ответ бот вернет расписание из календаря на введенное вами количество дней вперед.

Кнопки многоцелевого бота для открытых линий в Телеграм

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


Кнопки меню /users


Авторизуйтесь на портале через чат Телеграм, выполнив команду /auth, и получайте уведомления о дейтсвиях, совершенных привязанными сотрудниками в CRM, а также отчет о времени, которое они внесли в задачи на портале.

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

Привяжите сотрудника удобным вам способом — из списка или по ID на портале

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

Внимание! Чтобы время попадало в отчет трудоемкости, в задачах на портале должна стоять соответствующая галочка!

Вы сможете отключить уведомления, если захотите.

Уведомления о действиях в CRM будут создаваться со ссылками на соответствующие Дела:

Каждый день в 11:00 по Москве в чат будет прилетать отчет за вчерашний день о трудоемкости (времени, внесенном в задачи) по привязанным пользователям.



Робот в CRM для отправки уведомлений в чаты Телеграм

У приложения Многоцелевой бот появился робот в CRM, с помощью которого вы можете отправлять в привязанный чат Телеграм настраиваемые вами уведомления. Вы сможете получать информацию о движениях сделок, лидов и т.д. не открывая портал.


Настройки на стороне Битрикс24

Настройте робота на портале в нужных вам стадиях:

Внутри робота создайте нужный вам текст уведомления и укажите получателя в поле target:

  • если получатель пользователь, запишите в поле target значение user(id пользователя на портале), например user1
  • если получатель группа, запишите в поле target значение group(id пользователя на портале), например group1

Внимание! В поле target можно внести только одно значение, id пользователя или группы пишем без пробела!

Настройки на стороне Телеграм

В нужном вам чате Телеграм авторизуйтесь на портале, выполнив команду:

/auth@its_bitrix24_bot адрес_вашего_портала

а затем привяжите к чату пользователя или группу.

Чтобы привязать пользователя, выполните команду 

/users@its_bitrix24_bot 

а затем выберите нужного вам пользователя и привежите его по кнопке

Чтобы привязать группу, выполните команду 

/groups@its_bitrix24_bot

затем нажмите любую кнопку из появившегося списка и привяжите группу удобным вам способом — из списка или по id

После того, как все настройки будут выполнены, при выполнении условий для срабатывания робота в CRM, в ваш чат Телеграм будут приходить настроенные вами уведомления


Прочее

/mute_outgoing_messages 1 - отключить транслирование из чата, 0 - включить транслирование снова.

/mute_message - напишите после этой команды сообщение, которое бот не должен пересылать

/check_contacts - проверить контакты в CRM (+79999999999, +79998888888)

/my activities  - получить список дел на портале для пользователя, под которым вы авторизованы. 

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

 /mute_outgoing_messages - Отключить пересылку из этого чата (сообщения из других привязанных чатов продолжат транслироваться). Чтобы возобновить пересылку, выполните
/mute_outgoing_messages@its_bitrix24_bot 0

/bind_responsible@its_bitrix24_bot - Привязать ответственного. После того, как привязали ответственного, в чат начнут прилетать уведомления, когда создается или редактируется:

  • Лид,
  • Сделка,
  • Контакт,
  • Контакт,
  • Дело,

за которые является отвественным на портале тот пользователь, чей id привязали в чате. 

В комнаду требуется передать id пользователя, которого привязываем. Пример:

/bind_responsible@its_bitrix24_bot 123

Когда в CRM на портале будут создаваться или изменяться сущности, за которые ответственнен привязанный юзер, в чате появятся подобные уведомления от бота: