Выбрать курс
- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
327
/
345
Получение сообщений из чата
Данное активити (робот) предназначено для поиска одного сообщения по ID внутри указанного диалога Битрикс24.
Результатом работы является набор отдельных полей сообщения: автор, дата, текст, статус прочтения, а также текст результата выполнения.
Результатом работы является набор отдельных полей сообщения: автор, дата, текст, статус прочтения, а также текст результата выполнения.
Как работает активити (робот):
- Вы указываете ID чата и ID сообщения;
- Активити (робот) делает постраничные запросы im.dialog.messages.get (по 50 сообщений);
- Если сообщение найдено, активити (робот) возвращает его данные в отдельных полях;
- Если сообщение не найдено в указанном чате, поля сообщения будут пустыми, а текст результата сообщит об этом.
- Вы указываете ID чата и ID сообщения;
- Активити (робот) делает постраничные запросы im.dialog.messages.get (по 50 сообщений);
- Если сообщение найдено, активити (робот) возвращает его данные в отдельных полях;
- Если сообщение не найдено в указанном чате, поля сообщения будут пустыми, а текст результата сообщит об этом.
Описание параметров активити (робота)
| Название поля | Описание и примеры использования |
|---|---|
| ID чата |
Обязательный параметр. Идентификатор чата или диалога. Примеры: - chat1489 — обычный чат; - sg25 — чат группы/проекта; - 503 — личный чат с пользователем. |
| ID сообщения |
Обязательный параметр. Целочисленный идентификатор сообщения, которое нужно найти в указанном чате. Пример: 493997. |
Примеры использования активити (робота)
| Описание примера | Решение |
|---|---|
| Получить данные конкретного сообщения в рабочем чате |
Передайте ID чата как chat1489 и ID сообщения 493997. Активити вернет автора, дату, текст, статус прочтения и текст результата. |
| Проверить сообщение в чате проекта |
Передайте ID чата как sg25 и ID сообщения 120045. Используйте параметр "Текст сообщения" в условии следующего шага для проверки ключевой фразы. |
| Получить сообщение из личного диалога с сотрудником |
Передайте ID чата как 503 (личный чат) и ID сообщения 88991. Используйте значения параметра "Автор сообщения" для проверки, кто отправил сообщение. |
| Проверить, прочитано ли сообщение |
Передайте chat1489 и нужный ID сообщения. В параметре "Статус прочтения" вернется значение: N или Y, его можно использовать в ветвлении БП. |
| Контроль отсутствия сообщения |
Если сообщение не найдено в указанном чате, параметр "Текст результата и ошибок" вернет текст "Сообщение с указанным ID в этом чате не найдено.", что удобно для обработки ошибок. |
Возвращаемые параметры данного активити:
- Автор сообщения (author_id);
- Дата создания (date);
- Текст сообщения (text);
- Статус прочтения (unread);
- Текст результата и ошибок (s_error_logs).
- Автор сообщения (author_id);
- Дата создания (date);
- Текст сообщения (text);
- Статус прочтения (unread);
- Текст результата и ошибок (s_error_logs).
Статус прочтения в поле unread возвращается в формате Y/N согласно логике активити (робота).