# CallCard::EntityChanged

URL: https://chugunov.pro/api-bitrix24/widgets/ui-interaction/call-card/call-card-entity-changed/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Событие смены клиента
Scope: `placement — регистрация точки встраивания, telephony — доступ к точке встраивания карточки звонка`
Кто может подписаться: любой пользователь

## Описание

Событие `CallCard::EntityChanged` возникает, когда меняется клиент, привязанный к звонку.

Событие приходит в четырех случаях:

- карточка звонка открылась и подтянула данные CRM
- карточка обновила данные клиента
- из карточки создали или привязали элемент CRM — лид, контакт или компанию
- в режиме обзвона оператор перешел к следующему клиенту

Событие работает в контексте приложения, открытого в точке встраивания `CALL_CARD`. Это событие js-интерфейса, а не событие REST: подписаться на него запросом к `/rest/` нельзя.

## Параметры

- `event` `string` — обязательный. Имя события интерфейса.
  Для данного события — `CallCard::EntityChanged`
- `callback` `callable` — обязательный. Функция, которую Битрикс24 вызывает при наступлении события. Аргументы обработчика описаны выше

## Примеры запроса

### BX24.js

```js
BX24.ready(function () {
    BX24.init(function () {
        BX24.placement.bindEvent('CallCard::EntityChanged', function (eventData) {
            console.log(eventData);
        });
    });
});
```

### JS (TS)

```ts
// $b24 — инициализированный экземпляр SDK, см. руководство по началу работы
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

await $b24.placement.bindEvent('CallCard::EntityChanged', (eventData: { PHONE_NUMBER: string; CRM_ENTITY_TYPE: string; CRM_ENTITY_ID: number }) => {
  console.log(eventData.CRM_ENTITY_ID)
})
```

### JS (UMD)

```html
<!-- Загрузка SDK в UMD-сборке, глобальный объект B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', async () => {
    const $b24 = await B24Js.initializeB24Frame()

    await $b24.placement.bindEvent('CallCard::EntityChanged', (eventData) => {
      console.log(eventData)
    })
  })
</script>
```

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/widgets/ui-interaction/call-card/call-card-entity-changed.html