外部CRM経由のカード作成の自動化

外部CRM経由のカード作成の自動化

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

シナリオ

ある会社では、Zoho CRMやSalesforceなどの外部CRMを使用して見込み客を収集しています。見込み客が条件を満たすたびに、CRMはQntrlのプロセス管理システムにタスクカードを自動作成し、社内のフォローアップ対応を開始する必要があります。Qntrlでタスクを手動作成する代わりに、外部システムからQntrlのInbound REST APIを呼び出すことで、これを自動化できます。

仕組み  

  • CRMはQntrlのInbound REST APIにPOST要求を送信します。
  • このAPIは、データを受信し、ワークフロー（例：営業フォローアップ）にカードを作成するようQntrlで設定されます。
  • このAPIにより、名前、メール、関心度などの見込み客情報がQntrlに渡されます。
  • Qntrlの関数がデータを処理し、適切な詳細情報と担当者を設定したカードを作成します。
  • 運用チームに通知され、すぐに対応できます。

 

ビジネス効果

✅見込み客対応の迅速化：手動でタスクを作成する必要がなく、カードがすぐに表示されます。

✅ミスのないタスク作成：CRMからQntrlへ見込み客データが正確に渡されます。

✅時間の節約：定型的な手順を自動化し、チームが重要なタスクに集中できるようにします。

✅連携の向上：リアルタイムの更新により、営業チームと運用チームの足並みをそろえられます。

✅拡張性と安全性の確保：大量の要求を処理し、トークンまたはOAuthによる認証に対応します。

 

Inbound REST Webサービスの設定手順   

タブの作成

関連するAPIの各セットは、タブに属している必要があります。
  1. 次の順に（［設定］）→［WEBサービス］→［Inbound］に移動し、［REST］を選択します。
  2. ［新しいInbound REST］をクリックします。
  3. 以下を入力します。
    • ［名前］：見込み客管理
    • ［ベースURI］：/lead
    • ［認証の種類］：APIキー（必要に応じてOAuth）
    • ［説明］：「CRMからフォローアップカードを作成するAPI要求を処理します」
  1. ［作成］をクリックします。
タブを作成すると、APIエンドポイントを定義する設定画面が開きます。
 

APIエンドポイントの設定  

  1. ［名前］：カードの作成
  2. ［URL］：/create
  3. ［メソッド］：POST
  4. ［リソースの種類］：関数
  5. ［リソース］：入力パラメーターを使用してカード作成ロジックを処理する関数を選択または作成します。
 

要求コンポーネントの設定  

  • 要求パラメーター：

    • lead_name（文字列、必須）

    • メール（文字列、正規表現による検証、必須）

    • priority（文字列、任意）

  • 要求ヘッダー：

    • X-CRM-ID（文字列、必須）

  • 要求本文：

    • ［Raw］を選択し、JSONを想定します：

{
'lead_name': 'Alice',
'メール': 'alice@company.com',
'priority': 'High'
}

  • レート制限ポリシー：

    • ポリシーを追加または選択します：「IPごとに1分あたり100件の要求」

［保存］をクリックして、設定を完了します。

 

保存と公開  

  • ［保存］をクリックして、エンドポイントを有効にします。
  • エンドポイントと認証トークンをCRMシステムと共有します。
  • これで、CRMは次のURLにHTTP POST要求を送信できます：
     
https://core.qntrl.com/webservice/<org-id>/lead/create

 

CRMでの使用例  

以下は、CRMからQntrlにInbound REST要求をPOSTメソッドとJSONペイロードを使用して送信する例です。

エンドポイント：

POST https://<org>.qntrl.com/webservice/668909960/lead/create

Headers:
Content-Type: application/json
X-CRM-ID: your-api-key

本文： 
{
'lead_name': 'Alice',
'メール': 'alice@company.com',
'priority': 'Medium'
}