連絡先のインポート
既存のオーディエンスを Kagibagに取り込みます。 CSV ファイル、HubSpot エクスポート、または API から連絡先をインポートすると、システムがフィールド マッピング、重複排除、ID 解決を自動的に処理します。
ソースのインポート
| ソース | 仕組み | 最適 |
|---|---|---|
| CSV アップロード | 任意のアップロードCSV ファイルを作成し、列をブラウザーの連絡先フィールドにマップします。 | 1 回限りのインポート |
| HubSpot のエクスポート | HubSpot からエクスポートされた CSV をアップロードします。列ヘッダーは自動検出され、マッピングされます。 | HubSpot からの移行 |
| API インポート | MCPサーバーまたは REST API 経由で連絡先を JSON として送信します。 | 自動インポートまたは定期的なインポート |
CSV インポートの開始
「管理」、「連絡先」、「インポート」の順に移動します。 CSV ファイルをアップロードします。システムはファイルヘッダーを読み取り、列マッピング画面を表示します。各列は標準の連絡先フィールドにマッピングすることも、スキップすることもできます。 [インポート] をクリックして処理を開始します。
フィールド マッピング
マッピングに使用できる標準フィールド。列のエイリアス (「メール アドレス」や「名」など) は自動的に認識されます。
| フィールド | 必須 | 説明 |
|---|---|---|
| メール | はい | 連絡先のメール アドレス |
| first_name | いいえ | 姓または名 |
| last_name | いいえ | 姓または姓 |
| 会社 | いいえ | 組織または会社名 |
| 役職 | いいえ | 役職または役割 |
| 電話番号 | いいえ | 電話番号number |
インポート処理
インポートはバックグラウンドで非同期に実行されます。各行は個別に処理されるため、単一の不良行が残りをブロックすることはありません。
| ステータス | 説明 |
|---|---|
| アップロードされました | ファイルを受信し、開始を待機しています。 |
| 解析中 | システムは行を読み取り、検証しています。 |
| 処理中 | 行の照合、重複排除、および強化が行われています。 |
| 処理されました | すべての行が正常に処理されました。 |
| エラー | 1 つ以上の行が失敗しました — エラーの詳細を確認してください。 |
ID 解決
インポートされた各電子メールは正規化され (小文字にされ、空白が削除され)、既存の連絡先と照合されます。一致するものが見つかった場合、既存の連絡先プロファイルが新しい情報で更新されます。一致するものが存在しない場合は、新しい連絡先プロファイルが作成されます。これにより、同じリストを複数回インポートするときの重複が防止されます。
結果の確認
処理が完了すると、インポートの概要には、処理された合計行数、一致した既存の連絡先の数、新規作成された連絡先の数、およびエラーが発生した連絡先の数が表示されます。個々の行をクリックすると、エラーの詳細または解決された連絡先プロファイルが表示されます。
インポートされた連絡先の使用
一度インポートすると、連絡先はどこでも利用できるようになります鍵袋。
- 招待限定イベントの招待状を送信する
- 自動マーケティング キャンペーンに参加させる
- 対象ユーザーにセグメント化する
連絡先は、やり取りから得られる追加データによって時間の経過とともに強化されます。
API imports
MCPサーバーの import_contacts ツールを使用して、プログラムで連絡先をインポートします。 email、first_name、last_name、company、および title フィールドを含む連絡先オブジェクトの JSON 配列を送信します。 API は、インポート ID を含む 202 応答を返します。その ID を使用して check_import_statusをポーリングし、進行状況を追跡します。
[
{ "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company": "Acme" },
{ "email": "[email protected]"、"first_name": "John"、"last_name": "Smith" }
]