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

Odoo Sync

Odoo Sync подключает ваше рабочее пространство MonoChat к базе данных Odoo — в Odoo Online, Odoo.sh или на вашем сервере. Приложение:

  • отправляет имя, номер телефона, адрес e-mail и сопоставленные поля профиля ваших клиентов в их контакт или лид CRM в Odoo и создаёт запись, если её нет,
  • каждые 10 минут читает контакты и лиды, изменённые в Odoo, и обновляет соответствующих клиентов в MonoChat,
  • публикует каждый закрытый разговор как заметку в чаттере контакта или лида,
  • показывает счета и заказы на продажу клиента рядом с разговором и отправляет ссылку на оплату неоплаченного счёта,
  • регистрирует платёж по счёту в Odoo, когда клиент оплачивает ссылку.

Перед началом​

Вам понадобятся:

  1. Odoo 17 или новее с доступом к API. Odoo даёт доступ к API на тарифе Custom; у Odoo, который вы размещаете сами, он тоже есть.
  2. Ключ API. В Odoo откройте Preferences › Account Security пользователя, от имени которого будет работать приложение, и нажмите New API Key. Odoo показывает ключ один раз: скопируйте его. Odoo рекомендует отдельного пользователя для интеграций только с нужными правами.
  3. Приложения Odoo, которыми вы пользуетесь. Контакты синхронизируются всегда. Для лидов нужно приложение CRM, для заказов — Продажи, для счетов — Выставление счетов или Бухгалтерия.
  4. Платёжная система в MonoChat, чтобы отправлять ссылки на оплату. Приложение использует вашу платёжную систему по умолчанию.

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

  1. Установите приложение из MonoStore.
  2. Откройте Настройки › Odoo.
  3. Введите Odoo address (например, https://yourcompany.odoo.com) и имя Database.
  4. В Odoo 18 и более ранних версиях введите в Login (Odoo 18 and earlier) логин пользователя, которому принадлежит ключ API. Odoo 19 и новее он не нужен.
  5. Вставьте API key, нажмите Save, затем Test connection.

Приложение использует JSON-2 API Odoo начиная с Odoo 19 и JSON-RPC в более ранних версиях; экран показывает, через что установлено подключение. Ключ API больше не показывается; оставьте поле пустым, чтобы сохранить сохранённый ключ. Изменять эти настройки может только владелец или менеджер. Если вы меняете адрес или базу данных, введите ключ API заново.

Что синхронизируется​

НастройкаЧто она делает
Sync customers withГде создаётся клиент MonoChat, если в Odoo нет его записи: Contacts или CRM leads.
Add new Odoo records with a phone number as MonoChat customersКонтакт или лид, созданный в Odoo после подключения и имеющий номер телефона, становится клиентом MonoChat, которому может написать ваша команда.
Post each closed conversation to the record’s chatterКогда разговор закрывается, его сообщения после последней заметки (не более последних 100) публикуются как заметка в чаттере. Внутренние заметки не включаются.
JournalБанковский или кассовый журнал, в котором регистрируется платёж по оплаченной ссылке. Если не выбран, решает Odoo.
Field mappingДо пяти полей профиля, каждое с техническим именем поля Odoo (Odoo показывает его в режиме разработчика) и направлением: Both ways, To Odoo only или From Odoo only. Имя, номер телефона и адрес e-mail синхронизируются всегда.
  • Из MonoChat в Odoo: когда профиль клиента меняется, приложение находит его контакт или лид по адресу e-mail или номеру телефона либо создаёт запись и отправляет только изменившиеся значения.
  • Из Odoo в MonoChat: каждые 10 минут приложение читает контакты и лиды, изменённые в Odoo, и обновляет связанных с ними клиентов или клиента с тем же номером телефона или адресом e-mail. Значение, пришедшее из Odoo, обратно не отправляется.
  • Если клиент лида позже появляется как контакт Odoo, клиент связывается с контактом.
  • Настройки › Odoo показывает, когда выполнялось последнее чтение, и его ошибку, если оно не удалось.
  • Запись, которую не удаётся применить в MonoChat, не останавливает чтение: экран показывает, сколько записей пропущено, последнюю из них и причину.

Рядом с разговором​

Карточка Odoo рядом с разговором показывает последние счета клиента с остатком к оплате и статусом оплаты, а также его последние заказы на продажу. Для неоплаченного счёта кнопка Send payment link отправляет клиенту сообщение со ссылкой на оплату остатка.

В ваших сценариях​

Добавьте узел Функция в сценарий в разделе Настройки › Автоматизация › Сценарии и выберите один из узлов приложения. См. Сценарии.

УзелЧто он делаетВыходы
Odoo · Send orders or invoicesОтправляет клиенту его неоплаченные счета или последние заказы на продажу (номер, сумма и дата) под заголовком, который вы напишете.Sent, None, Not in Odoo
Odoo · Send invoice payment linkСоздаёт ссылку на оплату самого старого неоплаченного счёта клиента на сумму остатка и отправляет её с вашим сообщением. Вставьте {invoice}, {amount} и {link} в нужные места сообщения.Sent, No invoice, Not in Odoo, No payment system

Not in Odoo означает, что приложение не нашло контакт Odoo для клиента. Если Odoo отклоняет запрос, узел переходит в ветку ошибки.

С вашим ИИ-агентом​

Добавьте инструменты приложения вашему ИИ-агенту:

  • Odoo · Read the customer's orders and invoices даёт агенту последние заказы на продажу и счета клиента с суммами, датами и остатком к оплате.
  • Odoo · Get an invoice payment link даёт агенту ссылку на оплату счёта, который называет клиент, или самого старого неоплаченного, чтобы поделиться ею в ответе.

Когда клиент платит​

Ссылка на оплату выставляется в валюте счёта. Когда клиент её оплачивает, приложение регистрирует платёж по счёту в Odoo, в выбранном журнале, с MonoChat и номером платежа в назначении. Счёт, уже оплаченный в Odoo, остаётся без изменений.

Полезно знать​

  • Odoo пока не умеет уведомлять MonoChat, поэтому изменения из Odoo попадают в MonoChat в течение 10 минут.
  • Записи, изменённые в Odoo до подключения, не читаются. Клиент связывается с Odoo, когда меняется его профиль, закрывается разговор или приложение читает изменение в Odoo.
  • Приложение работает в Odoo от имени пользователя ключа API: видит и меняет то, что разрешено этому пользователю.