Позвонить на телефонный номер BX24.im.phoneTo
Выберите инструмент для разработки с 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.phoneTo(string phone): void;
Метод BX24.im.phoneTo передает телефонный номер в Мессенджер Битрикс24 и запускает исходящий звонок.
Метод работает после BX24.init. Для звонка в Битрикс24 должна быть доступна телефония.
Параметры метода
Обязательные параметры отмечены *
|
Название |
Описание |
|
phone* |
Телефонный номер для звонка. Передавайте номер в международном формате, например |
Пример кода
Как использовать примеры в документации
BX24.init(function () {
BX24.im.phoneTo('+74951234567');
});
Обработка ответа
Метод передает команду на звонок и ничего не возвращает.
Обработка ошибок
Метод не передает приложению коды ошибок. Если звонки недоступны по тарифу, Битрикс24 открывает окно с информацией об ограничении.