Почему установки VanOmni в Битрикс24 недостаточно и как завершить привязку портала
Приложение уже отображается среди установленных в Битрикс24, но портал ещё не появился в кабинете VanOmni или каналы не видны. Это не всегда означает ошибку установки. Установка приложения, вход в нужный кабинет VanOmni и подключение каналов являются отдельными этапами, каждый из которых нужно проверить последовательно.
Что подтверждает установка приложения
Во время установки Bitrix24 передаёт приложению сведения о портале и разрешённый набор прав. После успешного завершения VanOmni может распознать установку и подготовить элементы интеграции. Однако эти технические данные ещё не определяют, к какому кабинету VanOmni должен относиться портал.
Официальная документация Bitrix24 описывает событие ONAPPINSTALL как событие после успешной установки приложения. Для приложений с мастером настройки Bitrix24 также отдельно отмечает этап завершения установки. Источники: https://apidocs.bitrix24.com/api-reference/common/events/on-app-install.html и https://apidocs.bitrix24.com/settings/app-installation/installation-finish.html
Зачем входить в VanOmni из самого портала
Откройте VanOmni в том портале Bitrix24, который хотите подключить, и войдите с данными нужного кабинета VanOmni. После подтверждения связи домен должен появиться в разделе «Bitrix24» этого кабинета. Такой порядок не позволяет случайно привязать установку только по введённому вручную адресу.
Перед подтверждением проверьте название компании и ID кабинета VanOmni. Если вы обслуживаете несколько организаций, не используйте открытое окно другого клиента. Сначала вернитесь в правильный кабинет, затем повторно откройте приложение внутри нужного портала.
Почему каналы не появляются автоматически
Привязка Bitrix24 добавляет CRM-портал к кабинету, но не подключает Telegram, WhatsApp или другой мессенджер вместо пользователя. Каждый канал имеет собственную авторизацию и настройки: токен бота, QR-код, учётную запись или параметры Meta в зависимости от выбранного типа.
После появления портала откройте его настройки в VanOmni и добавьте нужный канал. Проведите тест на собственном контакте: отправьте входящее сообщение, ответьте из рабочего окна и убедитесь, что оба направления относятся к одному кабинету и правильному каналу.
Как проверить портал без повторной установки
В разделе кабинета «Bitrix24» укажите домен в формате company.bitrix24.ru и нажмите «Проверить установку». Если приложение установлено, но связь ещё не подтверждена, откройте VanOmni внутри этого портала, войдите с теми же данными и завершите привязку.
Не переустанавливайте приложение после первой неудачной проверки. Сначала убедитесь, что вошли под администратором нужного портала, используете правильный кабинет VanOmni и не открыли старую вкладку другого клиента. Инструкции по установке доступны на странице https://vanomni.vantech.am/bitrix-market
Когда нужна помощь администратора
По умолчанию приложения из Маркета Bitrix24 устанавливает администратор, хотя настройки портала могут разрешать установку другим сотрудникам. Локальное приложение также создаётся в разделе ресурсов разработчика с правами, достаточными для требуемых функций. Официальная справка: https://helpdesk.bitrix24.com/open/25783183/
Если проверка не проходит, подготовьте для поддержки домен портала, ID кабинета VanOmni, время попытки и снимок экрана без токенов и клиентских сообщений. Не передавайте пароль от кабинета, секрет приложения или коды подтверждения в обычной переписке.
Проверочный список
- Приложение установлено именно в нужном портале Bitrix24.
- Установка завершена пользователем с необходимыми правами.
- VanOmni открыт из интерфейса подключаемого портала.
- Выполнен вход в правильный кабинет VanOmni.
- Домен появился в списке подключённых порталов кабинета.
- Нужный мессенджер подключён отдельно и показывает готовность.
- Тестовые сообщения прошли в обоих направлениях без дублей.
Следующий шаг
Посмотрите инструкции VanOmni, интеграцию с Битрикс24 и актуальные тарифы.
Обсудить подключение