Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically allowing users to retrieve a comment from the Timeline resource. It supports multiple authentication methods including OAuth2, webhook URL, and API key. The "Get Comment" operation fetches detailed information about a specific comment identified by its ID.

Common scenarios where this node is beneficial include:

  • Automating retrieval of comments related to CRM activities or business processes.
  • Integrating Bitrix24 timeline comments into workflows for further processing or notifications.
  • Auditing or reporting on user interactions recorded as comments in Bitrix24.

Example use case: Automatically fetching a comment by its ID when triggered by an event, then using the comment data to update another system or send alerts.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options: OAuth2 (recommended), Webhook, API Key.
Comment ID The unique identifier of the comment to retrieve.
Options Additional optional parameters:
- Filter JSON object specifying filter criteria to narrow down results (if applicable).
- Order JSON object defining sort order of results (if applicable).
- Start Number indicating the start position for pagination (default is 0).

Output

The node outputs a JSON object representing the retrieved comment's details from the Bitrix24 Timeline. This typically includes all available fields related to the comment such as content, author, timestamps, and any metadata provided by Bitrix24.

If the node encounters an error during execution, it can output an error object containing:

  • error: The error message string.
  • resource: The resource name ("timeline").
  • timestamp: ISO timestamp of when the error occurred.

No binary data output is indicated for this operation.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods:
    • OAuth2 credentials (recommended for production).
    • Webhook URL (simpler but less secure).
    • API key authentication.
  • The node depends on Bitrix24 API endpoints to fetch timeline comment data.
  • Proper configuration of credentials in n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or missing Comment ID will cause the API call to fail.
    • Incorrect or expired authentication credentials will result in authorization errors.
    • Network connectivity problems may prevent reaching Bitrix24 API.
    • Improperly formatted JSON in the "Filter" or "Order" options can cause parsing errors.
  • Error messages:

    • Errors returned from Bitrix24 API are passed through; typical messages include "Not Found" if the comment ID does not exist.
    • Authentication failures will indicate invalid credentials or access denied.
    • JSON parsing errors if filter/order inputs are malformed.
  • Resolutions:

    • Verify the Comment ID is correct and exists in Bitrix24.
    • Ensure authentication credentials are valid and have required permissions.
    • Validate JSON syntax in optional filter and order fields.
    • Check network connectivity and API endpoint accessibility.

Links and References

Discussion