Закрепить или открепить запись таймлайна

Выделяет важную запись в карточке CRM или снимает её закрепление.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для менеджера сопровождения, который выделяет важный итог переговоров. Согласованные условия теряются в длинном таймлайне. Робот закрепляет выбранную запись в конкретной карточке или снимает закрепление, когда информация больше не актуальна.

Что делает и когда применять

Выделяет важную запись в карточке CRM или снимает её закрепление.

Полезен для итогов переговоров и согласований. Принимает ID записи, тип и ID элемента CRM и действие. Возвращает признак закрепления после подтверждения операции. Права и лимит закреплённых записей определяются порталом.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Получите ID записи таймлайна и точные тип и ID её карточки. Выберите действие «Закрепить» или «Открепить»; право на операцию и число закреплений определяются порталом.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Закрепить или открепить запись таймлайна». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Получите ID записи таймлайна и точные тип и ID её карточки. Выберите действие «Закрепить» или «Открепить»; право на операцию и число закреплений определяются порталом.
3. Заполните ID записи таймлайна, Тип элемента CRM, ID элемента CRM, Действие. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
ID записи таймлайна (ITEM_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Тип элемента CRM (ENTITY_TYPE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID элемента CRM (ENTITY_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Действие (ACTION)	Формат: выбор из списка. Варианты: pin: Закрепить; unpin: Открепить.	Обязательно. По умолчанию: pin

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID записи таймлайна (ITEM_ID): 900.
• Тип элемента CRM (ENTITY_TYPE_ID): 2.
• ID элемента CRM (ENTITY_ID): 501.
• Действие (ACTION): pin.

Для доступной записи 900 в сделке 501 после подтверждения операции результат показывает закрепление. Если портал отклонил действие из-за прав или лимита, положительный результат ожидать нельзя.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID записи (itemId)	целое число
Закреплена (pinned)	да/нет
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Проверьте «Закреплена» после успешного статуса. Сохраните «ID записи», чтобы позже снять закрепление тем же роботом с ACTION=unpin, не создавая повторный комментарий.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.