Помогает подтянуть историю коммуникаций и задач из другой CRM-сущности прямо в текущую карточку, чтобы продолжить работу без потери контекста.
Для кого и какую проблему решает
Робот полезен для менеджера, который подтягивает дела исходного обращения в текущую карточку. После перехода к другой CRM-сущности нужная история остаётся в источнике. Робот использует текущую карточку как получателя, а источник задаётся явно, уменьшая число ручных параметров.
Что делает и когда применять
Робот полезен, когда текущая CRM-сущность уже создана, а история общения, задач и других дел осталась в другой карточке.
Робот особенно полезен в процессах, где текущая сущность уже существует и должна стать центральной карточкой для дальнейшей работы, а история пока хранится в другом CRM-элементе.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Проверьте контекст получателя и передайте тип и ID источника. Выберите add для добавления связи или move для переноса; режим обработки всех типов нужно задать явно.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Перенести или добавить дела из другой сущности в текущую». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Проверьте контекст получателя и передайте тип и ID источника. Выберите add для добавления связи или move для переноса; режим обработки всех типов нужно задать явно.
- Заполните Тип исходной сущности, ID исходной сущности, Режим работы, Обрабатывать все типы дел. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип исходной сущности (sourceEntityTypeId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID исходной сущности (sourceEntityId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Режим работы (actionMode) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Обрабатывать все типы дел (useAllTypes) |
Формат: да/нет. | Обязательно. Значение по умолчанию в настройках не задано |
Типы дел (activityTypes) |
Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип исходной сущности (
sourceEntityTypeId):1. - ID исходной сущности (
sourceEntityId):501. - Режим работы (
actionMode):add. - Обрабатывать все типы дел (
useAllTypes):Y.
При запуске в учебной сделке дела выбранного лида добавятся к этой текущей сделке. Запуск в другой карточке изменит получателя, поэтому контекст важен так же, как ID источника.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Тип исходной сущности (sourceEntityTypeId) |
целое число |
ID исходной сущности (sourceEntityId) |
целое число |
Тип целевой сущности (targetEntityTypeId) |
целое число |
ID целевой сущности (targetEntityId) |
целое число |
Общее количество дел (totalActivityCount) |
целое число |
Количество выбранных дел (matchedCount) |
целое число |
Количество обработанных дел (processedCount) |
целое число |
Количество новых привязок (bindCount) |
целое число |
Количество снятых привязок (unbindCount) |
целое число |
Количество ошибок (errorCount) |
целое число |
ID обработанных дел (processedActivityIds) |
строка, несколько значений |
ID пропущенных дел (skippedActivityIds) |
строка, несколько значений |
Ошибки обработки (errors) |
строка, несколько значений |
Режим выполнения (mode) |
строка |
Статус выполнения (status) |
да/нет |
Проверьте возвращённые тип и ID получателя, затем итоги обработки. При ошибках рассмотрите каждый ID до повтора, чтобы не считать частично выполненный перенос полным.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.