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 - Send Message operation allows sending messages within an ongoing chat session in Bitrix24's Open Lines communication channels.

This operation is useful for automating customer support or sales conversations by programmatically sending messages to a specific chat session. For example, you can use it to send automated replies, notifications, or follow-ups to customers interacting via Bitrix24 Open Lines.

Practical scenarios include:

  • Automatically sending a welcome message when a new chat session starts.
  • Sending updates or alerts to a customer during a support interaction.
  • Integrating external systems to push messages into Bitrix24 chats based on events.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook URL, or API Key.
Session ID The unique identifier of the chat session where the message will be sent.
Message The content text of the message to send in the chat.
Chat ID The identifier of the specific chat within the session to which the message belongs.
Options Additional optional parameters:
- Filter: JSON object to filter results (usage context dependent).
- Sort: JSON object defining sort order (usage context dependent).

Output

The node outputs an array of items corresponding to the result of the API call to send the message. Each item contains a json property with the response data from Bitrix24, typically including confirmation details about the sent message.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

  • Requires authentication credentials configured in n8n:
    • OAuth2 token credential (recommended for production).
    • Or a Bitrix24 webhook URL.
    • Or an API key credential.
  • Access to Bitrix24 API endpoints for Open Lines messaging.
  • Proper permissions in Bitrix24 to send messages in Open Lines sessions.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials causing authorization failures.
    • Incorrect Session ID or Chat ID leading to "not found" errors.
    • Insufficient permissions to send messages in the specified chat.
    • Malformed message content or exceeding allowed length limits.
  • Error messages:

    • Authorization errors: Check that the selected authentication method is correctly configured and valid.
    • Resource not found: Verify that the Session ID and Chat ID are correct and exist in Bitrix24.
    • API rate limits or connectivity issues: Ensure network access and consider retry logic.
  • To resolve errors, verify credentials, confirm IDs, and check Bitrix24 user permissions.

Links and References


This summary is based on static analysis of the provided source code and input properties definitions. It reflects the structure and intended usage of the Bitrix24 node's Open Lines Send Message operation without runtime execution.

Discussion