データエンリッチメント(汎用コネクタ)
お好みのエンリッチメントプロバイダー(Clearbit、Apollo、Hunter、People Data Labsなど)を指定し、企業と連絡先の空欄のフィールドを自動的に埋めます。
データエンリッチメントは汎用的で中立的なコネクタです。お好みのエンリッチメントプロバイダー(Clearbit、Apollo、Hunter、People Data Labsなど)のアカウントを使用します。プロバイダーのアドレス、認証方法、フィールドマッピングを指定すると、CRMがプロバイダーに問い合わせ、レコードの空欄フィールドのみを埋めます。当社側でのコストはなく、アカウントと課金は選択したプロバイダーに帰属します。
このコネクタは無効な状態で始まります。設定するまで何も起こりません。指定したAPIキーは暗号化して保存され、再表示されることはありません。
前提条件
- 有効なAPIキーと十分なクレジット/プランを持つ、エンリッチメントプロバイダー(Clearbit、Apollo、Hunter、People Data Labsなど)のアカウント。
- そのプロバイダーのAPIドキュメント(エンドポイント、認証ヘッダー(例:Authorization: Bearer、またはX-Api-Key)、レスポンスJSONの構造。マッピングを組み立てるために必要です)。
- Sellioにおいて、設定 → 連携でコネクタを保存できる管理者アクセス権。
プロバイダー側での手順
- エンリッチメントプロバイダーのダッシュボードにサインインし、API/開発者向けエリアを見つけます。
- APIキーを生成する(またはコピーする)。
- ドメインおよび/またはメールアドレスによる問い合わせエンドポイントと、必要な認証ヘッダーの正確な形式をメモします。プロバイダーごとに異なります。
設定方法
- 設定 → 連携を開き、「データエンリッチメント」カードに移動します。
- エンドポイント(URL):{domain}および/または{email}プレースホルダーを使ってプロバイダーのアドレスを貼り付けます。CRMは{domain}をレコードのドメイン(ウェブサイト/ドメイン、またはメールアドレスのドメインから)に、{email}をレコードのメールアドレスに置き換えます。
- 認証ヘッダーとプレフィックス:ヘッダー名(例:Authorization)とプレフィックスの値(例:スペース付きの「Bearer 」)を入力します。プロバイダーによっては、プレフィックスなしでX-Api-Keyなどの独自ヘッダーを使用します。
- APIキー:プロバイダーのキーを貼り付けます。暗号化して保存されます。
- フィールドマッピング:各行は、プロバイダーのレスポンス内のパス(左側)とCRMのフィールド(右側)を結び付けます。必要なだけ行を追加できます。
- コネクタを保存します。その後、企業または連絡先の詳細画面で「エンリッチ」ボタンを使用します。
マッピングの組み立て方
左側は、プロバイダーのJSONレスポンス内の値へのパスで、ドット記法で階層を下ります(リストの位置には数字を使用)。右側は、値を受け取るCRMフィールドのapi_nameです。「空欄」のフィールドのみが埋められ、レコードにすでに入力済みのデータが上書きされることはありません。
エンリッチするには、レコードに少なくともウェブサイト/ドメインまたはメールアドレスが必要です。問い合わせの{domain}/{email}はそこから取得されるためです。企業は通常ウェブサイトを持ち、連絡先やリードはメールアドレスを持っています。
独自のプロバイダーがない場合:システムモードとシミュレーションモード
独自のプロバイダーを設定しない場合でも、「エンリッチ」ボタンは利用可能です。Sellioでシステムプロバイダーが有効になっている場合、各エンリッチメントは標準的な企業属性フィールド(従業員数、売上高、業種、使用技術、LinkedIn、国)を埋め、レコードごとに1クレジットを使用し、請求書に透明性を持って計上されます。プロバイダーが全くない場合、CRMはシミュレーションされたサンプルデータ(コストなし)を使用し、フローを試すのに便利です。連携カードには現在有効なモードが表示されます。
一括および自動エンリッチメント
- 一括:企業、連絡先、リードの一覧で複数のレコードを選択し、アクションバーの「エンリッチ」をクリックします。CRMはすべてを一度にエンリッチし、空欄のフィールドのみを埋めます。
- 作成時の自動実行:設定 → 連携で「レコード作成時に自動エンリッチ」を有効にします。新しい企業、連絡先、リードはすべて、作成と同時に空欄フィールドが埋められます。
- 日次の追いつき処理:自動ルーチンが、このオプションが有効なテナントの最近のレコードを確認し、保留中の項目を日次の上限内で完了させます。同じレコードを再処理しても、二重に課金されることはありません。
テスト方法
- ウェブサイト/ドメインがある(または連絡先の場合はメールアドレスがある)企業で、フィールドが部分的に空欄のものを開きます。
- 「エンリッチ」をクリックします。
- マッピングに従って空欄フィールドが埋まったことを確認します。JSONパスを検証するため、プロバイダーの想定レスポンスと比較してください。
トラブルシューティング
- プロバイダーから401/403:APIキーが間違っている/期限切れであるか、認証ヘッダーが正しくありません。ヘッダー名とプレフィックス(例:スペース付きの「Bearer 」)を確認し、キーを貼り直してください。
- 何も埋まらない:マッピングのパスがプロバイダーの実際のJSONと一致しているか確認してください(階層を下るにはドット、リストにはインデックスを使用します。例:contacts.0.email)。フィールドに収まるのは単純な値(テキスト/数値)のみで、オブジェクト/リスト全体は無視されます。
- プロバイダーがデータを返しているのに一部のフィールドが更新されない:エンリッチメントは「空欄」のフィールドにのみ書き込みます。すでに値が入っているフィールドは、仕様として保持されます。
- 「エンリッチ」ボタンが何も反応しない:レコードにウェブサイト/ドメインまたはメールアドレスがあること(問い合わせは{domain}/{email}を使用します)、エンドポイントがそれらのプレースホルダーを使用していることを確認してください。
- 404/無効なエンドポイント:エンドポイントURLと、プロバイダーが問い合わせでドメインとメールアドレスのどちらを想定しているかを確認してください。