CALL_CARD: Overview of Methods and Events

The CALL_CARD placement is used by applications that are embedded in the call card within the CRM. Through the JavaScript interface of the placement, the application can access data about the current call, manage the auto-closing of the card, and respond to changes in the client or the call state.

Quick navigation: all methods and events

User documentation: Call Card

Getting Started with CALL_CARDGetting Started with CALL_CARD

1. Open the application in the CALL_CARD placement.
2. Retrieve the list of available commands and events via BX24.placement.getInterface.
3. Invoke placement commands through BX24.placement.call.
4. Subscribe to call card events using BX24.placement.bindEvent.

How the Placement API Call WorksHow the Placement API Call Works

In CALL_CARD, the commands and events of the placement are not standalone REST methods. The application interacts with them through a common JavaScript embedding interface.

To execute a placement command, pass its name to BX24.placement.call. For CALL_CARD, these commands are getStatus, disableAutoClose, and enableAutoClose. The getStatus command returns data about the current call, while the auto-close management commands return an empty array upon successful invocation.

To respond to changes in the card without making repeated requests, subscribe to events via BX24.placement.bindEvent. In CALL_CARD, the available events are CallCard::EntityChanged, CallCard::CallStateChanged, and CallCard::BeforeClose. The event handler may receive client data, call state with additional parameters, or a call without data if the card is closing.

Overview of Methods and EventsOverview of Methods and Events

Scope: telephony

Who can execute the methods: any user