> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # ERPNext 以下の[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、受付担当者は、すでにERPNextのリードとして登録されている発信者を認識し、新しい発信者を名前、電話番号、用件のメモとともにリードとして登録できます。また、既存のリードにコメントを残し、営業チームが折り返し連絡できるようにします。ERPNextとFrappeフレームワークは、固定のAPIキーとシークレット、およびJSONリクエスト本文に対応しているため、Frappe Cloudとセルフホストサイトの両方で利用できます。 ## はじめる前に ### APIユーザーを作成する ERPNextでReception.ai用のユーザー（例：`reception@yourcompany.com`）を作成し、**営業ユーザー** ロールのみを付与します。APIリクエストはこのユーザーの権限で実行されるため、管理者は使用しないでください。 ### キーを生成する ユーザーを開き、**設定** タブを選択して、**APIアクセス** を展開し、**キーを生成** を選択します。ポップアップに表示される **APIシークレット** をすぐにコピーしてください。ERPNextに表示されるのは一度だけです。**APIキー** は同じセクションに引き続き表示されます。 以下の各ツールは、`Authorization` という名前のリクエストヘッダーを、`token API_KEY:API_SECRET` という値で送信します。キーとシークレットはコロンで連結します。その **タイプ** を **シークレット** に設定してください。 > **Warning** > > キーとシークレットを使うと、**営業ユーザー** ロールで許可されているすべてのデータを読み取り、変更できます。 > 共有ドキュメントには記載せず、漏洩した場合はもう一度 **キーを生成** を選択して置き換えてください。 ### サイトのアドレスを確認する ツールのURLは、ERPNextを使用するときにブラウザで開くアドレスから始まります。以下の表では`https://YOUR-SITE.example.com`を使用しています。ご自身のアドレスに置き換えてください。 ## ツールを作成する ツールごとに **インテグレーション** に移動し、**インテグレーションを追加** を選択して、**Webhookツール** を選びます。次に、**エージェントに割り当て** を **受付担当者** に設定します。以下で「常に」と記載されている各パラメーターの **値** を **固定値** に設定してください。 ### リードを検索する | フィールド | 値 | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **名前** | `find_erpnext_lead` | | **説明** | 「電話番号で発信者をリードから検索します。通話の開始時に使用し、以前に問い合わせたことがあるか確認してください。」 | | **メソッド** | GET | | **URL** | `https://YOUR-SITE.example.com/api/resource/Lead` | | **リクエストヘッダー** | `Authorization`: `token API_KEY:API_SECRET` | | **クエリパラメーター** | `or_filters`（文字列、必須）：「発信者の電話番号の末尾7桁を対象とするフィルター。`[["mobile_no","like","%5550123%"],["phone","like","%5550123%"]]`と完全に同じ形式にします。」 `fields`（文字列）：常に`["name","lead_name","status"]`。 `limit_page_length`（整数）：常に`5`。 | ### 新しいリードを登録する | フィールド | 値 | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **名前** | `create_erpnext_lead` | | **説明** | 「`find_erpnext_lead`で発信者が見つからなかった場合、その発信者を新しいリードとして登録します。」 | | **メソッド** | POST | | **URL** | `https://YOUR-SITE.example.com/api/resource/Lead` | | **リクエストヘッダー** | `Authorization`: `token API_KEY:API_SECRET` | | **本文パラメーター** | `first_name`（文字列、必須）：「発信者の名。」 `last_name`（文字列）：「発信者の姓。」 `mobile_no`（文字列、必須）：「国際形式の発信者の電話番号（例：+14155550123）。」 `email_id`（文字列）：「発信者から提供された場合、そのメールアドレス。」 `lead_owner`（文字列）：常に、新しいリードへ折り返し連絡する営業担当者のメールアドレス。 `notes`（配列）：以下を参照。 | リードの流入元を設定するには、**リードソース** レコードのいずれかと完全に一致する固定値として`source`（文字列）を追加します。ERPNext 16以降では、代わりに`utm_source`フィールドを使用し、**UTMソース** レコードと一致させる必要があります。 `notes`には、リードの **メモ** タブの内容が入力されます。説明を「発信者の用件を含む項目を1つだけ送信します。」に設定してください。**各項目** で`object`を選択し、以下の各項目について **フィールドを追加** を選択します。 * `note`（文字列、必須）：「発信者の用件と、折り返しを希望する時間。」 * `added_by`（文字列）：常にAPIユーザーのメールアドレス。 ### 通話の詳細を記録する | フィールド | 値 | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **名前** | `add_erpnext_lead_comment` | | **説明** | 「発信者のリードに用件をコメントとして残します。`find_erpnext_lead`で発信者が見つかった場合に、CRM-LEAD-2026-00012のようなリード名とともに使用してください。」 | | **メソッド** | POST | | **URL** | `https://YOUR-SITE.example.com/api/method/frappe.desk.form.utils.add_comment` | | **リクエストヘッダー** | `Authorization`: `token API_KEY:API_SECRET` | | **本文パラメーター** | `reference_doctype`（文字列）：常に`Lead`。 `reference_name`（文字列、必須）：「`find_erpnext_lead`または`create_erpnext_lead`から取得したリード名。」 `content`（文字列、必須）：「発信者の用件と、折り返しを希望する時間。」 `comment_email`（文字列）：常にAPIユーザーのメールアドレス。 `comment_by`（文字列）：常に`Reception.ai`。 | 各ツールで **有効化** を選択し、折り返しを依頼する新規発信者として[受付担当者をテスト](/docs/ja/reception-ai/receptionist/testing)します。リードが **リード** リストに表示され、営業担当者がオーナーとして設定され、受付担当者のコメントが追加されます。 > **Tip** > > 発信者への対応を定める[手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。リードを検索し、 > 見つからなければメモ付きで登録し、見つかった場合はそのリードに通話の詳細を記録します。 > 受付担当者がリードのレコードを発信者に読み上げないよう、ルールを追加してください。 > **Warning** > > 受付担当者は会話の内容から検索フィルターを作成するため、発信者が他人のリードを検索させようとする可能性があります。 > ツールが返す名前とステータスは最大5件ですが、上記のルールは必ず維持してください。**営業ユーザー** で顧客や > 見積もりなど、必要以上のアクセス権が付与される場合は、リードの読み取り、作成、コメントのみが可能なカスタムロールを作成してください。 ## 制限事項 * 検索では電話番号の末尾7桁を使用します。この7桁の中にスペースやハイフンが含まれている番号は見つかりません。また、複数の発信者で末尾7桁が同じ場合があります。 * この設定で対応するのはリードのみです。受付担当者は連絡先や顧客を検索せず、商談も作成しません。 ## トラブルシューティング | 問題 | 確認事項 | | ----------------------- | ------------------------------------------------------------------------------------------------------------------ | | ERPNextから401または403が返される | ヘッダー値は`token`、スペース、コロンで連結したキーとシークレットの順にする必要があります。ユーザーが有効で、**営業ユーザー** ロールを持っていることを確認してください。 | | 既知の発信者が見つからない | 電話番号はスペースやハイフンなしで保存し、リードの **携帯電話番号** または **電話番号** フィールドに番号が登録されていることを確認してください。 | | リードのオーナーまたは流入元に関するエラー | `lead_owner`は有効なユーザーのメールアドレスにする必要があり、`source`は **リードソース** と完全に一致する必要があります（ERPNext 16以降では`utm_source`と **UTMソース**）。 | | 電話番号に関するエラー | ERPNextは電話番号を検証します。数字のみ、または先頭に`+`を付けた数字のみを送信するよう、受付担当者に指示してください。 | | `added_by`に関するエラー | `notes`内の`added_by`は、APIユーザーなど、有効なユーザーのメールアドレスにする必要があります。 | | コメントが追加されない | `reference_name`は`CRM-LEAD-2026-00012`など、既存のリード名にする必要があります。検索ツールまたは作成ツールが先に実行されたことを確認してください。 |