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

Введение

3CX предлагает интеграцию с Bitrix24 через 3CX CRM API. Интеграция реализует следующие возможности:

• Поиск контакта по Caller ID - входящий звонок инициирует поиск контакта в Bitrix24.
• Поиск контактов в Bitrix24 по имени, номеру или e-mail, когда пользователь 3CX ищет контакт в веб-клиенте.
• Журнал вызовов и чатов - вызовы и чаты регистрируются в карточке контакта Bitrix24 как история взаимодействия с клиентом.
• Создание нового контакта Bitrix24 из клиента 3CX, когда вызов поступил с неопознанного Caller ID.
• Click to Call - звонки из Bitrix24 через 3CX с помощью браузерного расширения 3CX Click2Call для Google Chrome и Microsoft Edge.

Шаг 1: Настройте Bitrix24

1. Зайдите в свой аккаунт на портале Bitrix24, нажмите на меню в левом верхнем углу и перейдите в раздел “Developer Resources” > “Other” > “Inbound webhook”.

2. Присвойте имя вверху, прокрутите вниз до раздела "Assign permissions", затем выберите "CRM", "Users" и "Lists", и нажмите кнопку "Сохранить".
3. Скопируйте URL-адрес веб-хука для 3CX, который находится под заголовком "Webhook to call REST API", и нажмите кнопку "Close".

Шаг 2: Настройте 3CX

1. В консоли управления 3CX перейдите в раздел Admin > Integrations > CRM.
2. Из выпадающего списка выберите "Bitrix".
3. В поле "URL Web Hook" введите URL веб-хука, созданного ранее в Bitrix24.
4. Введите домен Bitrix24 в поле "Domain".
5. Выберите приоритет поиска контактов.

Шаг 3: Настройте журналирование вызовов и чатов

1. Чтобы передавать информацию о внешних вызовах и чатах в Bitrix24, e-mail адрес добавочного номера 3CX должен совпадать с e-mail пользователя Bitrix24. В этом случае 3CX сможет сопоставить добавочный номер 3CX с пользователем Bitrix24.
2. Включите опцию "Enable Call Journaling" для передачи внешних звонков в CRM и настройте другие параметры "Call Journaling":

• "Call Subject" - тема звонка.
• "Answered Inbound Call" - описание отвеченных входящих вызовов.
• "Missed Call" - описание пропущенных вызовов.
• "Answered Outbound Call" - описание отвеченных исходящих вызовов.
• "Unanswered Outbound Call" - описание неотвеченных исходящих вызовов.

3. Обратите внимание, что в параметрах "Call Journaling" можно использовать переменные, обозначаемые как
   [variable_name]
   . Например, внешний номер указывается как
   [Number]
   . Доступные переменные приведены на сайте 3CX.

4. Включите опцию "Enable Chat Journaling" для передачи чатов в CRM и настройте другие параметры "Chat Journaling":

• "Chat Subject" - тема сеанса чата.

5. Обратите внимание, что в параметрах "Chat Journaling" можно использовать переменные, обозначаемые как
   [variable_name]
   . Например, внешний номер указывается как
   [Number]
   . Доступные переменные приведены на сайте 3CX.

Шаг 4: Настройте e164 и Caller ID для контактов

1. Чтобы установить соответствие с карточкой контакта в Bitrix24, входящий Caller ID должен быть идентичен номеру контакта в CRM, включая префиксы. Это связано с тем, что Bitrix24 выполняет поиск по полному номеру. Запрос в Bitrix24 по части номера ничего не найдет.
2. Bitrix24 хранит номера в формате E164, поэтому убедитесь, что ваш SIP-транк передает Caller ID в формате E164. В противном случае нужно переформатировать Caller ID перед передачей в CRM.
3. Перейдите в Admin > System > Phonebook > Options, установите стратегию сопоставления "Match exactly" и нажмите "ОК".

Шаг 5: Настройте создание контактов

1. Для создания новых контактов в CRM при поступлении звонка с неизвестного номера, т.е. не обнаруженного ни в 3CX, ни в CRM, установите опцию "Allow contact creation directly to your CRM using 3CX Web Client" и настройте следующие параметры.
2. Параметры создания контакта:

• "Create Lead or Contact" - тип создаваемой сущности (Lead/Contact).

3. Если Caller ID не сопоставляется с контактом, клиент 3CX позволяет создать новый контакт, заполнив данные в диалоговом окне.

Дополнительная информация

• Интеграция с любой CRM через 3CX API.
• Интеграция с CRM HubSpot.
• Интеграция с CRM Microsoft 365.
• Интеграция с CRM Salesforce.
• Интеграция с CRM Vtiger.
• Интеграция с CRM Zendesk.
• Интеграция с CRM Zoho.

Версия документа

Последнее обновление документа 10 сентября 2026

https://www.3cx.ru/docs/bitrix24-crm-integration/