
# Odoo

> **対象読者:** Odoo（製品カタログ、CRMパイプライン、受注管理など）を利用しており、AIエージェントがチャットで直接それらを使用できるようにしたい企業。Odooを使用していない場合は、このページをスキップしてください。
>
> 他のCRMやERPを使用していますか？APIを備えたものであれば、引き続き接続可能です。[リストにないツールの接続](connecting-other-tools.md)を参照してください。

Odooは、販売、CRM、在庫、請求書発行など、多くのビジネスアプリを単一のデータベース上で統合したスイートです。Odooを <span data-t="appName">DM Champ</span> に接続することで、Webhookやカスタム関数を構築することなく、通常の会話の中でAIエージェントに以下の3つの操作を行わせることができます。

- **カタログから製品に関する質問に回答する:** 名前、通貨と税金を含めた価格、在庫、説明など、すべてOdooからリアルタイムで読み取ります。
- **営業チームにリードを引き継ぐ:** 顧客が購入に関心を示した場合、AIは顧客が求めている内容の要約とともに、Odoo CRM内にリード（または案件）を作成します。
- **顧客に注文状況を伝える:** 顧客自身の注文に関するステータス、商品、請求書発行、配送状況を確認します。

---

## 必要なもの

- Odoo **14以降**: Odoo Online、Odoo.sh、または自社サーバー。
- AIが操作を行うためのOdoo **ユーザー**: そのユーザーがOdooで閲覧・実行できる範囲が、AIの閲覧・実行範囲となります。販売、CRM、在庫へのアクセス権を持つ専用ユーザーを作成するのが最適です。管理者権限は必要ありません。
- そのユーザーの **APIキー**: Odooでユーザー名（右上）をクリックし、**設定** → **アカウントのセキュリティ** → **新しいAPIキー** の順に進みます。「AIエージェント」などの名前を付けてキーをコピーしてください（Odooには一度しか表示されません）。

---

## Odooの接続

1. 左側のサイドバーで、**Settings**（歯車アイコン）をクリックします。
2. Settingsサイドバーの **Integrations** グループの下にある **CRM & ERP** をクリックします。
3. **Odoo** カードの **Connect** をクリックします。

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-odoo.png" alt="OdooタイルとConnectボタンが表示されたCRM &amp; ERP設定セクション。Odoo 14以降で、OdooユーザーのAPIキーを使用して動作する旨の注記がある"><figcaption><p>接続前のSettings → CRM &amp; ERP：Connectボタンが1つあり、接続されたOdooユーザーが閲覧できる内容はAIも閲覧できるという注意書きが表示されています。</p></figcaption></figure>
:::

4. **Odooアドレス** を入力します。サインイン時に使用するアドレス（例: `https://acme.odoo.com`）です。ブラウザからアドレス全体を貼り付けても問題ありません。
5. **データベース** は任意です。空欄のままにすると、サーバーにデータベースが1つしかない場合は自動的に検出されます。サーバーに複数のデータベースがある場合やリストが非表示になっている場合は、名前を入力してください。Odoo Onlineの場合は通常、アドレスの最初の部分（`acme.odoo.com` の場合は `acme`）になります。
6. **Odooユーザーログイン**（そのユーザーがサインインに使用するメールアドレス）と、上記の手順で取得した **APIキー** を入力します。
7. **接続** をクリックします。

::: master-only
<figure><img src="../.gitbook/assets/v2-odoo-connect-modal.png" alt="Odoo接続ダイアログ。Odooアドレス、データベース、Odooユーザーログイン、APIキーの各フィールドがあり、それぞれの下にヒントが表示されています。キャンセルボタンと接続ボタンもあります"><figcaption><p>接続に必要なすべての情報（サインイン用アドレス、データベース（任意）、AIが操作するOdooユーザー、そのユーザーのAPIキー）を1つの画面で入力します。</p></figcaption></figure>
:::

### 認証情報の確認

Odooによって確認されるまで、何も保存されません。**接続** をクリックすると、そのアドレスが実際にOdooサーバーであるか、ログイン情報とAPIキーを使用してそのデータベースにサインインできるか、そして製品、CRM、販売、在庫アプリにユーザーがアクセスできるかを確認します。アドレス、データベース、ログイン情報、キーが間違っている場合、またはユーザーにアクセス権がない場合は、その場で拒否され、理由が画面に表示されます。

接続が成功すると、接続済みカードに会社名、Odooのバージョン、AIが接続しているデータベース、AIが操作するユーザーが表示されます。

APIキーは暗号化されて保存され、二度と表示されることはありません（あなたにも、チームにも表示されません）。紛失した場合は、Odooで新しいキーを作成して再度接続してください。

### AIができること

接続済みカードには3つのスイッチがあります。接続後は3つともオンになっています。AIに触れさせたくない項目はオフにしてください。

- **製品カタログからの回答** — 製品名、価格、税金、在庫、説明。
- **CRMでのリード作成** — 会話から新規リードや商談を作成。
- **顧客自身の注文の検索** — 注文状況や配送状況の確認。

