Открыть окно мессенджера BX24.im.openMessenger
Выберите инструмент для разработки с 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.openMessenger отправляет команду на открытие окна мессенджера.
void BX24.im.openMessenger([String dialogId])
Параметры
|
Название |
Описание |
|
dialogId |
Идентификатор диалога. Поддерживаются форматы: |
Пример кода
Как использовать примеры в документации
BX24.init(function () {
BX24.im.openMessenger('chat123');
});
Обработка ответа
Метод не возвращает данные (void).