メインコンテンツまでスキップ

Odoo Sync

Odoo Sync は、MonoChat のワークスペースを Odoo Online、Odoo.sh、または自社サーバー上の Odoo データベースに接続します。このアプリは次のことを行います。

  • 顧客の名前、電話番号、メールアドレス、マッピングしたプロフィール項目を Odoo の連絡先または CRM リードに送信し、存在しない場合は作成します。
  • Odoo で変更された連絡先とリードを 10 分ごとに読み取り、MonoChat の該当する顧客を更新します。
  • クローズした会話を、連絡先またはリードのチャッターにメモとして投稿します。
  • 会話の横に顧客の請求書と販売オーダーを表示し、未払いの請求書の支払いリンクを送信します。
  • 顧客がリンクから支払うと、Odoo の請求書に支払いを登録します。

始める前に​

必要なもの:

  1. API アクセスのある Odoo 17 以降。 Odoo は Custom プランで API アクセスを提供しています。自社でホストする Odoo でも利用できます。
  2. API キー。 Odoo で、アプリが代理で操作するユーザーの Preferences › Account Security を開き、New API Key を押します。キーは一度しか表示されないのでコピーしてください。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 を押します。

アプリは Odoo 19 以降では Odoo の JSON-2 API を、それ以前のバージョンでは JSON-RPC を使います。どちらで接続したかは画面に表示されます。API キーは再表示されません。保存済みのキーを残すには空欄のままにします。これらの設定を変更できるのはオーナーまたはマネージャーだけです。アドレスまたはデータベースを変更した場合は、API キーをもう一度入力してください。

同期される内容​

設定内容
Sync customers withOdoo にレコードがない MonoChat の顧客を作成する場所: 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最大 5 つのプロフィール項目。それぞれに Odoo 項目の技術名(Odoo の開発者モードで表示されます)と方向 Both ways、To Odoo only、From Odoo only を指定します。名前、電話番号、メールアドレスは常に同期されます。
  • MonoChat から Odoo へ: 顧客のプロフィールが変わると、アプリはメールアドレスまたは電話番号で連絡先やリードを探すか作成し、変わった値だけを送ります。
  • Odoo から MonoChat へ: アプリは 10 分ごとに Odoo で変更された連絡先とリードを読み取り、リンクされた顧客、または同じ電話番号やメールアドレスの顧客を更新します。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 がリクエストを拒否した場合、ノードは失敗の分岐に進みます。

AI エージェントで使う​

アプリのツールを AI エージェントに追加します。

  • Odoo · Read the customer's orders and invoices は、顧客の最新の販売オーダーと請求書を、金額、日付、未払い額とともにエージェントに渡します。
  • Odoo · Get an invoice payment link は、顧客が指定した請求書、または最も古い未払い請求書の支払いリンクをエージェントに渡し、返信で共有できるようにします。

顧客が支払うと​

支払いリンクは請求書の通貨で作成されます。顧客が支払うと、アプリは選択した仕訳帳で Odoo の請求書に支払いを登録し、メモに MonoChat と支払い番号を記載します。Odoo ですでに支払い済みの請求書はそのままです。

知っておくと便利なこと​

  • Odoo はまだ MonoChat に通知できないため、Odoo の変更は 10 分以内に MonoChat に届きます。
  • 接続前に Odoo で変更されたレコードは読み取られません。顧客は、プロフィールの変更時、会話のクローズ時、またはアプリが Odoo の変更を読み取ったときに Odoo とリンクされます。
  • アプリは Odoo 上で API キーのユーザーとして動作し、そのユーザーに許可された範囲で閲覧と変更を行います。