Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically enabling the creation of new chat entities within Bitrix24. It supports creating different types of chats such as standard group chats, open line chats (for customer support), and call-related chats. This node is useful for automating communication workflows inside Bitrix24, for example:

  • Automatically creating a team chat when a new project or deal is initiated.
  • Setting up an open line chat to handle incoming customer inquiries.
  • Creating call-related chats to organize communication around calls.

By automating chat creation, teams can streamline collaboration and ensure relevant participants are included from the start.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key authentication.
Chat Title The title or name of the chat to be created.
Chat Type The type of chat to create. Options: Chat (standard group chat), Open Line (customer support channel), Call (call-related chat).
Users Comma-separated list of user IDs to include in the chat.

Output

The node outputs JSON data representing the result of the chat creation operation. This typically includes details about the newly created chat such as its ID, title, type, and possibly metadata returned by the Bitrix24 API.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message, resource name, and timestamp.

The node does not output binary data.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods:
    • OAuth2 authentication (recommended for production use).
    • Webhook URL authentication (simpler but less secure).
    • API key authentication.
  • Proper credentials must be configured in n8n for the chosen authentication method.
  • Access to Bitrix24 API endpoints for chat management.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials leading to authorization errors.
    • Incorrect user IDs format in the "Users" property causing API request failures.
    • Insufficient permissions in Bitrix24 account to create chats.
    • Network connectivity issues preventing API calls.

  • Error messages:

    • Errors thrown by the Bitrix24 API will be surfaced in the node's output if "Continue On Fail" is enabled.
    • Typical error messages may include authentication failures, invalid parameters, or permission denials.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Ensure user IDs are correctly formatted and correspond to existing users.
    • Confirm that the authenticated user has rights to create chats.
    • Check network connectivity and firewall settings.

Links and References

Discussion