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