Позвонить по внутренней связи BX24.im.callTo

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

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

Приложение работает во фрейме

Приложение запускается в своем фрейме, на другом домене. Среды выполнения Битрикс24 там нет — из приложения не вызываются ни Messenger.*, ни BX.Runtime.loadExtension.

Единственный канал наружу — мост к родительскому окну: методы BX24.im.* или их аналоги $b24.parent.imCallTo, $b24.parent.imPhoneTo, $b24.parent.imOpenMessenger и $b24.parent.imOpenHistory в библиотеке b24jssdk.

При вызове этих методов в консоли Битрикс24 печатается сообщение об устаревании с рекомендацией перейти на Messenger.startVideoCall, Messenger.startPhoneCall или Messenger.openChat. Не обращайте на него внимания: это методы верхнего окна, доступные только коду на самой странице Битрикс24, и из приложения они недостижимы.

Расширение im.public.iframe, которое называет сообщение, предназначено для фрейма на домене Битрикс24, а не для фрейма приложения. Про этот случай — Передача контекста боту при открытии чата.

Метод BX24.im.callTo отправляет команду на звонок пользователю Битрикс24 по внутренней связи.

void BX24.im.callTo(Integer userId[, Boolean video])

Параметры

Обязательные параметры отмечены *

Название
тип

Описание

userId*
integer

Идентификатор пользователя Битрикс24, которому выполняется звонок

video
boolean

Тип звонка: true — видеозвонок, false — аудиозвонок

Пример кода

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

BX24.init(function () {
    BX24.im.callTo(1, true);
});

Обработка ответа

Метод не возвращает данные (void).

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