Интеграция с Bitrix24

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

• 📞 Карточка клиента всплывает в Bitrix24 у всех операторов, кому идёт входящий звонок (если включено в настройках)
• 👤 Лид (или сделка) создаётся ОДИН раз — у того сотрудника, кто реально поднял трубку
• 🎙 Запись разговора прикрепляется к карточке после завершения звонка
• 📋 Транскрипт добавляется как комментарий к лиду/сделке (опционально)
• 📲 Click-to-call из карточки B24 → звонок начинается на телефоне сотрудника МCM
• 🚫 Пропущенные создают лид с автоназначением на ответственного
• 🌐 Несколько внешних линий (DID-номеров) — каждой можно назначить своё поведение и имя

Подключение занимает 3–5 минут. От вас потребуется только установить приложение из Маркетплейса Bitrix24 и один раз вставить API-ключ.

Шаг 1. Установить «Платформа Мультиком» из Маркетплейса Bitrix24

1. В вашем портале B24 откройте раздел Приложения → Маркетплейс.
2. В поиске введите «Платформа Мультиком» или «MCM».
3. Откройте карточку приложения и нажмите «Установить».
4. Подтвердите согласие на доступ к данным — Bitrix24 запросит права на CRM, телефонию и пользователей.
5. После установки приложение появится в левом меню Bitrix24 с иконкой 📞 «Мультиком».

Все нужные права (на CRM, телефонию и пользователей) запрашиваются Маркетплейсом автоматически — вручную ничего отмечать не нужно.

Шаг 2. Открыть приложение в Bitrix24

Кликните в левом меню по пункту 📞 Мультиком. При первом открытии вы увидите экран «Введите API-ключ» — это значит установка прошла успешно, осталось привязать ваш аккаунт МCM.

Шаг 3. Получить API-ключ в кабинете MCM

1. В отдельной вкладке откройте кабинет вашего аккаунта МCM: https://<ваш-аккаунт>.smart.mcm.ru/settings/api (в боковом меню кабинета: Настройки → API ключи). Адрес <ваш-аккаунт> — поддомен, который вы получили при регистрации, например mcm1.smart.mcm.ru.
2. Нажмите «Создать ключ», дайте ему понятное имя (например, «Bitrix24») и оставьте все права.
3. Скопируйте показанный токен формата mcm_xxxxxxxx....

Шаг 4. Вставить ключ в приложение Bitrix24

1. Вернитесь в Bitrix24 на экран «Введите API-ключ».
2. Вставьте скопированный токен в поле и нажмите «Сохранить».
3. Приложение проверит ключ, привяжет ваш B24-портал к аккаунту МCM и автоматически перейдёт в режим настройки.

Ключ сохранится — больше его вводить не нужно ни на этом, ни на других компьютерах.

Настройка приложения (5 вкладок)

Статус

Показывает что подключение живо, когда истекает токен B24 и последняя ошибка (если была). Кнопка «Эхо-запрос» — мгновенная проверка что наш сервер видит ваш B24-портал.

Сотрудники

Список пользователей B24. Для каждого выберите внутренний номер MCM, чтобы карточки и лиды создавались для правильного сотрудника. Сопоставление по e-mail делается автоматически — здесь только корректируйте если нужно.

Для каждого сотрудника отдельно можно переопределить:

• Карточка — показывать ли всплывашку у этого сотрудника
• Создавать лид — создавать ли лиды на его звонки

Удобно для руководителя — ему карточки не нужны, а лиды должны идти на менеджеров.

Номера

Поведение для каждой внешней линии (DID-номера). Для каждого номера задаётся:

• Задачи — создавать ли задачу B24 на каждый звонок
• Перевод на ответственного — звонок маршрутизируется ответственному за контакт/лид
• Чат пропущенных — отправлять ли уведомление в чат про пропущенный
• Сделка — создавать сделку вместо лида (для существующих контактов)
• Тип линии:
  • Общий — все звонки на любой DID показываются под именем основного приложения («Платформа Smart Мультиком»). Колонка «Имя линии» не используется.
  • Индивидуальный — для этого DID в Bitrix24 создаётся отдельная внешняя линия с произвольным именем (например «Отдел продаж — Москва»). При входящем звонке оператор в карточке и в карточке лида увидит «На линию: ваше имя» вместо безликого номера. Полезно если у вас несколько отделов / филиалов на разных номерах.
