顧客プロファイルとチケット
顧客プロファイルを照会・同期し、お使いのシステムからチケットを作成できます。
4.4 顧客プロフィール
同じ顧客の会話は1つの顧客プロフィールにまとめられ、会話内の contact_id がそのプロフィールを指します。識別ルール：署名付きの会員ID（user_token または API で渡す user.id）> チャネルユーザー（WeChat の openid など）> Web サイトの訪問者。匿名の訪問者がログインすると会員のプロフィールに統合されます。2人の異なる会員が自動的に統合されることはなく、メールアドレスや電話番号が一致する場合は管理画面で通知されるだけなので、オペレーターが手動で統合します。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /v1/contacts?user_id= または ?email= | 会員IDまたはメールアドレスで顧客プロフィールを検索 |
| GET | /v1/contacts/{id} | 顧客プロフィール：氏名、メールアドレス、電話番号、タグ tags、メモ notes、カスタムフィールド attributes、会話数、最終訪問日時、会員ID user_ids |
| PATCH | /v1/contacts/{id} | お客様のシステムから情報を同期：name、phone、tags（最大30個）、notes、attributes（完全置き換え、最大30フィールド）。変更したいフィールドのみ送信してください |
4.5 チケット
| メソッド | パス | 説明 |
|---|---|---|
| POST | /v1/tickets | チケットを作成します。例えば Web サイトの「お問い合わせ」フォームから：subject、description、priority（urgent / high / normal / low）、顧客の name / email / phone。任意で conversation_id または contact_id を関連付けられます。メールアドレスがある場合、オペレーターの返信は顧客にメールで送信されます |
| GET | /v1/tickets/{id} | チケットとタイムライン（顧客のメッセージ、オペレーターの返信、ステータス変更。内部メモは含みません） |
チケットステータス：open 対応待ち、pending 顧客の返信待ち、resolved 解決済み、closed クローズ済み。対応期限は優先度ごとに「ボット設定」で設定します。
このページは役に立ちましたか?
最終更新:
