Перейти к основному содержимому

Kommo, Bitrix24 и Odoo

Для Kommo, Bitrix24 и Odoo есть встроенные коннекторы. Коннектор умеет больше, чем шаблон CRM: он показывает открытые сделки звонящего, может создать лид для неизвестного номера, предоставляет инструменты ИИ-агенту и отправляет диалоги WhatsApp в CRM.

Три коннектора находятся в разделе Админ > Подключения > Интеграции (/admin/integrations). Чтобы установить коннектор, нужно integrations:write, чтобы его увидеть — integrations:read.

Что делает коннектор​

ФункцияЧто происходит
Карточка звонящегоДля номера показываются контакт, его компания и открытые сделки (Odoo: открытые возможности). Показываются только открытые сделки, выигранные и проигранные не выводятся. Карточка запрашивается через GET /api/v1/integrations/caller-context?number= (право self:read).
Лид из неизвестного звонящегоЕсли включено Создавать лид для неизвестного входящего номера, звонящий, которого CRM не знает, становится лидом, и звонок записывается в него. Лид называется Call from <номер>.
Инструменты ИИ-агентаcrm_lookup (контакт, компания и открытые сделки по номеру) и crm_log_note (добавить заметку в контакт с этим номером; если CRM номер не знает, ничего не добавляется). ИИ-агент вызывает только те инструменты, которые вы отметили в разделе Инструменты ИИ-агента.
Заметка о диалоге WhatsAppКогда оператор архивирует диалог WhatsApp, в контакт (или в новый лид, если включено создание лидов) добавляется одна заметка: первая строка с именем клиента и ссылкой на диалог, затем последние 30 сообщений. Каждое сообщение обрезается до 240 символов, вся заметка — до 2000. Заметка отправляется один раз на диалог и CRM.

Учётные данные доступны только для записи: они зашифрованы ключом вашей компании и больше не показываются.

Подключение Kommo или Bitrix24​

Оба входят через OAuth 2.0. Токен вставлять не нужно.

  1. В разделе Интеграции установите Kommo или Bitrix24.
  2. Введите адрес аккаунта: https://yourcompany.kommo.com или адрес портала Bitrix24 https://yourcompany.bitrix24.com. При желании включите Создавать лид для неизвестного входящего номера.
  3. Нажмите Подключить, войдите в CRM и разрешите доступ. Статус изменится на Подключено.
  4. Нажмите Проверить подключение, затем отметьте разрешённые инструменты ИИ-агента.

Кнопка Подключить появляется только если оператор вашего PBX зарегистрировал MonoPbx как приложение в CRM. Если её нет, обратитесь к оператору. Подробнее о входе, повторном подключении и отключении: Подключения OAuth.

Подключение Odoo​

В Odoo нет OAuth для внешнего API, поэтому коннектор использует API-ключ пользователя интеграции.

  1. В Odoo создайте пользователя для MonoPbx и в его настройках, в разделе безопасности учётной записи, новый API-ключ.
  2. В разделе Интеграции установите Odoo и введите адрес Odoo (https://yourcompany.odoo.com), API-ключ пользователя интеграции и Имя базы данных.
  3. Для Odoo 19 и новее больше ничего не нужно. Для Odoo 17 и 18 введите также ID пользователя: число в адресе пользователя в Odoo.
  4. Нажмите Проверить подключение.

Контакты — это записи res.partner. Открытые возможности — записи crm.lead контакта. Без приложения Odoo CRM в карточке нет сделок.

Как работают коннекторы​

  • Журнал звонков. Чтобы записывать в CRM каждый завершённый звонок, используйте шаблон CRM: его журнал записывает каждый завершённый внешний звонок.
  • Аккаунты Kommo и Bitrix24. Адреса входа этих CRM зависят от аккаунта. В записи OAuth оператора для коннектора задана одна пара адресов, поэтому каждый PBX подключается к одному аккаунту Kommo и одному аккаунту Bitrix24.
  • Более богатые записи. В Kommo создаётся обычная заметка, а не нативная запись о звонке; в Bitrix24 — комментарий в ленте, а не запись в журнале звонков.
  • Другие каналы. Заметку в ленту отправляют только диалоги WhatsApp. Неудачная отправка не повторяется.