チャット専用URLで訪問者属性を指定する方法(URLパラメータ)
ChatPlusでは、JavaScriptタグを使用せずにチャットを利用できる、チャット専用URLを用意しています。
直接リンクとして利用したり、iframeで埋め込む場合に最適です。
またチャット専用URLをQRコード化して、パンフレットや説明書などに印刷して活用もできます。
1.チャット専用ページのURL
基本的なチャット専用URLの形式は以下の通りです。
https://app.chatplus.jp/chat/visitor/契約キー_サイトID?t=btn
※詳しくは、「チャット専用ページのURLを取得する方法」をご覧ください。
2.訪問者属性の設定
チャット専用URLにパラメータを追加することで、訪問者の属性情報を事前に設定できます。
設定に利用できるパラメータは pp と pf の2種類です。
● pp(基本属性)
ChatPlus があらかじめ定義している 標準の属性キーを設定するパラメータです。
メールアドレス・名前・会社名・電話番号など、サービス側で固定されたキー名を使用します。
詳細は後述の2-2.設定可能な訪問者属性(ppパラメータ)をご覧ください。
● pf(独自属性)
ユーザー側で自由にキー名を指定し、任意の属性(オリジナル項目)を追加できるパラメータです。
顧客タイプ・エリア・都道府県など、独自の分類を設定したい場合に使用します。
詳細は後述の2-3.独自の属性設定(pfパラメータ)をご覧ください。
2-1.使用例
https://app.chatplus.jp/chat/visitor/********_*?t=btn&pp={"chatCompanyName":"チャットプラス"}&pf={"lastName":"山田","firstName":"太郎"}
※URLエンコードする際は、{}内のみ行ってください。
https://app.chatplus.jp/chat/visitor/********_*?t=btn及び、&pp=、pf=の箇所はエンコードしないでください。
2-2.設定可能な訪問者属性(ppパラメータ)
| 項目名 | パラメーター | 型 | 説明 |
| 外部キー | externalKey | String | 外部サービスでユニークなキーを指定 |
| リード:メールアドレス | String | 訪問者のリードメールアドレス | |
| リード:名前 | name | String | 訪問者のリード記載名 |
| リード:会社名 | companyName | String | 訪問者のリード記載会社名 |
| リード:電話番号 | tel | String | 訪問者のリード記載電話番号 |
| チャット:メールアドレス | chatEmail | String | 訪問者のチャット記載メールアドレス |
| チャット:名前 | chatName | String | 訪問者のチャット記載名 |
| チャット:会社名 | chatCompanyName | String | 訪問者のチャット記載会社名 |
| チャット:電話番号 | chatTel | String | 訪問者のチャット記載電話番号 |
| 管理情報:メールアドレス | perhapsEmail | String | 訪問者の管理用メールアドレス |
| 管理情報:名前 | perhapsName | String | 訪問者の管理用名前 |
| 管理情報:会社名 | perhapsCompanyName | String | 訪問者の管理用会社名 |
| 管理情報:電話番号 | perhapsTel | String | 訪問者の管理用電話番号 |
| スコア | score | int | 訪問者のスコア |
| スコアタイプ | scoreType | String | スコアの計算方法を指定("+"で加算、"-"で減算) |
2-3.独自の属性設定(pfパラメータ)
pf では、任意のキー名と値を指定して、独自属性を付与できます。
形式は以下の通りです。
"パラメーター名" : "属性値"
※使用例 (この例では独自属性として、userType に "new"、area に "Tokyo" を設定しています。)
pf={"userType":"new","area":"Tokyo"}