• Имя линии (только для индивидуальных) — как линия будет подписана в Bitrix24. До 80 символов. По умолчанию «Платформа Мультиком АТС». При изменении имя автоматически обновляется в B24 без переустановки приложения.

Настройки

Глобальные опции на портал — карточка, авто-создание лидов/сделок, прикрепление записей и транскриптов, стартовый статус лида, маршрутизация ответственным и т.д.

Источники

Привязка коллтрекинга MCM к источникам (CAMPAIGN_TYPE) лидов в B24. Полезно если вы используете коллтрекинг для разделения звонков по рекламным кампаниям.

Click-to-call из B24

После установки приложения click-to-call работает автоматически. Когда сотрудник нажимает на номер в карточке клиента/лида/сделки — наша АТС поднимает его SIP-аппарат и соединяет с клиентом.

Что должно быть настроено (всё делает установщик автоматически):

• У каждого сотрудника в его профиле Bitrix24 заполнено поле «Внутренний телефон» — равно его внутреннему номеру в MCM. Без этого клик на телефон в карточке не активен. Заполняется вручную каждым сотрудником или администратором (см. инструкцию ниже).
• В профиле сотрудника → Настройки телефонии → Номер для исходящего выбрано «Приложение: Платформа Smart Мультиком».

Если кнопка «Позвонить» не реагирует — переустановите приложение из Маркетплейса и обновите карточку CRM (Ctrl+Shift+R).

Настройка внутреннего номера для click-to-call

Чтобы click-to-call из карточки Bitrix24 начинал звонок через вашу АТС, каждому сотруднику нужно один раз указать внутренний номер MCM в профиле Bitrix24.

1. Откройте свой профиль в Bitrix24: нажмите на аватар в правом верхнем углу → «Мой профиль».
2. Перейдите на вкладку «Телефон» (или найдите раздел «Телефония»).
3. В поле «Внутренний телефон» (UF_PHONE_INNER) впишите ваш внутренний номер из MCM (например, 101, 205). Узнать свой номер можно в кабинете MCM → Сотрудники, или спросить у администратора.
4. В поле «Номер для исходящего звонка» выберите «Приложение: Платформа Smart Мультиком».
5. Нажмите «Сохранить».

После этого при клике на любой телефон в CRM ваш SIP-аппарат (или мобильное приложение MCM) зазвонит и соединит вас с клиентом.

Что попадает в Bitrix24

Если что-то не работает

«Сотрудники» — пустая таблица

Признак: на вкладке «Статус» написана ошибка про недостаток прав. У портала Bitrix24 не хватает прав на чтение пользователей. Удалите приложение в Bitrix24 (Приложения → Установленные → Удалить), затем установите заново из Маркетплейса — при повторной установке Bitrix24 запросит полный набор прав.

«Введите API-ключ» появляется снова

Возможные причины:

• Ключ был отозван в кабинете MCM (на странице API-ключей).
• Ключ был привязан к ДРУГОМУ аккаунту — система отвергает чужие ключи (ошибка «api key belongs to a different tenant»).
• При копировании в ключ попали лишние пробелы или невидимые символы.

Создайте новый ключ в кабинете и вставьте — должно сработать.

Click-to-call не звонит

• На вкладке «Сотрудники» проверьте что у нажавшего кнопку «Позвонить» сотрудника указан внутренний номер MCM.
• В Bitrix24 откройте профиль того же сотрудника → Настройки телефонии → «Номер для исходящего звонка». Должно быть выбрано «Приложение: Платформа Smart Мультиком». Если выбран «Номер по умолчанию» — звонок пойдёт через встроенную телефонию Bitrix24, а не нашу АТС.
• Если в дропдауне нет нашего приложения — у профиля сотрудника не заполнен «Внутренний телефон». Заполните по инструкции ниже и обновите страницу.
• На вкладке «Статус» нажмите «Эхо-запрос» — если эхо проходит, дело в маппинге сотрудника, не в OAuth.

Запись разговора не появляется в карточке

Запись прикрепляется через 30–60 секунд после завершения звонка. Если через минуту её нет — проверьте что в Настройках включена опция «Прикреплять запись», и что у вашего тарифа МCM включена запись разговоров.

Поддержка

Если что-то не работает после прохождения всей инструкции:

• 📞 +7 (495) 787-44-67
• ✉ support@mcm.ru