ナビゲーションにスキップ

Odoo

Odooの連絡先から発信者を検索し、新規の発信者をCRMのリードとして追加します。

受付担当は、発信者がすでにOdooの連絡先に登録されているかを確認できます。新規の発信者については、要件とともにOdoo CRMへリードとして追加し、営業チームがフォローアップできるようにします。接続方法は2つあります。

  • Webhookツール はOdooのJSON-2 APIを直接呼び出すため、ZapierアカウントやZapierタスクを使用しません。Odoo 19以降のCommunityまたはEnterpriseが必要で、odoo.com、Odoo.sh、または自社サーバーでホストされている必要があります。
  • Zapier は古いバージョンのOdooにも対応していますが、アクションごとにZapierプランのタスクを消費し、セルフホスト型データベースは検索できません。

データベースがOdoo 19以降で動作している場合は、Webhookツールを使用してください。Odooの旧APIであるJSON-RPCでは、各メソッドの引数をさまざまな値が混在した1つのリストとして渡します。Webhookツールではこのリストを作成できないため、古いバージョンではZapierを使用してください。

Odooで外部アプリからデータにアクセスできるのは、カスタム プランのみです。データベースが Odooによってホストされ、One App FreeまたはStandardプランを利用している場合は、開始前にプランを確認してください。

オプション1:Webhookツール(推奨)

1

Odooのバージョンを確認する

Odooのバージョンは、設定 ページの下部に表示されます。Webhookツールにはバージョン19以降が必要です。セルフホスト型データベースの場合、インターネットからHTTPS経由でサーバーにアクセスできる必要があります。

2

Reception.ai用のユーザーを作成する

設定 → ユーザーと企業 → ユーザー で、Reception.ai用の内部ユーザーを作成します。販売:ユーザー:すべてのドキュメント のアクセス権を付与し、他のアプリにはアクセスできないようにします。これにより、APIキーで実行できる操作をツールに必要なものだけに制限できます。ユーザー:すべてのドキュメント の権限があれば、選択した営業担当者に新しいリードを割り当てられます。

3

APIキーを作成する

管理者以外のユーザー用APIキーの有効期間は、最長3か月です。1年間有効なキーを取得するには、次の手順に従います。

  1. 管理者として開発者モードを有効にし、設定 → ユーザーと企業 → グループ に移動します。
  2. たとえばReception.ai API keyという名前のグループを作成し、APIキーの最長有効日数 を365に設定して、Reception.aiユーザーを追加します。

次に、Reception.aiユーザーとしてサインインし、環境設定 → アカウントセキュリティ を開いて、新しいAPIキー を選択します。たとえばReception.aiという名前を付け、選択可能な最長の有効期間を選び、すぐにキーをコピーしてください。Odooでキーが表示されるのは一度だけです。有効期限を控え、期限を迎える前にキーを交換してください。

APIキーでは、Reception.aiユーザーが実行できるすべての操作が可能です。共有ドキュメントには記載せず、 漏えいした場合はOdooで削除してください。

4

営業担当者と営業チームのIDを確認する

設定 → ユーザーと企業 → ユーザー で営業担当者のユーザーページを開きます。ページアドレスの末尾にある数字がユーザーIDです。CRM → 設定 → 営業チーム で、営業チームについても同じように確認します。

5

Webhookツールを作成する

以下の各ツールについて、インテグレーション に移動し、インテグレーションを追加 を選択して、Webhookツール を選びます。YOUR_ODOO_ADDRESSをデータベースのアドレス(例:mycompany.odoo.com)に置き換えてください。

すべてのツールで、同じリクエストヘッダーを送信します。

  • Authorization(シークレット):Bearer の後にAPIキーを指定
  • X-Odoo-Database(値):データベース名。自社サーバーで複数のデータベースをホストしている場合にのみ必要です。

発信者を検索する

