- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
Закрепить запись в таймлайне
При превышении лимита операция завершится ошибкой.
Нужны права на работу с CRM и таймлайном.
- Вы передаёте ID записи таймлайна, ownerTypeId и ownerId элемента CRM;
- Выполняется запрос закрепления;
- Возвращаются признак успеха и служебное сообщение.
Типичная цепочка:
- Получение ID записи из списка комментариев или лог-записей по фильтру;
- Закрепление;
- Уведомление ответственного при "Успешное закрепление" = Y.
| Название поля | Описание и примеры использования |
|---|---|
| ID записи таймлайна |
Числовой идентификатор записи в таймлайне. Его можно получить из активити со списком комментариев или лог-записей по сущности. Пример: {=Variable:TIMELINE_ID} |
| Тип объекта CRM (ownerTypeId) |
Числовой код типа объекта CRM, к которому привязана запись (например 2 для сделки, 1 для лида). Подставьте значение, соответствующее карточке сущности. Пример: {=Variable:ENTITY_TYPE_ID} |
| ID элемента CRM (ownerId) |
Идентификатор элемента CRM, в карточке которого отображается таймлайн. Пример: {=Document:ID} |
ID записи, тип объекта и элемент должны соответствовать существующей записи таймлайна и карточке CRM.
| Описание примера | Решение |
|---|---|
| Закрепить комментарий после модерации |
ID = {=Variable:COMMENT_TL_ID}, "Тип объекта CRM" = 2, "ID элемента CRM" = {=Document:ID} для сделки. |
| Закрепить запись в таймлайне лида |
"Тип объекта CRM" = 1, "ID элемента CRM" = {=Document:ID}, ID = {=Variable:ITEM_ID}. |
| Цепочка после поиска комментария | ID из первого результата списка по фильтру, ID элемента CRM и Тип объекта CRM из полей документа сделки. |
| Закрепление итогового лог-сообщения | ID лог-записи из переменной {=Variable:LOG_ID}, "Тип объекта CRM" и "ID элемента CRM" совпадают с карточкой контакта. |
| Условное закрепление по важности | Условие: Variable:HIGH = Y, затем параметры из полей документа и переменной с ID записи. |
| Отложенное закрепление после паузы | После задержки процесса подставьте сохранённый ID записи из переменной {=Variable:PIN_QUEUE_ID}. |
| Обработка ошибки лимита | Если "Успех закрепления" = N, проверьте "Сообщение об ошибках" и при необходимости сначала открепите другую запись активити «Открепить запись в таймлайне». |
| Смарт-процесс | Тип объекта CRM = entityTypeId из настроек типа, ID элемента CRM = ID элемента смарт-процесса, ID записи из списка по entityTypeId. |
| Компания и контакт | Для компании Тип объекта CRM = 4, ID элемента CRM = {=Document:ID} в карточке компании; ID записи из списка по entity. |
| Логирование в переменную процесса | После шага сохраните значение "Успешное закрепление" и фрагмент "Сообщение об ошибках" в пользовательские поля сделки для аудита. |
- Успешное закрепление — Y при успешном закреплении, N при ошибке валидации или ответа API;
- Сообщение об ошибке — служебная строка с результатом или описанием ошибки.
Важно о возвращаемых параметрах: при N не считайте запись закреплённой, проверьте карточку в интерфейсе портала и лимит избранного.