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

ERPNext

発信者を識別し、新しい発信者を営業チーム向けのERPNextリードとして登録します。

以下のWebhookツールを使うと、受付担当者は、すでにERPNextのリードとして登録されている発信者を認識し、新しい発信者を名前、電話番号、用件のメモとともにリードとして登録できます。また、既存のリードにコメントを残し、営業チームが折り返し連絡できるようにします。ERPNextとFrappeフレームワークは、固定のAPIキーとシークレット、およびJSONリクエスト本文に対応しているため、Frappe Cloudとセルフホストサイトの両方で利用できます。

はじめる前に

1

APIユーザーを作成する

ERPNextでReception.ai用のユーザー(例:reception@yourcompany.com)を作成し、営業ユーザー ロールのみを付与します。APIリクエストはこのユーザーの権限で実行されるため、管理者は使用しないでください。

2

キーを生成する

ユーザーを開き、設定 タブを選択して、APIアクセス を展開し、キーを生成 を選択します。ポップアップに表示される APIシークレット をすぐにコピーしてください。ERPNextに表示されるのは一度だけです。APIキー は同じセクションに引き続き表示されます。

以下の各ツールは、Authorization という名前のリクエストヘッダーを、token API_KEY:API_SECRET という値で送信します。キーとシークレットはコロンで連結します。その タイプ を シークレット に設定してください。

キーとシークレットを使うと、営業ユーザー ロールで許可されているすべてのデータを読み取り、変更できます。 共有ドキュメントには記載せず、漏洩した場合はもう一度 キーを生成 を選択して置き換えてください。

3

サイトのアドレスを確認する

ツールのURLは、ERPNextを使用するときにブラウザで開くアドレスから始まります。以下の表ではhttps://YOUR-SITE.example.comを使用しています。ご自身のアドレスに置き換えてください。

ツールを作成する

ツールごとに インテグレーション に移動し、インテグレーションを追加 を選択して、Webhookツール を選びます。次に、エージェントに割り当て を 受付担当者 に設定します。以下で「常に」と記載されている各パラメーターの 値 を 固定値 に設定してください。

リードを検索する

フィールド値
名前find_erpnext_lead
説明「電話番号で発信者をリードから検索します。通話の開始時に使用し、以前に問い合わせたことがあるか確認してください。」
メソッドGET
URLhttps://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
URLhttps://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
URLhttps://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。

各ツールで 有効化 を選択し、折り返しを依頼する新規発信者として受付担当者をテストします。リードが リード リストに表示され、営業担当者がオーナーとして設定され、受付担当者のコメントが追加されます。

発信者への対応を定める手順を追加してください。リードを検索し、 見つからなければメモ付きで登録し、見つかった場合はそのリードに通話の詳細を記録します。 受付担当者がリードのレコードを発信者に読み上げないよう、ルールを追加してください。

受付担当者は会話の内容から検索フィルターを作成するため、発信者が他人のリードを検索させようとする可能性があります。 ツールが返す名前とステータスは最大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など、既存のリード名にする必要があります。検索ツールまたは作成ツールが先に実行されたことを確認してください。