Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling users to interact programmatically with various resources such as CRM entities, timelines, deals, contacts, and more. Specifically, the Timeline - Get Comments operation retrieves comments associated with a particular CRM entity (Lead, Deal, Contact, or Company). This is useful for workflows that need to analyze, display, or process communication history related to CRM records.

Common scenarios include:

  • Fetching all comments on a deal to generate reports or trigger notifications.
  • Retrieving lead comments to enrich customer profiles or automate follow-ups.
  • Integrating timeline comments into external dashboards or analytics tools.

Practical example: A sales automation workflow could use this node to pull all comments from a deal's timeline and send a summary email to the sales manager whenever new comments are added.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key.
Entity Type The type of CRM entity whose timeline comments you want to retrieve. Options: Lead, Deal, Contact, Company.
Entity ID The unique identifier of the specific entity instance (e.g., a particular deal or contact).
Return All Whether to fetch all available comments or limit the number of results returned.
Max Pages to Load When not returning all, the maximum number of pages to load (each page contains up to 50 items).
Options Additional optional parameters:
- Filter JSON object specifying filter criteria to narrow down the comments retrieved.
- Order JSON object specifying sorting order of the results.
- Start Numeric offset for pagination start position.

Output

The node outputs an array of comment objects in the json field of each item. Each comment corresponds to a timeline entry linked to the specified entity. The exact structure depends on Bitrix24's API response but typically includes fields like comment text, author, timestamp, and related metadata.

If binary data were involved (not indicated here), it would be summarized accordingly, but this operation focuses on JSON comment data only.

Dependencies

  • Requires connection to a Bitrix24 account via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • Needs proper permissions in Bitrix24 to access timeline comments for the specified entity types.
  • No additional external dependencies beyond Bitrix24 API access.

Troubleshooting

  • Authentication errors: Ensure the selected authentication method is correctly configured with valid credentials or tokens.
  • Entity not found: Verify the Entity ID and Entity Type are correct and exist in the Bitrix24 account.
  • Pagination limits: If not all comments appear, check the "Return All" setting and "Max Pages to Load" to ensure enough data is fetched.
  • Filter/Order JSON syntax: Invalid JSON in filter or order options can cause API call failures; validate JSON format carefully.
  • API rate limits: Bitrix24 may throttle requests; implement error handling or retries if needed.

Links and References

Discussion