Обновить собственный комментарий таймлайна
Меняет текст комментария, созданного пользователем подключения приложения.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, обновляющего комментарий от пользователя подключения приложения. В таймлайне нужно уточнить уже опубликованный итог, сохранив связь с исходной записью. Робот изменяет только собственный комментарий и проверяет ожидаемый прежний текст, чтобы не затереть чужую правку.
Что делает и когда применять
Меняет текст комментария, созданного пользователем подключения приложения.
Принимает тип и ID карточки, ID комментария, ожидаемый прежний и новый текст. Проверяет карточку, автора и прежний текст; возвращает текст после повторного чтения. Файлы не передаются на изменение. Одновременные правки не блокируются, поэтому обновления нужно запускать последовательно. Чужие и системные записи таймлайна этим роботом не редактируются.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Возьмите тип и ID карточки, ID комментария и его точный нынешний текст. Автором должен быть пользователь подключения приложения. Чужие и системные записи нельзя исправлять этим действием.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Обновить собственный комментарий таймлайна». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Возьмите тип и ID карточки, ID комментария и его точный нынешний текст. Автором должен быть пользователь подключения приложения. Чужие и системные записи нельзя исправлять этим действием.
- Заполните Тип карточки CRM, ID карточки CRM, ID комментария, Ожидаемый прежний текст, Новый текст. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип карточки CRM (OWNER_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID карточки CRM (OWNER_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID комментария (COMMENT_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Ожидаемый прежний текст (EXPECTED_TEXT) |
Формат: текст. | Обязательно. Значение по умолчанию в настройках не задано |
Новый текст (TEXT) |
Формат: текст. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип карточки CRM (
OWNER_TYPE_ID):2. - ID карточки CRM (
OWNER_ID):501. - ID комментария (
COMMENT_ID):900. - Ожидаемый прежний текст (
EXPECTED_TEXT):Состав заказа согласован.. - Новый текст (
TEXT):Состав заказа согласован. Адрес доставки подтверждён..
Если автор, карточка и прежний текст совпали, сохранится новая формулировка. При уже изменённом исходном тексте действие не должно молча заменить его. Файлы комментария не передаются на изменение.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID комментария (commentId) |
целое число |
Сохранённый текст (text) |
текст |
Текст изменён (changed) |
да/нет |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Используйте «Сохранённый текст» после подтверждённого статуса. Последующие правки запускайте по очереди, каждый раз передавая актуальное ожидаемое значение; параллельные изменения не блокируются.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.