событие
scope: placement — регистрация точки встраивания, telephony — регистрация звонка, поднимающего карточку
BackgroundCallCard::entityChanged
При загрузке или смене объекта CRM
Описание
Событие BackgroundCallCard::entityChanged возникает, когда карточка загружает или меняет связанный со звонком объект CRM.
Событие приходит в трех случаях:
- карточка звонка открылась и подтянула данные клиента из CRM. В этом случае событие может прийти раньше, чем BackgroundCallCard::initialized
- клиента опознали или звонок перепривязали к другому объекту CRM
- в режиме обзвона оператор перешел к следующему клиенту
Событие работает в контексте приложения, открытого в точке встраивания PAGE_BACKGROUND_WORKER. Это событие js-интерфейса, а не событие REST: подписаться на него запросом к /rest/ нельзя.
Параметры
event
string
обязательный
Имя события интерфейса.
Для данного события — BackgroundCallCard::entityChanged
callback
callable
обязательный
Функция, которую Битрикс24 вызывает при наступлении события. Аргументы обработчика описаны выше
Примеры запроса
BX24.ready(function () {
BX24.init(function () {
BX24.placement.bindEvent('BackgroundCallCard::entityChanged', function (eventData) {
console.log(eventData);
});
});
});// $b24 — инициализированный экземпляр SDK, см. руководство по началу работы
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
await $b24.placement.bindEvent('BackgroundCallCard::entityChanged', (eventData: { PHONE_NUMBER: string; CRM_ENTITY_TYPE: string; CRM_ENTITY_ID: number }) => {
console.log(eventData.CRM_ENTITY_ID)
})<!-- Загрузка 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('BackgroundCallCard::entityChanged', (eventData) => {
console.log(eventData)
})
})
</script>
