Подключение Битрикс24

Пошаговая инструкция по подключению Битрикс24 к AISAR: установка приложения, привязка каналов к открытым линиям, сопоставление пользователей и настройка телефонии с click-to-call.

Что даёт интеграция

Интеграция связывает AISAR с вашим порталом Битрикс24: диалоги из каналов AISAR (WhatsApp, WhatsApp Business API, Telegram, Telegram-бот, Instagram Business, Live Chat, SIP-телефония) поступают в открытые линии Битрикс24, контакты и сделки синхронизируются в обе стороны, а в карточках CRM появляется вкладка AISAR с перепиской. Отдельно настраивается телефония: клик по номеру в CRM запускает звонок через AISAR.

Что понадобится

Портал Битрикс24 с правами администратора — устанавливать приложения из Битрикс24.Маркет может только администратор портала.
Аккаунт AISAR с ролью admin в компании, к которой вы подключаете портал (та же роль нужна, чтобы подтвердить привязку на стороне AISAR).
Хотя бы один подключённый канал AISAR (WhatsApp, Telegram и т. д.), который вы собираетесь привязать к открытой линии.

Шаг 1. Установка приложения

Приложение AISAR опубликовано в Битрикс24.Маркет — это основной способ установки.

В своём портале Битрикс24 откройте раздел Маркет и найдите приложение AISAR (или перейдите по прямой ссылке на страницу приложения, если она у вас есть).
Нажмите Установить и подтвердите запрашиваемые права доступа.
После установки Битрикс24 покажет экран «Почти готово!» с кнопкой «Завершить настройку в AISAR» — нажмите её.
Откроется новая вкладка my.aisar.app. Войдите в свой аккаунт AISAR (или зарегистрируйте компанию, если у вас его ещё нет) и выберите компанию, к которой нужно привязать этот портал.
Подтвердите привязку. Вкладка Битрикс24 сама покажет статус «Подключено» и закроется — привязка завершена.

Карточка приложения AISAR в Маркете портала Битрикс24 с кнопкой «Установить»

Окно установки приложения версии 2 со списком запрашиваемых прав: CRM, Телефония, Открытые линии, Контакт-центр и другие

Экран «Почти готово!» внутри Битрикс24 с кнопкой «Завершить настройку в AISAR»

Экран AISAR «Подключить Битрикс24 к AISAR» с адресом портала, выбором компании и кнопкой «Подключить»

На подтверждение отведено 15 минут — если не успели, Битрикс24 покажет «Срок попытки истёк» с кнопкой открыть окно AISAR заново. Ничего страшного, просто повторите шаги 3–5.

Альтернатива — начать из личного кабинета AISAR: в my.aisar.app откройте Настройки → Системы, у карточки Bitrix24 нажмите Setup — откроется шаг «Подключение». Укажите адрес вашего портала и нажмите «Открыть страницу приложения»: в новой вкладке откроется карточка AISAR в Маркете вашего портала. Мастер тем временем сам ждёт установку и покажет «Подключено», как только она пройдёт.

Шаг «Подключение» мастера AISAR: поле адреса портала, кнопка «Открыть страницу приложения» и статус ожидания установки

Шаг 2. Привязка каналов к открытым линиям

Чтобы диалоги из AISAR попадали в контакт-центр Битрикс24, каждый канал нужно привязать к открытой линии. Это делается на вкладке Mapping страницы Настройки → Системы → Bitrix24 в my.aisar.app.

Для каждого канала AISAR в списке выберите существующую открытую линию Битрикс24 из выпадающего списка — либо выберите «Создать новую линию», чтобы AISAR создал линию под этот канал автоматически.
Если выбранная линия уже используется другим коннектором (например, другим мессенджер-сервисом), AISAR покажет предупреждение с двумя вариантами: «Сосуществование» — AISAR добавляется к линии рядом с уже настроенным коннектором, оба продолжают работать; «Только AISAR» — остальные коннекторы на этой линии отключаются.
Привязку можно снять в любой момент кнопкой отмены рядом со строкой канала — это не удаляет саму линию в Битрикс24.

Вкладка Mapping в AISAR: блок «Маппинг открытых линий» с выбором линии Битрикс24 для каждого канала

Шаг 3. Сопоставление пользователей портала и AISAR

Пользователи Битрикс24 и пользователи AISAR — разные учётные записи, и AISAR не сопоставляет их автоматически (кроме того, кто устанавливал приложение — эта пара мапится сама). Без сопоставления оператору не будут доступны действия AISAR от его имени: привязка нужна и для вкладки AISAR в карточках CRM, и для телефонии.

