Помогает получать и использовать комментарии из одной сущности при работе с другой, чтобы не терять контекст процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для администратора, который переносит комментарий между двумя CRM-карточками. Важный комментарий остаётся в исходной карточке, а исполнение ведётся в другой. Робот работает с явно указанными типами и ID источника и получателя, сохраняя контекст передачи.
Что делает и когда применять
Робот полезен, когда история комментариев нужна вне исходной карточки: при переносе, дублировании или связывании сущностей.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Выберите обе сущности в форме и проверьте их ID. Значения типов нужно брать из доступного выбора портала. До запуска проверьте, допустимо ли копировать исходный текст в другую карточку.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Копировать комментарий из таймлайна». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Выберите обе сущности в форме и проверьте их ID. Значения типов нужно брать из доступного выбора портала. До запуска проверьте, допустимо ли копировать исходный текст в другую карточку.
- Заполните Тип сущности, ID сущности, Тип сущности куда копируется, ID сущности куда копируется. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип сущности (entityType) |
Формат: выбор из списка. | Обязательно. Значение по умолчанию в настройках не задано |
ID сущности (entityId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Тип сущности куда копируется (entityTypeTo) |
Формат: выбор из списка. | Обязательно. Значение по умолчанию в настройках не задано |
ID сущности куда копируется (entityIdTo) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип сущности (
entityType): подставьте тип исходной сущности из списка формы. - ID сущности (
entityId):501. - Тип сущности куда копируется (
entityTypeTo): подставьте тип целевой сущности из списка формы. - ID сущности куда копируется (
entityIdTo):601.
При доступных комментариях источника и возможности записи получателя действие возвращает текстовые результаты и статус. Результат зависит от доступной истории, поэтому сначала сравните ожидаемый комментарий с исходной карточкой.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Статус выполнения (status) |
да/нет |
Первый комментарий (firstComment) |
строка |
Последний комментарий (lastComment) |
строка |
Все комментарии (allComments) |
строка, несколько значений |
Используйте статус для подтверждения шага, а возвращённый текст для сверки. Повторную передачу выполняйте после проверки результата, чтобы не размножать одинаковые комментарии.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.