Хаб интеграций
Хаб интеграций — это единое место, где бизнес подключает внешние каналы и системы, чтобы они работали вместе с CRM: мессенджеры, формы сайта, телефонию, обмен документами, собственные приложения. Подключённый канал перестаёт жить отдельно: входящие сообщения, заявки и звонки становятся обращениями с ответственным, воронкой и историей.
Хаб находится в разделе CRM → Интеграции (маршрут /crm/integrations). Конструктор форм открывается рядом — на /crm/integrations/forms.
Единый порядок подключения
Все коннекторы подключаются по одному и тому же маршруту, в рабочих терминах:
- Добавить. Выберите тип коннектора из каталога и пройдите пошаговый мастер. Часто можно выбрать готовый бизнес-сценарий, чтобы не настраивать всё вручную.
- Настроить. Заполните основные поля; продвинутые параметры транспорта и авторизации скрыты, пока не нужны. Настройку можно сохранить черновиком и вернуться позже.
- Проверить соединение. Запустите проверку — она покажет, исправно ли подключение, и понятную причину, если что-то не так.
- Включить. Сохраните подключение с переключателем активности. Для веб-виджета и форм на этом шаге генерируется код для вставки на сайт.
- Статус и здоровье. У каждой карточки подключения есть состояние: активно и исправно, предупреждение, ошибка, черновик, в архиве или выключено. По нему сразу видно, какие каналы требуют внимания.
- Поток работы. У каждого типа свой рабочий экран: счётчики заявок у форм, журнал запросов у REST-интеграции, задания синхронизации у обмена документами, здоровье отправки и очередь повторов у мессенджеров.
Кто настраивает
Хаб интеграций — это администраторская настройка, а не ежедневное действие сотрудника. Просмотр каталога доступен по праву на чтение коммуникаций; создавать, менять, проверять и удалять подключения можно по праву на запись (администратор портала имеет полный доступ). Без прав на запись хаб открывается только для чтения: коннекторы видно, но мастер, проверка и переключатели недоступны, а при попытке появляется сообщение о нехватке прав.
Каталог коннекторов
В каталоге собраны типы внешних подключений, которые поддерживает ваш портал. Набор типов пополняется, и в разных установках он может отличаться, поэтому точный список всегда смотрите в самом каталоге на /crm/integrations, а не в этой статье. Ниже описаны основные семейства коннекторов.
В отдельных версиях интерфейса карточка коннектора может временно показывать техническое название вместо понятной подписи. Это не меняет тип подключения или его права, но такой экран не следует считать локализованным доказательством и публиковать как screenshot до исправления интерфейса и визуальной проверки.
Каталог и фильтр подключений сгруппированы по направлению работы: обмен документами, чаты и мессенджеры, формы, телефония, почта, программный доступ (REST) и вход в портал. По группе удобно искать нужный тип, когда в каталоге их много.
Обмен документами
- Обмен документами (СБИС) — интеграция с оператором электронного документооборота СБИС: из карточки документа готовятся исходящие черновики, подтягиваются статусы и подписанные копии, а входящие документы сопоставляются с клиентом. Это региональный коннектор для РФ. Подробно — на странице Обмен документами (СБИС).
- Diadoc — второй оператор электронного документооборота для РФ. Назначение то же: исходящие документы, статусы подписания и сопоставление входящих с клиентом.
Чаты и мессенджеры
- Telegram-бот и MAX-бот — двусторонние диалоговые каналы: входящие сообщения из мессенджера привязываются к обращениям и чатам CRM, а ответы уходят обратно через коннектор.
- WhatsApp — диалоговый канал мессенджера с той же логикой: сообщение клиента становится обращением с ответственным и историей.
- Чат-виджет — встраиваемое окно чата для сайта: посетитель пишет с сайта, и обращение появляется в общем потоке CRM. В мастере нужно указать хотя бы один разрешённый домен без протокола; там же можно выбрать рабочую группу, пространство и воронку, настроить форму перед чатом и после сохранения получить код для вставки.
- Чат-webhook — приём сообщений из внешней чат-системы через веб-хук, когда готового коннектора для неё нет.
Формы и заявки
- Форма сайта — односторонний приём заявок с внешней формы через веб-хук: заявки превращаются в обращения по выбранному сценарию — сразу в CRM, сначала проверка или только локально.
- Формы сайта (встроенный модуль) — собственные формы портала, которые вы создаёте и публикуете без программиста. Отдельной настройки в хабе у них нет: кнопка «Открыть формы» ведёт в конструктор форм, а карточка в хабе показывает счётчики заявок и ошибок CRM. См. также Формы.
- Опросы — сбор ответов по опросной форме в тот же входящий поток.
Опросы — отдельный конструктор входящих обращений. В CRM → Интеграции создайте опрос, добавьте шаги, настройте варианты и контактные поля, затем проверьте вкладки «Публикация» и «Ответы». Перед публикацией укажите разрешённые адреса сайтов. Портал выдаёт публичную ссылку и код для всплывающего или встроенного виджета. Публикация и снятие с публикации выполняются отдельным действием и могут быть отклонены проверкой готовности или ошибкой; удаление требует второго подтверждения. Архивирование через интерфейс недоступно. Публичная страница доступна без входа и выбирает язык кнопок по языку посетителя. В текущей публичной форме телефон принудительно преобразуется к российскому виду +7 независимо от языка и страны посетителя; международный номер может измениться. До исправления не собирайте номера через опрос и не считайте это поле локализованным или пригодным для screenshot-доказательства. Для документации используйте синтетические вопросы, адреса и ответы; не публикуйте токены, реальные контакты или рабочие ссылки.
Связь и почта
- Телефония — карточка внешнего телефонного провайдера и правила CRM для входящих звонков. В текущем мастере нельзя выбрать цель маршрутизации; пока это поле не появится, не считайте подключение провайдера, входящую маршрутизацию или CDR доступным результатом.
- Почтовый ящик — подключение рабочей почты, чтобы переписка с клиентом попадала в CRM, а не оставалась в личном почтовом клиенте одного сотрудника.
Программный доступ и вход
- Внешняя REST-интеграция (API-ключ) — программная двусторонняя связь: внешняя система создаёт и обновляет задачи и сделки по API с ключом доступа, от имени отдельного служебного аккаунта с минимальными правами. Подробно — на странице Внешняя REST-интеграция.
- Единый вход (OIDC) — вход сотрудников в портал через корпоративную систему аутентификации. Это административная настройка уровня всего портала: она меняет способ входа для людей, а не поток заявок. Доступность мастера зависит от конфигурации портала; порядок настройки и безопасного входа описан в статье Единый вход (OIDC).
Отдельно настраивается AI: подключение внешних языковых моделей и ассистентов — см. AI и сценарии.
Ограничение телефонии в текущем хабе: карточка коннектора доступна, но мастер не показывает цель маршрутизации — очередь или конкретного пользователя. Сохранение маршрута без такой цели отклоняется сервером; настройки воронки — отдельный слой. До появления этого поля не считайте провайдера подключённым и не обещайте входящую маршрутизацию, очередь, запасной маршрут или CDR. Сценарий остаётся source-blocked и planned.
Коннекторы одним взглядом
| Коннектор | Направление | Что нужно для подключения | Где контролировать после включения |
|---|---|---|---|
| REST-интеграция | Двустороннее (по API) | API-ключ, служебный аккаунт с минимальными правами | Состояние подключения, ошибки обмена и входящие события |
| Telegram-бот / MAX-бот | Двустороннее (диалог) | Токен бота, адрес приёма | Диалоги, ошибки доставки и повторные отправки |
| Двустороннее (диалог) | Доступ провайдера канала, адрес приёма | Диалоги, ошибки доставки и повторные отправки | |
| Чат-виджет | Двустороннее (диалог) | Хотя бы один разрешённый домен без протокола, код для вставки; форма перед чатом и маршрутизация — по необходимости | Обращения и переписку, созданные с сайта |
| Чат-webhook | Входящие сообщения | Адрес приёма и доступ внешней чат-системы | Принятые сообщения и ошибки обработки |
| Форма сайта | Одностороннее | Адрес приёма, название источника, токен | Принятые заявки и ошибки обработки |
| Конструктор форм | Одностороннее | Собрать форму внутри портала | Принятые заявки и готовность формы |
| Опросы | Одностороннее | Опросная форма и правило приёма ответов | Принятые ответы и ошибки обработки |
| Телефония | Каталог и ограниченный мастер | Провайдер и воронка; цели маршрутизации нет | Не подтверждает подключение, маршрут или CDR |
| Почтовый ящик | Двустороннее (письма) | Доступ к рабочему почтовому ящику | Переписку по клиенту и ошибки получения |
| Обмен документами (СБИС) | Двустороннее (документы) | Логин/пароль оператора, юрлицо, стенд | Статусы обмена по документам |
| Diadoc | Двустороннее (документы) | Доступ оператора, юрлицо | Статусы обмена по документам |
| Единый вход (OIDC) | Вход в портал | Данные корпоративной системы входа | Успешность входа сотрудников |
Таблица описывает основные семейства, а не полный перечень: набор типов в каталоге вашего портала может быть шире.
Хорошие практики
- Давайте подключению понятное имя и сразу запускайте проверку соединения, а не включайте «вслепую».
- Для каждого канала назначайте воронку, стартовый этап и ответственного, чтобы заявка не зависала без владельца.
- Регулярно проверяйте статусы: канал с предупреждением или ошибкой — это потерянные заявки и сообщения.
- Не показывайте на скриншотах и не пересылайте токены, ключи, пароли и коды для вставки с реальными значениями.
Связанные страницы