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. Токен вставлять не нужно.
- В разделе Интеграции установите Kommo или Bitrix24.
- Введите адрес аккаунта:
https://yourcompany.kommo.comили адрес портала Bitrix24https://yourcompany.bitrix24.com. При желании включите Создавать лид для неизвестного входящего номера. - Нажмите Подключить, войдите в CRM и разрешите доступ. Статус изменится на Подключено.
- Нажмите Проверить подключение, затем отметьте разрешённые инструменты ИИ-агента.
Кнопка Подключить появляется только если оператор вашего PBX зарегистрировал MonoPbx как приложение в CRM. Если её нет, обратитесь к оператору. Подробнее о входе, повторном подключении и отключении: Подключения OAuth.
Подключение Odoo
В Odoo нет OAuth для внешнего API, поэтому коннектор использует API-ключ пользователя интеграции.
- В Odoo создайте пользователя для MonoPbx и в его настройках, в разделе безопасности учётной записи, новый API-ключ.
- В разделе Интеграции установите Odoo и введите адрес Odoo (
https://yourcompany.odoo.com), API-ключ пользователя интеграции и Имя базы данных. - Для Odoo 19 и новее больше ничего не нужно. Для Odoo 17 и 18 введите также ID пользователя: число в адресе пользователя в Odoo.
- Нажмите Проверить подключение.
Контакты — это записи res.partner. Открытые возможности — записи crm.lead контакта. Без приложения Odoo CRM в карточке нет сделок.
Как работают коннекторы
- Журнал звонков. Чтобы записывать в CRM каждый завершённый звонок, используйте шаблон CRM: его журнал записывает каждый завершённый внешний звонок.
- Аккаунты Kommo и Bitrix24. Адреса входа этих CRM зависят от аккаунта. В записи OAuth оператора для коннектора задана одна пара адресов, поэтому каждый PBX подключается к одному аккаунту Kommo и одному аккаунту Bitrix24.
- Более богатые записи. В Kommo создаётся обычная заметка, а не нативная запись о звонке; в Bitrix24 — комментарий в ленте, а не запись в журнале звонков.
- Другие каналы. Заметку в ленту отправляют только диалоги WhatsApp. Неудачная отправка не повторяется.