Таймлайн и дела в CRM: обзор методов

Таймлайн — это основное рабочее пространство в карточке элемента CRM. В нем фиксируется:

• системная информация о работе с элементом: смена стадии, оплата, создание элементов на основании текущего
• пользовательская информация: дела CRM (задачи, письма, звонки) и записи таймлайна (комментарии, сгенерированные по шаблону документы, лог-записи приложений)

Быстрый переход: все методы и события

Пользовательская документация: таймлайн в Битрикс24, универсальное дело в Битрикс24

Как выбрать разделКак выбрать раздел

В таймлайне два вида объектов: дела и записи таймлайна. У каждого своя группа методов.

Если вам нужно	Открывайте раздел
Создать звонок, встречу, письмо или другое дело в карточке элемента	Дела в CRM
Оставить в карточке текстовый комментарий с файлами	Комментарии таймлайна
Записать в таймлайн служебное сообщение приложения	Журнал лог-записей
Привязать существующую запись таймлайна к другому элементу CRM	Связи записей таймлайна
Добавить к делу или комментарию короткую заметку	Заметки к записям таймлайна
Показать в записи таймлайна собственный интерфейс приложения	Дополнительные контентные блоки
Закрепить запись вверху таймлайна	Действия с записями

ДелаДела

Дела в CRM делятся на входящие и запланированные:

• Входящие — дела, поступившие от клиента, например письмо или звонок. Для таких дел важно верно указать параметр DIRECTION = 1, чтобы сработал счетчик входящих дел CRM
• Запланированные — дела, которые создают сотрудники, например задачи или универсальные дела

Подробнее о делах и методах управления ими — в статье Дела в CRM: обзор методов.

Записи таймлайнаЗаписи таймлайна

Записи таймлайна делятся на два типа:

• Комментарии. Добавлять, удалять, изменять, получать комментарии можно через группу методов crm.timeline.comment.*
• Лог-записи. Добавлять, удалять, изменять, получать лог-записи можно через группу методов crm.timeline.logmessage.*

Управлять связями записей таймлайна с элементами CRM можно методами группы crm.timeline.bindings.*.

Как начать работуКак начать работу

1. Определите элемент CRM, в таймлайне которого будете работать: его тип entityTypeId смотрите в справочнике Тип объекта CRM, идентификатор entityId возвращают методы crm.item.list и crm.item.add.
2. Выберите объект: дело — методами crm.activity.*, комментарий — методами crm.timeline.comment.*, лог-запись — методами crm.timeline.logmessage.*.
3. Создайте объект и сохраните его идентификатор из ответа.
4. При необходимости дополните запись: заметкой crm.timeline.note.save, контентными блоками crm.timeline.layout.blocks.set, закреплением crm.timeline.item.pin.
5. Подпишитесь на события дел и комментариев, чтобы отслеживать изменения в реальном времени.

ВиджетыВиджеты

В дела и записи таймлайна можно встроить приложение. Благодаря встройке можно будет использовать приложение и не покидать карточку CRM. Для встраивания используют специальные места, в таймлайне их два:

• Кнопка над таймлайном карточки элемента CRM_XXX_DETAIL_ACTIVITY, CRM_DYNAMIC_XXX_DETAIL_ACTIVITY
• Пункт контекстного меню дела в карточке элемента CRM_XXX_ACTIVITY_TIMELINE_MENU

Дополнительные возможностиДополнительные возможности

Текстовые заметки можно добавлять к делам и комментариям таймлайна и удалять их. Используйте группу методов crm.timeline.note.*.

Контентные блоки можно добавлять к комментариям таймлайна и удалять их. Используйте группу методов crm.timeline.layout.blocks.*.

• Доступные контентные блоки

Обзор методов и событийОбзор методов и событий

Scope: crm

Кто может выполнять методы: в зависимости от метода

Дела CRMДела CRM

Методы дел раскрыты в разделе Дела в CRM.

Комментарии таймлайнаКомментарии таймлайна

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

Метод	Описание
crm.timeline.note.get	Получает информацию о заметке
crm.timeline.note.save	Сохраняет заметку
crm.timeline.note.delete	Удаляет заметку

Связи записей таймлайнаСвязи записей таймлайна

Метод	Описание
crm.timeline.bindings.bind	Добавляет связь записи таймлайна с элементом CRM
crm.timeline.bindings.list	Получает список связей записи таймлайна с элементами CRM
crm.timeline.bindings.unbind	Удаляет связь записи таймлайна с элементом CRM
crm.timeline.bindings.fields	Получает описание полей связи записи таймлайна с элементом CRM

Дополнительные контентные блокиДополнительные контентные блоки

Метод	Описание
crm.timeline.layout.blocks.set	Устанавливает набор дополнительных контентных блоков в запись таймлайна
crm.timeline.layout.blocks.get	Получает установленный приложением набор дополнительных контентных блоков для записи таймлайна
crm.timeline.layout.blocks.delete	Удаляет установленный приложением набор дополнительных контентных блоков для записи таймлайна

Журнал лог-записей приложенияЖурнал лог-записей приложения

Метод	Описание
crm.timeline.logmessage.add	Добавляет новую лог-запись в таймлайн
crm.timeline.logmessage.get	Получает информацию о лог-записи
crm.timeline.logmessage.list	Получает список всех лог-записей для определенного элемента
crm.timeline.logmessage.delete	Удаляет лог-запись
crm.timeline.icon.*	Управляют иконками записей
crm.timeline.logo.*	Управляют логотипами записей

Действия с записями в таймлайнеДействия с записями в таймлайне

Метод	Описание
crm.timeline.item.pin	Закрепляет запись в таймлайне
crm.timeline.item.unpin	Открепляет запись в таймлайне