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

Введение

Начиная с 3CX Version 20 Update 10, АТС 3CX предоставляет встроенную интеграцию с Odoo CRM через 3CX CRM API со следующими функциями:

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

Шаг 1: Настройка Odoo

  • Войдите в Odoo CRM
  • Нажмите на изображение профиля и выберите опцию My Preferences
  • Выберите вкладку Security
  • Нажмите кнопку Add API Key:
  • Задайте новому API Key имя и срок действия
  • Нажмите кнопку Generate key
  • Скопируйте API Key в надежное место
  • Нажмите кнопку Done
  • Запишите имя базы данных экземпляра, обычно это имя хоста FQDN Odoo
  • Если имя базы данных неизвестно:
  • Нажмите на изображение профиля и выберите опцию My Databases
  • Выполните повторный вход, если требуется
  • Запишите имя базы данных экземпляра

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

  • В консоли администратора 3CX перейдите в Integrations → CRM
  • Выберите OdooCRM из выпадающего списка
  • Введите необходимую информацию:
  • URL-адрес домена Odoo (например, https://3cx-example.odoo.com )
  • имя базы данных Odoo
  • API Key Odoo
  • Нажмите кнопку Save

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

  • Для регистрации внешних вызовов номер телефона удаленного абонента должен совпадать с номером телефона контакта Odoo. АТС 3CX сопоставляет полученный вызов с контактом Odoo.
  • Отметьте опцию Enable Call Journaling для регистрации внешних вызовов в CRM, а затем настройте следующие параметры журналирования вызовов:
  • "Call Subject" - тема вызова.
  • "Answered Inbound Call" - описание для отвеченных входящих вызовов.
  • "Missed Call" - описание для пропущенных вызовов.
  • "Answered Outbound Call" - описание для отвеченных исходящих вызовов.
  • "Unanswered Outbound Call" - описание для неотвеченных исходящих вызовов.
  • Обратите внимание, что в параметрах журналирования вызовов можно использовать переменные, обозначаемые как
    [variable_name]
    , например, внешний номер указывается как
    [Number]
    . Также доступные для использования переменные перечислены
    здесь..

  • Для регистрации чатов в CRM, отметьте чекбокс Enable Chat Journaling.
  • Также есть возможность настроить "Chat Subject"
  • Для регистрации внешних чатов в Odoo, email-адрес (Web Chat) или номер телефона (SMS/WhatsApp) удаленного абонента должен совпадать с соответствующим полем контакта Odoo. В результате АТС 3CX сопоставляет полученный чат с контактом Odoo.
  • В параметре "Chat Subject" допускается использование переменных, обозначаемых как
    [variable_name]
    , например, внешний номер указывается как
    [Number]
    . Доступные для использования переменные перечислены
    здесь.

Шаг 4: Настройка сопоставления контактов

На странице настройки 3CX Odoo можно выбрать, выполняется ли сопоставление контактов сначала по обычным контактам или по записям типа Компания в Odoo.

Кроме того, в зависимости от требований, для вызовов можно использовать как точное, так и частичное сопоставление контактов. Данная опция настраивается в System > Phonebook > Options.

Используйте Match exactly, если:

  • имеется полная поддержка E164:
  • все контакты сохранены в этом формате
  • и все вызовы принимаются и совершаются в этом формате.
  • Это гарантирует 100% точность сопоставления контактов.

Используйте Match at least X number of characters, если:

  • Вызовы совершаются и принимаются с использованием комбинации:
  • Локального набора,
  • E164
  • Или других форматов международного набора.
  • Оптимальное количество символов зависит от локальной схемы нумерации.

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

  1. Если требуется создавать новые контакты в CRM при поступлении вызова с неизвестного номера (не найденного ни в 3CX, ни в CRM), отметьте чекбокс Allow contact creation directly to your CRM using 3CX Web Client.
  2. Если номер звонящего невозможно сопоставить с контактом, клиент 3CX позволяет заполнить данные в диалоговом окне.

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

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

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

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