Оглавление
Общие сведения
После установки приложения REST Активити вы автоматически получите чат-бота, с помощью которого вы сможете рассылать сообщения. Вы можете использовать этого бота в бизнес-процесах, если вам нужны какие-либо специальные сообщения в чаты в ответ на события, и для решения других подобных задач.
Вы можете написать боту в его собственный чат, либо добавить его в нужный вам чат с другими пользователями. Любой пользователь может вызвать команду /get_post_link и с ее помощью создать в чате, где он ее вызвал, сообщение от лица бота.
Список команд для бота:
1. "/get_post_link" - дает ссылку для создания сообщения от лица бота в текущем чате. Перейдите по ссылке, допишите нужное сообщение в адресной строке после параметра message и перейдите по получившейся ссылке еще раз.
После этого в чате с ботом появится сообщение, написанное от лица бота с вашим текстом.
Значение в параметре key подойдет только для чата, из которого команда была вызвана.
2. "/invite_other_chat " - введите эту команду, чтобы получить заполненное значение для команды /join_other_chat. Параметр содержит секретный код для передачи сообщений между двумя чатами, в том числе на разных порталах. Пример вывода:
Получите код в первом чате, добавьте во второй чат Rest-бота и выполните там получившуюся команду. После этого бот начнет пересылать сообщения между чатами. Команда работает и внутри разных чатов на одном портале, и внутри разных чатов на разных порталах. Когда кто-то напишет сообщение в одном чате, бот перешлет в другой вот в таком виде:
3. "/join_other_chat" - требуется для того, чтобы присоединять чаты с помощью секретного кода, описанного в пункте 2. Чтобы получить эту команду с заполненным секретным кодом, выполните команду /invite_other_chat.
4. "/disconnect_from_all_chats " - команда для того, чтобы отсоединять чат. Если выполнить ее в родительском чате — том, откуда был получен код для приглашения других чатов, — все привязанные чаты отсоединятся и от этого чата, и друг от друга, и не смогут обмениваться сообщениями, пока снова не будут связаны. Также после выполнения этой команды в родительском чате, при вызове команды "/invite_other_chat " код привязки изменится.
Если эту команду вызвать в дочернем чате — том, который присоединился к родительскому по присланному коду, дочерний чат, в котором выполнили команду, отсоединится, но все остальные ранее связанные с ним чаты продолжат обмениваться сообщениями, и код привязки родительского чата не изменится.
Администраторам порталов
У пользователей с правами администраторов есть возможность получить ссылку для создания сообщения в любой чат. Для этого администратор портала должен написать в личный чат Rest бота его команду get_post_link, и тогда, помимо ссылки на создание сообщения в конкретном чате, он получит вторую ссылку с другим ключом, которая является универсальной. В нее можно подставлять номер группового или личного чата, куда бот отправит сообщение, заданное в параметре message.
Пример универсальной ссылки:
Подставьте вместо части НОМЕРЧАТА ID сотрудника на портале, если нужно, чтобы бот написал ему в личный чат. Например, ID администратора, который создал портал, всегда 1, чтобы бот написал ему в личный чат, нужно подставить его в универсальную ссылку так: (...)/1&key=(...)
Подставьте вместо части НОМЕРЧАТА номер чата, если нужно, чтобы бот написал в групповой чат. Например, номер чата 123 выглядит так: chat123, его нужно подставлять в универсальную ссылку так: (...)/chat123&key=(...).