Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

The Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling automation workflows to interact with various Bitrix24 resources. Specifically, the "Open Lines" resource with the "Finish Session" operation allows users to programmatically close or finish an open communication session within Bitrix24's Open Lines feature. This is useful in scenarios such as automating customer support chat session closures after issue resolution or when a conversation needs to be programmatically ended based on workflow logic.

Practical examples include:

  • Automatically finishing a live chat session once a support ticket linked to it is resolved.
  • Closing sessions that have been inactive for a certain period.
  • Integrating with other systems to mark conversations as finished when external conditions are met.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24:
- OAuth2 (recommended for production)
- Webhook (simpler but less secure)
- API Key authentication
Options Additional optional parameters:
- Filter: JSON object to filter results
- Sort: JSON object to specify sort order

Note: The "Options" property is shown only when the resource is "openLines". It allows specifying filtering and sorting criteria in JSON format, which can refine the operation behavior.

Output

The node outputs an array of items where each item contains a json field representing the response from Bitrix24 after attempting to finish the session. If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with keys:

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

No binary data output is indicated by the source code.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • The node depends on internal helper functions to make API calls to Bitrix24.
  • Proper credentials must be configured in n8n for the chosen authentication method.
  • No additional external dependencies beyond Bitrix24 API access.

Troubleshooting

  • Common issues:
    • Incorrect or expired authentication credentials leading to authorization errors.
    • Malformed JSON in the "Filter" or "Sort" options causing API call failures.
    • Network connectivity problems preventing API requests.
  • Error messages:
    • Errors thrown during execution will include the message from Bitrix24 API or internal exceptions.
    • When "Continue On Fail" is enabled, errors are returned in the output JSON for easier debugging.
  • Resolutions:
    • Verify and refresh authentication credentials.
    • Validate JSON syntax in filter and sort fields.
    • Check network connectivity and Bitrix24 service status.

Links and References

Discussion