> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Odoo 受付担当は、発信者がすでにOdooの連絡先に登録されているかを確認できます。新規の発信者については、要件とともにOdoo CRMへリードとして追加し、営業チームがフォローアップできるようにします。接続方法は2つあります。 * **[Webhookツール](#option-1-webhook-tools-recommended)** はOdooのJSON-2 APIを直接呼び出すため、ZapierアカウントやZapierタスクを使用しません。Odoo 19以降のCommunityまたはEnterpriseが必要で、odoo.com、Odoo.sh、または自社サーバーでホストされている必要があります。 * **[Zapier](#option-2-zapier)** は古いバージョンのOdooにも対応していますが、アクションごとにZapierプランのタスクを消費し、セルフホスト型データベースは検索できません。 データベースがOdoo 19以降で動作している場合は、Webhookツールを使用してください。Odooの旧APIであるJSON-RPCでは、各メソッドの引数をさまざまな値が混在した1つのリストとして渡します。Webhookツールではこのリストを作成できないため、古いバージョンではZapierを使用してください。 > **Note** > > Odooで外部アプリからデータにアクセスできるのは、**カスタム** プランのみです。データベースが > Odooによってホストされ、One App FreeまたはStandardプランを利用している場合は、開始前にプランを確認してください。 ## オプション1：Webhookツール（推奨） ### Odooのバージョンを確認する Odooのバージョンは、**設定** ページの下部に表示されます。Webhookツールにはバージョン19以降が必要です。セルフホスト型データベースの場合、インターネットからHTTPS経由でサーバーにアクセスできる必要があります。 ### Reception.ai用のユーザーを作成する **設定** → **ユーザーと企業** → **ユーザー** で、Reception.ai用の内部ユーザーを作成します。**販売**：**ユーザー：すべてのドキュメント** のアクセス権を付与し、他のアプリにはアクセスできないようにします。これにより、APIキーで実行できる操作をツールに必要なものだけに制限できます。**ユーザー：すべてのドキュメント** の権限があれば、選択した営業担当者に新しいリードを割り当てられます。 ### APIキーを作成する 管理者以外のユーザー用APIキーの有効期間は、最長3か月です。1年間有効なキーを取得するには、次の手順に従います。 1. 管理者として開発者モードを有効にし、**設定** → **ユーザーと企業** → **グループ** に移動します。 2. たとえば`Reception.ai API key`という名前のグループを作成し、**APIキーの最長有効日数** を`365`に設定して、Reception.aiユーザーを追加します。 次に、Reception.aiユーザーとしてサインインし、**環境設定** → **アカウントセキュリティ** を開いて、**新しいAPIキー** を選択します。たとえば`Reception.ai`という名前を付け、選択可能な最長の有効期間を選び、すぐにキーをコピーしてください。Odooでキーが表示されるのは一度だけです。有効期限を控え、期限を迎える前にキーを交換してください。 > **Warning** > > APIキーでは、Reception.aiユーザーが実行できるすべての操作が可能です。共有ドキュメントには記載せず、 > 漏えいした場合はOdooで削除してください。 ### 営業担当者と営業チームのIDを確認する **設定** → **ユーザーと企業** → **ユーザー** で営業担当者のユーザーページを開きます。ページアドレスの末尾にある数字がユーザーIDです。**CRM** → **設定** → **営業チーム** で、営業チームについても同じように確認します。 ### Webhookツールを作成する [以下の各ツール](#find-the-caller)について、**インテグレーション** に移動し、**インテグレーションを追加** を選択して、**Webhookツール** を選びます。`YOUR_ODOO_ADDRESS`をデータベースのアドレス（例：`mycompany.odoo.com`）に置き換えてください。 すべてのツールで、同じリクエストヘッダーを送信します。 * `Authorization`（シークレット）：`Bearer `の後にAPIキーを指定 * `X-Odoo-Database`（値）：データベース名。自社サーバーで複数のデータベースをホストしている場合にのみ必要です。 ### 発信者を検索する | フィールド | 値 | | ---------------- | ------------------------------------------------------------------------------------------------- | | **名前** | `find_odoo_contact` | | **説明** | 「発信者のメールアドレスで連絡先を検索します。メールアドレスがない場合は氏名で検索します。リードを追加する前に使用してください。」 | | **メソッド** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search` | | **リクエストヘッダー** | `Authorization`（シークレット）：`Bearer `の後にAPIキーを指定 `X-Odoo-Database`（値）：必要な場合のみデータベース名を指定 | | **本文パラメーター** | `name`（文字列、必須）：「発信者のメールアドレス、または発信者が伝えたとおりの氏名。」 `operator`（文字列、固定値）：`=ilike` `limit`（整数、固定値）：`5` | | **エージェントへの割り当て** | **受付担当** | `=ilike`演算子は、大文字と小文字を区別せずに名前またはメールアドレス全体と照合するため、「Jane」と検索しても、Janeという名前の人がすべて表示されることはありません。Odooから返されるのは、各一致項目のIDと名前のみです。Odooの連絡先検索では電話番号を検索できないため、受付担当はメールアドレスまたは名前を尋ねる必要があります。 ### 発信者をリードとして追加する | フィールド | 値 | | ---------------- | ------------------------------------------------------------------------------------ | | **名前** | `create_odoo_lead` | | **説明** | 「見積もりまたは折り返しの連絡を希望する発信者を、CRMにリードとして追加します。」 | | **メソッド** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create` | | **リクエストヘッダー** | `Authorization`（シークレット）：`Bearer `の後にAPIキーを指定 `X-Odoo-Database`（値）：必要な場合のみデータベース名を指定 | | **本文パラメーター** | `vals_list`（オブジェクト、必須）。以下のフィールドを含みます | | **エージェントへの割り当て** | **受付担当** | Odooでは、新しいリードのフィールドを`vals_list`オブジェクト内に含める必要があります。以下の各項目について、`vals_list`で **フィールドを追加** を選択します。 * `name`（文字列、必須、会話から取得）：「リードのタイトル。例：キッチンの見積もり - Jane Doe。」 * `contact_name`（文字列、必須、会話から取得）：「発信者の氏名。」 * `email_from`（文字列、会話から取得）：「発信者が伝えた場合は、そのメールアドレス。」 * `phone`（文字列、必須、会話から取得）：「発信者の電話番号を国際形式で指定。例：+14155550123。」 * `description`（文字列、必須、会話から取得）：「発信者の要件を数文で記載。」 * `user_id`（整数、固定値）：営業担当者のユーザーID * `team_id`（整数、固定値）：営業チームのID 営業担当者とチームは固定値のため、AIが別のIDを送信しても、すべてのリードが指定した担当者とチームに割り当てられます。受付担当が金額を推測しないよう、見込み売上などのフィールドは含めないでください。 各ツールで **有効化** を選択します。次に、メールアドレスを伝える既存の連絡先として[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)し、その後、見積もりを依頼する新規の発信者としてテストします。新しいリードがOdoo CRMのパイプラインに表示されます。 ## オプション2：Zapier ### Zapierを接続する まだ接続していない場合は、Reception.aiで[Zapier](/docs/ja/reception-ai/integrations/zapier)を接続します。 ### Odooのアクションを追加する [mcp.zapier.com](https://mcp.zapier.com)にあるZapier MCPサーバーで、**Odoo CRM** アプリから[以下のアクション](#zapier-actions)を追加し、Zapierに求められたらOdooへサインインします。各フィールドには、以下の説明に従って固定値を設定するか、AIによる入力を許可します。 **Odoo CRM** アプリは、odoo.comでホストされているデータベースに対応しています。セルフホスト型データベースについては、[制限事項](#limitations)を参照してください。 アクションでは、サインインに使用したOdooユーザーが実行できるすべての操作が可能です。CRMと連絡先のみにアクセスできる専用ユーザーの使用を検討してください。 ### ツールを割り当てる Reception.aiでZapierインテグレーションの **ツール** タブを開き、**ツールを更新** を選択して、各アクションを **クライアント**（受付担当）に割り当てます。 ### テストする メールアドレスを伝える既存の連絡先として[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)し、その後、見積もりを依頼する新規の発信者としてテストします。新しいリードがOdoo CRMのパイプラインに表示されます。 ### Zapierのアクション #### 発信者を検索する | フィールド | 値 | | --------------- | ---------------------------- | | **Zapierアクション** | **連絡先を検索** | | **Zapierで設定** | なし。 | | **AIに入力させる項目** | 発信者のメールアドレス。メールアドレスがない場合は氏名。 | | **割り当て先** | **クライアント** | OdooのZapierアプリは、電話番号ではなく名前またはメールアドレスで連絡先を検索します。そのため、受付担当はいずれかを尋ねる必要があります。 #### 発信者をリードとして追加する | フィールド | 値 | | --------------- | ----------------------------------------------------------------- | | **Zapierアクション** | **リードを作成** | | **Zapierで設定** | アカウントにこれらのフィールドが表示される場合は、新しいリードの割り当て先となる営業担当者と営業チーム。 | | **AIに入力させる項目** | リードのタイトル（例：「キッチンの見積もり - Jane Doe」）、連絡先の名前、メールアドレス、電話番号、発信者の要件の説明。 | | **割り当て先** | **クライアント** | 受付担当が金額を推測しないよう、見込み売上などのフィールドは空欄にしてください。 > **Tip** > > どちらの方法を使用する場合も、[手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加し、 > リードを作成する前に、受付担当が発信者のメールアドレスを尋ねて検索するようにしてください。 > **Warning** > > 検索では、発信者ではない連絡先が返されることがあります。また、Zapierの **連絡先を検索** は、 > その連絡先に保存されている情報を返します。 > [ルール](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加し、受付担当が連絡先の詳細を > 発信者に読み上げることがないようにし、発信者の識別にのみ使用するよう指示してください。 ## 制限事項 * 受付担当は電話番号で発信者を検索できません。メールアドレスまたは正確な名前が必要です。 * 発信者の要件はリードの説明に保存されます。Zapierの **Odoo CRM** アプリには、メモの追加や通話の記録を行うアクションがありません。 * Webhookツールでは、APIキーに有効期限があります。期限までに交換しないと、ツールが動作しなくなります。 * Zapierでセルフホスト型のOdooデータベースを使用する場合は、代わりにZapierの **Odoo ERP Self Hosted** アプリが必要です。このアプリの **リード／商談を作成** アクションではリードを追加できますが、検索アクションがないため、再度電話してきた発信者が重複して追加される可能性があります。Webhookツールでは、Odoo 19以降のセルフホスト型データベースを検索できます。 * 受付担当はOdooで空き状況を確認したり、ミーティングを予約したりできません。代わりに、[Googleカレンダー](/docs/ja/reception-ai/integrations/google-calendar)を使ったReception独自の予約機能を使用してください。 * Zapierでは、受付担当が実行する各アクションによってZapierプランのタスクが消費されます。現在、Zapierでは成功した通話1件につき2タスクとしてカウントされます。失敗した通話はカウントされません。プランのタスクを使い切ると、リセットされるまでアクションは停止します。 ## トラブルシューティング | 問題 | 確認事項 | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | Odooから401が返される | ヘッダーは`Authorization`とし、`Bearer `、半角スペース、キーの順に指定する必要があります。キーの有効期限が切れていないか、削除されていないかを確認してください。 | | Odooから404が返される | アドレスと、URLの末尾が`/json/2/res.partner/name_search`または`/json/2/crm.lead/create`になっていることを確認してください。データベースはOdoo 19以降で動作し、CRMがインストールされている必要があります。 | | Odooからアクセスエラーが返される | Reception.aiユーザーには、**販売**：**ユーザー：すべてのドキュメント** のアクセス権が必要です。 | | Odooでデータベースが見つからない | データベース名を指定した`X-Odoo-Database`ヘッダーを追加してください。 | | OdooのアクションがReception.aiに表示されない | Zapierでアクションを追加した後、Zapierインテグレーションで **ツールを更新** を選択してください。 | | アクションに **変更済み** と表示され、使用されない | Zapierでアクションを編集したためです。**ツール** タブで **更新** を選択してください。 | | ZapierからOdooに接続できない | Odooのプランで外部アプリが許可されていることと、データベースのホスト先に適したアプリを使用していることを確認してください。 | | 既知の発信者が見つからない | 発信者とメールアドレスのスペルを確認してください。名前で検索する場合は、Odooに保存されているとおりの名前が必要です。企業に所属する連絡先は、企業名、カンマ、個人名の順で保存されています。 | | リードが誤った営業担当者またはチームに割り当てられる | WebhookツールまたはZapierで、営業担当者と営業チームを固定値として設定してください。 |