フィールド値
名前find_odoo_contact
説明「発信者のメールアドレスで連絡先を検索します。メールアドレスがない場合は氏名で検索します。リードを追加する前に使用してください。」
メソッドPOST
URLhttps://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
URLhttps://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を送信しても、すべてのリードが指定した担当者とチームに割り当てられます。受付担当が金額を推測しないよう、見込み売上などのフィールドは含めないでください。

各ツールで 有効化 を選択します。次に、メールアドレスを伝える既存の連絡先として受付担当をテストし、その後、見積もりを依頼する新規の発信者としてテストします。新しいリードがOdoo CRMのパイプラインに表示されます。

オプション2:Zapier

1

Zapierを接続する

まだ接続していない場合は、Reception.aiでZapierを接続します。

2

Odooのアクションを追加する

mcp.zapier.comにあるZapier MCPサーバーで、Odoo CRM アプリから以下のアクションを追加し、Zapierに求められたらOdooへサインインします。各フィールドには、以下の説明に従って固定値を設定するか、AIによる入力を許可します。

Odoo CRM アプリは、odoo.comでホストされているデータベースに対応しています。セルフホスト型データベースについては、制限事項を参照してください。

アクションでは、サインインに使用したOdooユーザーが実行できるすべての操作が可能です。CRMと連絡先のみにアクセスできる専用ユーザーの使用を検討してください。

3

ツールを割り当てる

Reception.aiでZapierインテグレーションの ツール タブを開き、ツールを更新 を選択して、各アクションを クライアント(受付担当)に割り当てます。

4

テストする

メールアドレスを伝える既存の連絡先として受付担当をテストし、その後、見積もりを依頼する新規の発信者としてテストします。新しいリードがOdoo CRMのパイプラインに表示されます。

Zapierのアクション

発信者を検索する

フィールド値
Zapierアクション連絡先を検索
Zapierで設定なし。
AIに入力させる項目発信者のメールアドレス。メールアドレスがない場合は氏名。
割り当て先クライアント

OdooのZapierアプリは、電話番号ではなく名前またはメールアドレスで連絡先を検索します。そのため、受付担当はいずれかを尋ねる必要があります。

発信者をリードとして追加する

フィールド値
Zapierアクションリードを作成
Zapierで設定アカウントにこれらのフィールドが表示される場合は、新しいリードの割り当て先となる営業担当者と営業チーム。
AIに入力させる項目リードのタイトル(例:「キッチンの見積もり - Jane Doe」)、連絡先の名前、メールアドレス、電話番号、発信者の要件の説明。
割り当て先クライアント

受付担当が金額を推測しないよう、見込み売上などのフィールドは空欄にしてください。

どちらの方法を使用する場合も、手順を追加し、 リードを作成する前に、受付担当が発信者のメールアドレスを尋ねて検索するようにしてください。

検索では、発信者ではない連絡先が返されることがあります。また、Zapierの 連絡先を検索 は、 その連絡先に保存されている情報を返します。 ルールを追加し、受付担当が連絡先の詳細を 発信者に読み上げることがないようにし、発信者の識別にのみ使用するよう指示してください。

制限事項

  • 受付担当は電話番号で発信者を検索できません。メールアドレスまたは正確な名前が必要です。
  • 発信者の要件はリードの説明に保存されます。Zapierの Odoo CRM アプリには、メモの追加や通話の記録を行うアクションがありません。
  • Webhookツールでは、APIキーに有効期限があります。期限までに交換しないと、ツールが動作しなくなります。
  • Zapierでセルフホスト型のOdooデータベースを使用する場合は、代わりにZapierの Odoo ERP Self Hosted アプリが必要です。このアプリの リード/商談を作成 アクションではリードを追加できますが、検索アクションがないため、再度電話してきた発信者が重複して追加される可能性があります。Webhookツールでは、Odoo 19以降のセルフホスト型データベースを検索できます。
  • 受付担当はOdooで空き状況を確認したり、ミーティングを予約したりできません。代わりに、Googleカレンダーを使った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で、営業担当者と営業チームを固定値として設定してください。