Overview of Events When Working with the WebRTC Client Call Card
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.
The BackgroundCallCard::* events allow the application to respond to user actions in the call card and changes in the interface state without additional polling.
Events only work within the application in the PAGE_BACKGROUND_WORKER placement.
Quick navigation: all events
How to Subscribe to Events
- Subscribe to the desired event using BX24.placement.bindEvent.
- Handle the event data in the application's callback.
- After the BackgroundCallCard::initialized event, initiate the call card management logic.
How to Choose an Event
|
Scenario |
What to Use |
What Comes in the Callback |
|
The application has access to the created call card |
Initial call data and CRM binding |
|
|
The operator clicks call control buttons |
BackgroundCallCard::muteButtonClick, BackgroundCallCard::holdButtonClick, BackgroundCallCard::hangupButtonClick, BackgroundCallCard::answerButtonClick |
Data for the specific action in the interface |
|
The operator is working with call transfer |
BackgroundCallCard::transferButtonClick, BackgroundCallCard::cancelTransferButtonClick, BackgroundCallCard::completeTransferButtonClick |
Data for the transfer scenario |
|
In dialing mode, the current client changes |
Client number and current CRM binding |
|
|
Additional actions are needed from the call card interface, such as saving a comment, rating call quality, or entering a number on the keypad |
BackgroundCallCard::addCommentButtonClick, BackgroundCallCard::dialpadButtonClick, BackgroundCallCard::qualityMeterClick, BackgroundCallCard::notifyAdminButtonClick, BackgroundCallCard::nextButtonClick, BackgroundCallCard::skipButtonClick, BackgroundCallCard::makeCallButtonClick, BackgroundCallCard::closeButtonClick |
Value selected by the user or action parameters |
Overview of Events
Scope:
telephonyWho can subscribe: any user
|
Event |
Triggered |
|
After the call card is created |
|
|
When saving a comment in the call card |
|
|
When the mute button is pressed |
|
|
When the hold button is pressed |
|
|
When the close button on the call card is pressed |
|
|
When selecting the operator to whom the current operator wants to transfer the call |
|
|
When the "return to call" button is pressed |
|
|
When the "redirect" button is pressed |
|
|
When the "end" button is pressed |
|
|
When the "next" button is pressed |
|
|
When the "skip" button is pressed |
|
|
When the "answer" button is pressed |
|
|
In the dialing card when the current dialed entity changes |
|
|
When the "call" or "callback" button is pressed |
|
|
When rating call quality |
|
|
When one of the numeric buttons on the phone is pressed |
|
|
When the "notify administrator" button is pressed |