Снять блокировку автозакрытия enableAutoClose

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: placement — регистрация точки встраивания, telephony — доступ к точке встраивания карточки звонка

Кто может выполнять команду: любой пользователь

Команда enableAutoClose возвращает автоматическое закрытие карточки звонка, отключенное командой disableAutoClose.

Если разговор к этому моменту уже завершен и отсчет до закрытия шел, карточка закроется сразу. Пока звонок активен, команда только снимает запрет: карточка закроется штатно после разговора. Если в карточке открыта форма комментария, Битрикс24 сначала сохранит комментарий.

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

Как вызвать команду

Команду вызывают из виджета методом BX24.placement.call. Третий аргумент — функция обратного вызова, в нее приходит результат команды.

BX24.placement.call('enableAutoClose', {}, function (result) {
    console.log(result);
});

Параметры команды

Команда не принимает параметров. Вторым аргументом передайте пустой объект {}.

Примеры кода

Как использовать примеры в документации

BX24.ready(function () {
    BX24.init(function () {
        BX24.placement.call('enableAutoClose', {}, function (result) {
            console.log(result);
        });
    });
});

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

declare const $b24: B24Frame

await $b24.placement.call('enableAutoClose')

<!-- Загрузка 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()

    const result = await $b24.placement.call('enableAutoClose')

    console.log(result)
  })
</script>

Результат команды

[]

Возвращаемые данные

Пустой массив при успешном вызове.

Ошибки

Собственных кодов ошибок у команды enableAutoClose нет: она либо выполняется, либо не вызывается вовсе.

  • Если виджет открыт не в точке встраивания CALL_CARD, интерфейс точки встраивания игнорирует незнакомую команду и функция обратного вызова не срабатывает
  • Имя команды сверяйте с учетом регистра: список команд, доступных в текущей точке встраивания, возвращает BX24.placement.getInterface

Продолжите изучение

Предыдущая
Заблокировать автозакрытие
Следующая
Событие смены клиента