Timeline and Activities in CRM: Overview of Methods
The timeline is the primary workspace in the CRM entity detail form. It records:
- system information about working with the entity: stage changes, payments, creating entities based on the current one
- user information: CRM activities (tasks, e-mails, calls) and timeline entries (comments, documents generated from templates, application log entries)
Quick navigation: all methods and events
User documentation: timeline in Bitrix24, universal activity in Bitrix24
Activities
Activities in CRM are divided into incoming and scheduled:
- Incoming — activities received from the client, such as an e-mail or a call. For these activities, it is important to correctly specify the parameter
DIRECTION=1so that the incoming CRM activities counter works - Scheduled — activities created by employees, such as tasks or universal activities
More details about activities and methods for managing them can be found in the article Activities in CRM: Overview of Methods.
Timeline
Timeline entries are divided into two types:
- Comments. You can add, delete, modify, and retrieve comments through the group of methods crm.timeline.comment.*
- Log entries. You can add, delete, modify, and retrieve log entries through the group of methods crm.timeline.logmessage.*
You can manage the relationships of timeline entries with CRM entities using the methods from the group crm.timeline.bindings.*
Widgets
You can embed an application into activities and timeline entries. Thanks to the embedding, you can use the application without leaving the CRM entity detail form. For embedding, there are special places in the timeline:
- Button above the timeline of the entity detail form
CRM_XXX_DETAIL_ACTIVITY,CRM_DYNAMIC_XXX_DETAIL_ACTIVITY - Context menu item of the activity in the entity detail form
CRM_XXX_ACTIVITY_TIMELINE_MENU
Typical use-cases and scenarios
Additional Features
Text notes can be added to activities and timeline comments and deleted. Use the group of methods crm.timeline.note.*.
Content blocks can be added to timeline comments and deleted. Use the group of methods crm.timeline.layout.blocks.*.
Overview of Methods and Events
Scope:
crmWho can perform methods: depending on the method
Timeline Comments
|
Method |
Description |
|
Adds a new comment to the timeline |
|
|
Updates a comment |
|
|
Retrieves information about a comment |
|
|
Retrieves a list of all comments for the CRM entity |
|
|
Deletes a comment |
|
|
Retrieves a list of timeline comment fields |
|
Event |
Triggered |
|
When a new comment is created in the timeline |
|
|
When a comment is updated in the timeline |
|
|
When a comment is deleted in the timeline |
Notes for Timeline Entries
|
Method |
Description |
|
Retrieves information about a note |
|
|
Saves a note |
|
|
Deletes a note |
Managing Timeline Entry Relationships
|
Method |
Description |
|
Adds a relationship between a timeline entry and a CRM entity |
|
|
Retrieves a list of relationships for a timeline entry |
|
|
Removes the relationship between a timeline entry and a CRM entity |
|
|
Retrieves the fields of the relationship between CRM entities and timeline entries |
Additional Content Blocks
|
Method |
Description |
|
Sets a set of additional content blocks in the timeline entry |
|
|
Retrieves the set of additional content blocks installed by the application for the timeline entry |
|
|
Deletes the set of additional content blocks installed by the application for the timeline entry |
Application Log Entry Journal
|
Method |
Description |
|
Adds a new log entry to the timeline |
|
|
Retrieves information about a log entry |
|
|
Retrieves a list of all log entries for a specific entity |
|
|
Deletes a log entry |
|
|
Manages entry icons |
|
|
Manages entry logos |
Actions with Timeline Entries
|
Method |
Description |
|
Pins an entry in the timeline |
|
|
Unpins an entry in the timeline |