Обновление чата

Данное активити (робот) позволяет обновлять параметры чата в Битрикс24: владельца, название, аватар и цвет.
Результатом работы является обновление указанных параметров чата по его ID.

ВАЖНО!
Запускать активити может ТОЛЬКО владелец чата, который необходимо изменить. Если активити запускает пользователь, который не является владельцем чата, операция обновления не будет выполнена.

НЕЛЬЗЯ менять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.

Для обновления чата необходимо указать ID чата и хотя бы один из параметров для обновления:
- ID нового владельца (owner_id);
- Новое название (title_chat);
- Путь к файлу аватара (avatar_chat);
- Цвет чата (color_chat).

Если ни один из параметров обновления не будет указан, активити вернёт ошибку.

Описание параметров активити

Название поля	Описание и примеры использования
ID чата	В данном поле указывается числовой идентификатор чата, который необходимо обновить. Это обязательный параметр. Пример: {=Variable:CHAT_ID} или 12345. Как получить ID чата: - Из результата работы активити "Создание чата" (поле return_id_chat); - Из результата работы активити "Добавление сообщения в чат" (поле return_id_chat); - Сохранённый из предыдущих операций с чатами; - Переменная бизнес-процесса, в которой хранится ID чата. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:CHAT_ID}; - Из результата предыдущего активити: {=Activity123:return_id_chat}.
ID нового владельца чата	В данном поле указывается идентификатор пользователя, который станет новым владельцем чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_OWNER_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 123; - Формат Битрикс24: [U1], [U5], [U10]; - Через переменную: {=Variable:OWNER_ID}; - Из поля документа: {=Document:ASSIGNED_BY_ID}. Важно: Изменить владельца может только текущий владелец чата. После смены владельца права на управление чатом переходят к новому владельцу.
Новое название чата	В данном поле указывается новое название (заголовок) чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_TITLE} или "Проект Альфа". Примеры использования: - Прямое указание: "Новое название чата"; - Через переменную: {=Variable:CHAT_TITLE}; - Из поля документа: "Чат по сделке {=Document:TITLE}"; - С использованием функций: "Чат от {{=date('d.m.Y')}}". Ограничения: Название чата не должно быть пустым. Максимальная длина названия ограничена возможностями API Битрикс24.
Путь к файлу аватара	В данном поле указывается путь к файлу изображения, который будет использован в качестве аватара чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:AVATAR_PATH} или "https://example.com/avatar.jpg". Форматы указания пути: - Полный URL: "https://example.com/images/avatar.png"; Требования к файлу: - Файл должен быть доступен для чтения; - Поддерживаемые форматы: JPG, PNG, GIF; - Рекомендуемый размер: не более 2 МБ; - Изображение будет автоматически конвертировано в формат base64. ВАЖНО! Нельзя изменять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании, смарт-процессы и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.
Цвет чата	В данном поле из выпадающего списка можно выбрать цвет чата для мобильного приложения. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:CHAT_COLOR} или выбор из списка. Доступные цвета: - КРАСНЫЙ (RED); - ЗЕЛЕНЫЙ (GREEN); - МОНЕТНЫЙ ДВОР (MINT); - СВЕТЛО ГОЛУБОЙ (LIGHT_BLUE); - ТЁМНО ГОЛУБОЙ (DARK_BLUE); - ФИОЛЕТОВЫЙ (PURPLE); - ВОДА (AQUA); - РОЗОВАЯ (PINK); - ИЗВЕСТЬ (LIME); - КОРИЧНЕВАЯ (BROWN); - ГОЛУБАЯ (AZURE); - ЦВЕТА (KHAKI); - ХАКИ (SAND); - ПЕСОК (MARENGO); - СЕРЫЙ (GRAY); - ГРАФИТ (GRAPHITE). Примеры использования: - Прямой выбор из списка; - Через переменную: {=Variable:COLOR} (значение должно соответствовать одному из доступных цветов).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Важно: Указанный сотрудник должен быть владельцем чата, иначе обновление не будет выполнено. Рекомендуем выбирать владельца чата или сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Смена владельца чата при передаче проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, ID нового владельца - {=Document:NEW_MANAGER_ID}. При передаче проекта новому менеджеру робот автоматически меняет владельца чата проекта, передавая права управления новому ответственному.
Обновление названия чата при изменении названия сделки	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При изменении названия сделки робот синхронизирует название связанного чата, чтобы оно соответствовало текущему названию сделки.
Изменение цвета чата для визуального разделения по приоритетам	Параметры: ID чата - {=Activity123:return_id_chat}, Цвет чата - RED (для высокого приоритета) или GREEN (для низкого приоритета). Робот меняет цвет чата в зависимости от приоритета задачи или проекта для быстрой визуальной идентификации.
Обновление аватара чата при создании нового проекта	Параметры: ID чата - {=Activity456:return_id_chat}, Путь к файлу аватара - {=Variable:PROJECT_LOGO_URL}. При создании нового проекта робот устанавливает логотип проекта в качестве аватара чата для лучшей визуальной идентификации.
Массовое обновление названий чатов при реорганизации	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Отдел {=Variable:NEW_DEPARTMENT_NAME} - {=Variable:CHAT_NUMBER}". При реорганизации отделов робот обновляет названия всех чатов отдела, добавляя новое название отдела в начало названия чата.
Смена владельца и цвета при эскалации задачи	Параметры: ID чата - {=Document:CHAT_ID}, ID нового владельца - {=Document:ESCALATED_TO_ID}, Цвет чата - RED. При эскалации задачи робот передаёт чат новому ответственному и меняет цвет на красный для привлечения внимания к срочной задаче.
Обновление названия чата с датой создания	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Чат от {{=date('d.m.Y', {=Variable:CREATED_DATE})}}". Робот обновляет название чата, добавляя дату его создания для удобства навигации по истории чатов.
Изменение цвета чата в зависимости от статуса проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, Цвет чата - {{=if({=Document:STATUS_ID}=="ACTIVE", "GREEN", "GRAY")}}. Робот автоматически меняет цвет чата в зависимости от статуса проекта: зелёный для активных, серый для завершённых.
Обновление названия и владельца при смене ответственного за сделку	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, ID нового владельца - {=Document:ASSIGNED_BY_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При смене ответственного за сделку робот обновляет владельца чата и синхронизирует название с текущим названием сделки.
Установка корпоративного аватара для всех новых чатов отдела	Параметры: ID чата - {=Activity789:return_id_chat}, Путь к файлу аватара - "https://company.com/logos/department_logo.png". При создании нового чата отдела робот автоматически устанавливает корпоративный логотип отдела в качестве аватара для единообразия визуального стиля.

Сценарий работы активити бизнес-процесса

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

Смена владельца чата при передаче проекта или задачи другому сотруднику;
Синхронизация названия чата с названием связанной сущности (сделка, проект, задача);
Визуальное разделение чатов по приоритетам или статусам через изменение цвета;
Установка корпоративных аватаров для чатов отделов или проектов;
Массовое обновление параметров чатов при реорганизации структуры компании;
Автоматическое обновление названий чатов при изменении статусов или приоритетов;
Эскалация чатов с изменением владельца и визуального оформления;
Персонализация чатов с установкой индивидуальных аватаров и цветов.

Особенности работы с параметрами обновления:
- Можно указать только один параметр для обновления (например, только название);
- Можно указать несколько параметров одновременно (например, название и цвет);
- Все указанные параметры будут обновлены в рамках одного вызова активити;
- Если ни один параметр обновления не указан, активити вернёт ошибку;

Лучшие практики использования обновления чатов:
1. Всегда проверяйте права доступа перед обновлением чата (убедитесь, что пользователь является владельцем);
2. Не пытайтесь изменять аватар у чатов, привязанных к CRM сущностям;
3. Используйте переменные для хранения ID чатов для последующего обновления;
4. Сохраняйте return_id_chat из активити создания чата для дальнейшего использования;
5. Комбинируйте несколько параметров обновления для комплексного изменения чата;
6. Используйте цвета для визуального разделения чатов по категориям или приоритетам;
7. Синхронизируйте названия чатов с названиями связанных сущностей для удобства навигации;
8. При смене владельца убедитесь, что новый владелец имеет необходимые права доступа.

Ваша корзина пуста

Обновление чата