При нажатии на кнопку «позвонить» или «перезвонить» BackgroundCallCard::makeCallButtonClick
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Scope:
placement— регистрация точки встраивания,telephony— регистрация звонка, поднимающего карточкуКто может подписаться: любой пользователь
Событие BackgroundCallCard::makeCallButtonClick возникает при запуске вызова из карточки звонка.
Событие работает в контексте приложения, открытого в точке встраивания PAGE_BACKGROUND_WORKER. Это событие js-интерфейса, а не событие REST: подписаться на него запросом к /rest/ нельзя.
Что получает обработчик
В обработчик события данные не передаются.
Параметры подписки
Обработчик регистрируют из виджета методом BX24.placement.bindEvent.
Обязательные параметры отмечены *
|
Название |
Описание |
|
event* |
Имя события интерфейса. Для данного события — |
|
callback* |
Функция, которую Битрикс24 вызывает при наступлении события. Аргументы в обработчик не передаются |
Примеры кода
Как использовать примеры в документации
BX24.ready(function () {
BX24.init(function () {
BX24.placement.bindEvent('BackgroundCallCard::makeCallButtonClick', function () {
// код обработчика
});
});
});
// $b24 — инициализированный экземпляр SDK, см. руководство по началу работы
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
await $b24.placement.bindEvent('BackgroundCallCard::makeCallButtonClick', () => {
// код обработчика
})
<!-- Загрузка 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::makeCallButtonClick', () => {
// код обработчика
})
})
</script>
Ошибки
Проверьте условия.
- Виджет открыт в точке встраивания
PAGE_BACKGROUND_WORKER. В других точках встраивания событияBackgroundCallCard::*не зарегистрированы, и подписка молча не сработает - Имя события передано без опечаток и с учетом регистра. Список событий, доступных в текущей точке встраивания, возвращает BX24.placement.getInterface
- Звонок поднят приложением методом telephony.externalCall.register. Для звонков самого Битрикс24 события
BackgroundCallCard::*не эмитятся вовсе