👥 コンタクト
コンタクトは PulseHub における顧客レコードです。すべての会話はコンタクトにリンクされ、すべての受信メッセージは既存のコンタクトに一致するか、新しいコンタクトを作成します。
コンタクトフィールド
| フィールド | 説明 |
|---|---|
name | 表示名 — プロバイダーデータから抽出または手動入力 |
email | メールアドレス — 受信メール送信者の照合に使用 |
phone | 電話番号 — WhatsApp および SMS 送信者の照合に使用 |
tags | セグメンテーション用のタグ文字列の JSON 配列 |
notes | エージェントのメモ用フリーテキストフィールド |
external_ids | チャネルタイプをプロバイダー固有の ID にマッピングする JSON オブジェクト |
コンタクトマッチング（自動重複排除）
新しい受信メッセージが到着した場合：
- sender_phone が存在する場合：
contacts.phoneで照合 - 上記以外で sender_email が存在する場合：
contacts.emailで照合 - 上記以外：
external_idsの JSON パスで照合 - 一致なし：新しいコンタクトを作成
一致が見つかった場合、PulseHub は external_ids フィールドを更新し、チャネル間で顧客を統合します。
タグ
- コンタクトタグは人物を説明します：
[vip, enterprise, newsletter] - 会話タグは問題を説明します：
[urgent, billing, bug-report]
両方とも JSON 配列として保存されます。
外部 ID リファレンス
| キー | ソース |
|---|---|
whatsapp | 送信者の電話番号 |
telegram_chat_id | Telegram chat.id |
viber | Viber sender.id |
facebook | Facebook PSID |
instagram | Instagram PSID |
sms | 送信者の電話番号 |