Битрикс24 — подключение
Эта страница поможет администратору связать вашу компанию в АТС с порталом Битрикс24. После подключения звонки будут попадать в CRM: всплывает карточка контакта, в таймлайне появляется запись разговора, а по пропущенным вызовам автоматически ставятся задачи.
АТС работает в мультитенантном режиме. Если у вас несколько компаний, каждая подключает свой портал Битрикс24 со своими настройками. Описанные ниже действия выполняются отдельно для каждой компании.
Когда это нужно
Подключение Битрикс24 пригодится, если вы хотите:
- видеть карточку звонящего прямо в CRM при входящем вызове;
- хранить записи разговоров в карточках сделок и контактов;
- автоматически создавать задачи и дела по пропущенным звонкам;
- направлять входящий звонок на ответственного менеджера из CRM.
Все шаги выполняются в админ-панели АТС: раздел Настройки → Битрикс24.
Что подготовить заранее
Перед началом откройте свой портал Битрикс24 и создайте способ подключения. Поддерживаются два варианта:
| Вариант | Когда выбрать | Что понадобится от вас |
|---|---|---|
| Входящий вебхук | Самый простой способ для большинства компаний | URL вебхука с правами на CRM и телефонию |
| OAuth-приложение | Если в вашей компании принято работать через локальное приложение Битрикс24 | Параметры приложения от вашего администратора Битрикс24 |
В Битрикс24 вебхук создаётся в разделе разработчика портала. При создании выдайте права на работу с CRM (контакты, лиды, сделки), телефонию и задачи — иначе часть функций звонков работать не будет.
Шаг 1. Откройте настройки интеграции
- Войдите в админ-панель АТС под учётной записью администратора.
- Перейдите в раздел Настройки.
- Откройте вкладку Битрикс24.
Шаг 2. Укажите данные портала
- В поле Домен Битрикс24 введите адрес вашего портала, например
<компания>.bitrix24.kz. - В поле URL входящего вебхука вставьте ссылку, которую вы получили на портале (она выглядит как длинный адрес с ключом —
<токен>). - Убедитесь, что включён переключатель Интеграция активна.
- Нажмите Сохранить.
Адрес вебхука содержит секретный ключ. Не пересылайте его в открытых чатах и не показывайте посторонним — любой, у кого есть эта ссылка, получит доступ к вашему порталу.
Шаг 3. Проверьте подключение
- Нажмите кнопку Проверить подключение.
- Дождитесь ответа системы.
Результат: появляется сообщение об успешном соединении. Если соединение не удалось — проверьте правильность домена и адреса вебхука, а также то, что вебхук не отключён на стороне Битрикс24, после чего повторите проверку.
Шаг 4. Привяжите входящий номер (внешнюю линию)
Чтобы входящие вызовы корректно регистрировались в CRM, ваш городской номер (DID) нужно связать с внешней линией Битрикс24.
- Убедитесь, что входящий номер уже заведён в АТС (раздел Входящие номера (DID)).
- На стороне Битрикс24 этот номер привязывается как внешняя линия телефонии — название линии и номер задаются в настройках телефонии портала.
Результат: при звонке на ваш номер в Битрикс24 у ответственного менеджера всплывает карточка звонка, а сам вызов отображается в журнале телефонии портала.
Шаг 5. Сопоставьте сотрудников с пользователями Битрикс24
Чтобы карточка звонка показывалась нужному менеджеру, свяжите внутренние номера АТС с пользователями вашего портала.
- В той же вкладке Битрикс24 найдите блок сопоставления (маппинга) сотрудников.
- Нажмите Загрузить пользователей Б24 — система подтянет список сотрудников вашего портала.
- Выберите внутренний номер сотрудника (например, добавочный оператора).
- Выберите соответствующего пользователя Битрикс24 из списка.
- Нажмите Добавить.
- Повторите для каждого сотрудника.
Результат: при звонке на внутренний номер карточка вызова появляется именно у привязанного сотрудника, а записи разговоров попадают в его таймлайн.
Если для номера не задано соответствие, звонок всё равно зарегистрируется в CRM, но не будет привязан к конкретному менеджеру. Поэтому рекомендуем сопоставить всех операторов.
Что настроить дальше
После подключения портала рекомендуем выбрать ответственного по умолчанию и проверить остальные параметры работы со звонками:
- Ответственный по умолчанию для входящих — сотрудник, на которого будут попадать обращения от новых клиентов.
- Карусель ответственных для пропущенных — список сотрудников, между которыми по очереди распределяются пропущенные вызовы.
Эти и другие настройки описаны на странице Битрикс24 — звонки и карточки и Битрикс24 — пропущенные звонки.
Возможные проблемы
| Симптом | Что проверить |
|---|---|
| Кнопка «Проверить подключение» сообщает об ошибке | Правильность домена и адреса вебхука; не отключён ли вебхук на портале |
| Карточка звонка не всплывает у менеджера | Задано ли сопоставление внутреннего номера с пользователем Битрикс24 (шаг 5) |
| Входящий звонок не виден в журнале телефонии Битрикс24 | Привязан ли ваш входящий номер к внешней линии портала (шаг 4) |
| Не открывается список пользователей по кнопке «Загрузить пользователей Б24» | Достаточно ли прав у вебхука; повторите «Проверить подключение» |