На той же вкладке Mapping найдите блок сопоставления пользователей — слева пользователи Битрикс24, справа участники вашей компании в AISAR.
Для каждого сотрудника, который работает с диалогами или звонками в Битрикс24, выберите соответствующего пользователя AISAR из выпадающего списка.
Сразу после первой установки этот шаг может показаться в отдельном экране («Свяжите пользователей Битрикс24 с AISAR») — это тот же самый список, просто вынесенный в мастер первого запуска.

Шаг 4. Настройка телефонии

Телефония — отдельная, необязательная часть интеграции: она включает клик-to-call по номеру прямо из карточки CRM. Настраивается в два приёма — часть на стороне AISAR, часть на стороне Битрикс24.

Звонки требуют версии 2 приложения AISAR: право «Телефония» появилось именно в ней. Если приложение установлено раньше, переустановите его из Маркета — портал выдаст недостающее право, настройки интеграции при этом сохранятся.

На стороне AISAR

На вкладке Телефония (Telephony) страницы Настройки → Системы → Bitrix24 включите переключатель телефонии.
При желании выберите оператора Битрикс24 по умолчанию — на него будут назначаться звонки, если звонящий оператор ещё не сопоставлен на шаге 3.
При желании включите автосоздание лида в Битрикс24, если звонящий номер не найден в CRM.

Вкладка «Телефония» интеграции Битрикс24 в AISAR: переключатели передачи звонков и создания лида по неизвестному номеру

На стороне Битрикс24 — обязательный шаг

Без этой настройки click-to-call не будет доходить до AISAR, даже если телефония включена в AISAR. В самом Битрикс24 откройте Телефония → Настройка телефонии → Номер для исходящего по умолчанию и выберите «Приложение AISAR».

Разговор ведётся не внутри окна Битрикс24 — портал только инициирует звонок и показывает карточку вызова. Сам разговор происходит на стороне оператора: во вкладке my.aisar.app с браузерным софтфоном (держите её открытой), в приложении Zoiper на смартфоне или на настольном SIP-телефоне — смотря что подключено у конкретного оператора.

Как это выглядит в работе

Вкладка AISAR в карточке. На карточках контакта, лида и сделки в Битрикс24 появляется вкладка AISAR с перепиской по этому контакту — не нужно переключаться в my.aisar.app, чтобы посмотреть последние сообщения.
Диалоги в открытых линиях. Новые сообщения из привязанных каналов приходят в стандартный контакт-центр Битрикс24 (открытые линии) — так же, как сообщения из любого другого подключённого мессенджера.
Звонки. Клик по номеру телефона в CRM запускает звонок через AISAR; Битрикс24 показывает свою нативную карточку вызова и после завершения звонка автоматически прикрепляет запись разговора к делу — как обычный звонок через телефонию портала.

Частые проблемы и решения

Симптом	Причина и что делать
Переустановили приложение в Битрикс24 (например, чтобы обновить права доступа), и не понятно, что с настройками	Если портал уже был привязан к вашей компании AISAR, AISAR узнает его автоматически и восстановит прежние настройки синхронизации и привязки каналов — заново проходить claim не нужно. Если после переустановки в my.aisar.app статус остаётся «Не подключено» дольше пары минут, откройте карточку интеграции и нажмите «Проверить сейчас».
На экране установки Битрикс24 сообщение о том, что портал уже подключён к другой компании AISAR	Один портал Битрикс24 может быть привязан только к одной компании AISAR одновременно. Если это ошибка (портал привязали не туда), обратитесь в поддержку AISAR — отвязка чужой интеграции требует проверки.
Клик по номеру в CRM не запускает звонок в AISAR	Почти всегда это одна из двух причин. Первая: в самом Битрикс24 не выбрано «Телефония → Настройка телефонии → Номер для исходящего по умолчанию → Приложение AISAR» (см. Шаг 4). Вторая: у оператора, который кликнул, не открыт софтфон — нужна активная вкладка my.aisar.app, Zoiper или настольный SIP-телефон.
Диалоги из канала не появляются в открытых линиях Битрикс24 (или попадают не в ту линию)	Проверьте привязку этого канала на вкладке Mapping (Шаг 2) — либо она не создана, либо указывает на другую линию, чем вы ожидали. Если линия используется несколькими коннекторами, убедитесь, что при привязке выбран режим «Сосуществование», а не «Только AISAR» (иначе другой коннектор на линии окажется отключён).
У конкретного оператора не работает вкладка AISAR в карточке или звонки завершаются с ошибкой «оператор не сопоставлен»	Этот пользователь Битрикс24 ещё не сопоставлен с пользователем AISAR — откройте Шаг 3 и добавьте пару для него на вкладке Mapping.

Смотрите также

Обзор возможностей и сценариев использования интеграции — на странице aisar.app/integrations/bitrix24.