これらは、Odooが有効になっているすべてのエージェントに適用されます。接続時に接続ユーザーがいずれかのアプリにアクセスできなかった場合（例：在庫管理がインストールされていない場合）、そのスイッチの下にその旨が表示されます。

### 一時停止または接続解除

- **一時停止**は、接続設定を維持したまま、すべてのエージェントによるOdooの使用を停止します。**有効化**で再度使用可能になります。
- **接続解除**は接続を完全に削除します。AIがすでに作成したリードはOdooに残ります。後で同じ詳細情報を使用して再接続できます。

---

## AIエージェントでOdooを有効にする

Odooを接続しても、AIの動作はすぐには変わりません。エージェントごとに有効にする必要があります：

1. サイドバーの**AIエージェント**をクリックし、エージェントを開きます。
2. **AI機能**ステップに進み、**Odoo**カードまでスクロールします。このカードはOdooが接続された後にのみ表示されます。
3. **このエージェントの会話でOdooを使用する**をオンにします。設定は即座に保存されます。

このカードには、Settings → CRM & ERPの下にあるスイッチに基づいて、このエージェントが実行できる操作が一覧表示されます。同じアカウント内のサポートエージェントとセールスエージェントで設定を分けることができます。Odooを使用させるエージェントに対してのみスイッチをオンにしてください。

---

## AIにできること

### 製品に関する質問

顧客が製品、価格、在庫状況について質問したり、「Xを販売していますか？」と尋ねたりすると、AIは回答する前にOdooカタログを検索します。Odooで**販売可能**とマークされた製品を対象に、製品名、内部参照、バーコードで照合し、価格と通貨、税込かどうか、在庫管理対象製品の在庫レベル、販売説明を回答します。一致するものがない場合、AIは推測せずに、別の名前や製品コードを顧客に尋ねます。

### リード

顧客が購入に強い関心を示した場合（見積もりの依頼、電話の希望、チャットで完結できない注文の希望、デモの依頼など）、AIは営業チームが必要とする情報（正確な内容、数量、時期、予算、名前、メールアドレスなど）を収集し、Odoo CRMにレコードを作成します：

- CRMでリードステージを使用している場合は**リード**として、それ以外の場合はパイプラインの**商談**として作成されます。
- 顧客の電話番号、メールアドレス、名前は<span data-t="appName">DM Champ</span>の連絡先から取得され、一致する顧客がOdooに存在する場合はその顧客とレコードがリンクされます。
- その顧客にすでに未処理のリードや商談がある場合、AIは重複を作成する代わりに、新しいリクエストをメモとして追加します。

レコードには「オフィスチェア20脚の見積もり」といったタイトルと、チーム向けに作成された要約、さらに会話が発生したチャネルに関するメモが含まれます。

プレイグラウンドでエージェントをテストしても、Odooには何も作成されません。AIは作成されるはずだった内容を通知します。

### 注文状況

顧客から注文の場所、注文内容、または発送済みかどうかを尋ねられた場合、AIはOdooで注文を検索し、注文参照番号、ステータス（見積、確認済み、完了、またはキャンセル）、日付、合計金額、品目、請求状況、および配送業者から提供された場合は追跡番号を含む配送状況を回答します。

AIは、顧客に対して**その顧客自身の**注文のみを表示します。

- WhatsApp、SMS、およびその他の電話チャネルでは、注文は顧客がメッセージを送信している番号（および連絡先にメールアドレスがある場合はそのメールアドレス）と照合されます。
- 本人確認が行われないWebサイトのチャットでは、AIは注文参照番号と注文時に使用されたメールアドレスの**両方**を要求し、両方が一致した場合にのみ注文を表示します。

AIが他人の注文を一覧表示したり、参照番号のみで注文を検索したりする方法はありません。

---

## 知っておくべきこと

- **1アカウントにつき1つのOdoo。** 複数の会社を別々のOdooデータベースで運営している場合は、エージェントが使用すべきデータベースを接続してください。
- **Odooユーザーが制限となります。** AIは、そのユーザーが見ることができるもののみを正確に認識します。Odooの販売、CRM、在庫アプリへのアクセス権をユーザーに付与し、AIが触れるべきではないものにはアクセス権を与えないようにしてください。
- **Odooが信頼できる唯一の情報源です。** Odooから<span data-t="appName">DM Champ</span>にコピーされるデータはありません。すべての回答は、その瞬間のOdooのライブデータを読み取ります。
- **電話番号は緩やかに照合されます。** Odooに`06 12 34 56 78`として保存されている顧客の番号は、`+31 6 12345678`からメッセージが送信された場合でも検索されます。
- **Odooに接続できない場合。** AIは謝罪し、ナレッジベースから回答できる範囲で回答し、顧客がすぐに回答を必要としている場合はチームに通知します。

---

## 次のステップ

- [AIエージェント](../ai-agents/ai-agents.md) — Odooを使用するエージェントを設定します。
- [ナレッジベース](../ai-automation/faq-management.md) — ポリシー、配送時間、返品ルールを追加して、AIがカタログ以外の質問にも回答できるようにします。
- [リストにないツールを接続する](connecting-other-tools.md) — 上記の3つの機能でカバーできないOdoo関連のあらゆること（カスタム関数、Webhook、APIなど）に対応します。
