Open Channels Connectors: Overview of Methods
If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.
Open Channels Connectors are a tool for integrating external messengers and social networks with Bitrix24. Connectors allow you to:
- Respond to customer messages from various channels in a unified interface.
- Connect chatbots to automate communication with customers.
- Analyze dialogue statistics to assess the effectiveness of communications.
Quick navigation: all methods
User documentation: Connecting Contact Center Channels
Connection of Connectors with Other Objects
Open Channels. They collect messages from connectors, manage queues, and distribute messages among employees. Working with open channels should be done using the group of methods imopenlines.*.
CRM. Based on messages, leads and deals can be automatically created using the methods crm.lead.add and crm.deal.add.
User. The user ID can be obtained using the methods user.get and user.search.
Chat. The correspondence with users is managed by the methods im.chat.* and im.message.*.
Chatbots. Setting up automated responses and chatbots is done using the methods imbot.*.
How to Connect a Connector
- Register the connector using the method imconnector.register.
- Activate it using the method imconnector.activate.
- Set the connector data using the method imconnector.connector.data.set.
- Check the connector status using the method imconnector.status and ensure it is ready for operation.
How to Work with Messages
You can send a message using the method imconnector.send.messages.
Sent messages can be modified using the method imconnector.update.messages. This method changes the parameters of the user, message, and chat.
Messages in open channels can be deleted using the method imconnector.delete.messages.
How to Add a Widget to the Contact Center
To add a connector widget to the Contact Center, use the widget code CONTACT_CENTER. This code must be specified in the PLACEMENT parameter of the method placement.bind.
Overview of Methods and Events
Scope:
imopenlines
Who can execute the method: any user
The methods imconnector.* in the current version do not support operation via webhooks.
Connector
|
Method |
Description |
|
Register a connector |
|
|
Activate a connector |
|
|
Get the connector status |
|
|
Change connector settings |
|
|
Get a list of connectors |
|
|
Unregister a connector |
|
Event |
Triggered |
|
When an open line is deleted |
|
|
When an open line is disabled |
Chats and Messages
|
Method |
Description |
|
Send messages to Bitrix24 |
|
|
Modify sent messages |
|
|
Delete sent messages |
|
|
Update the status to |
|
|
Set a new chat name |
|
Event |
Triggered |
|
When a dialog is created |
|
|
When a dialog is closed |
|
|
When a new message is added |
|
|
When messages are deleted |
|
|
When messages are updated |