お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
SalesIQ Webhook の概要
Webhook は「イベントリアクション」というコンセプトに基づいて動作し、クライアント側アプリケーションがサーバー側アプリケーションを継続的にポーリングする必要をなくします。つまり、クライアント側アプリケーションがサーバー側アプリケーションに新しい処理があるかどうかを常に確認する代わりに、サーバー側アプリケーションが何か新しい報告事項がある場合、クライアントが指定した Webhook URL を通じてクライアント側アプリケーションに通知します。これが Webhook の基本的な仕組みです。
メリット
- Webhook を利用すると、サーバーで特定の処理が発生した際に、プッシュ通知を受け取ることが可能です。API を定期的にポーリングしてこれらの処理の発生を確認する必要はありません。Webhook でイベントに「サブスクリプション管理」するだけで済みます。
- Webhook は自動化や業務効率向上に活用できる強力なリソースです。API リソースが必要に応じて作成・更新・取得できる静的データであるのに対し、Webhook は動的リソースです。たとえば、顧客が会話を開始または返信した際など、特定の操作があった場合に自動的に通知されるよう設定できます。
Webhook の作成と管理
REST API を利用して Webhook の作成および管理が可能です。
詳しくはこちら。
信頼できるデータ元の検証(署名による):
公開鍵とは何か、API を使ってどのように生成するか
SalesIQ は、エンドポイント URL に送信される Webhook イベントごとに RSA 暗号方式を用いて署名します。
- SHA256 with RSA を署名アルゴリズムとして使用しています。
- 署名は Base64 でエンコードされます。
- 使用している文字セットは UTF-8 です。
生成した公開鍵はコピーしてエンドポイントサーバーに保存でき、後で署名付きで受信したデータの真正性を確認するために利用します。公開鍵と秘密鍵のペアが生成されます。
- API: /api/v2/{screenname}/Webhook/{id}/keys
- METHOD:POST
- Scope:SalesIQ.Webhook.作成
- API: /api/v2/{screenname}/Webhook/{id}/keys/{keyid}
- METHOD:削除
- Scope:SalesIQ.Webhook.削除
信頼できるデータ元の検証は、Webhook のセキュリティ確保のために行います。これは、統合サービスであるあなたが、API レスポンスで受け取った公開鍵と、そのデータに付与された x-siqsignature リクエストヘッダー内の署名を検証することで、SalesIQ サービスから送信されたデータであるかどうかを認証するものです。署名が有効であれば、そのデータ元は信頼できます。このプロセスにより、Webhook を不正アクセスから保護します。
署名ヘッダーを利用してデータ元を認証するには:
- ヘッダー :
- {
- x-siqsignature : $署名
- }
セキュアなコールバックを設定したい場合は、Webhookを作成し、「secured:真」としてセキュアを設定してください。
- データの内容:
- {
- Webhook : {
- url : $webhookurl,
- secured : },
- 公開済み :
- }
メモ:
- 1ポータルあたり許可される管理者Webhookの最大数は3です。
- Webhookの自動再試行回数の上限は3回です。
- 自動再試行は、次の再試行まで1分間隔で行われます。
- 各実行のタイムアウトは5秒です。
- 初期設定のエラーログ保持期間は60日です。
- Webhookはエンタープライズプランでのみご利用いただけます。
Webhook データの内容
SalesIQで購読しているイベントが発生すると、Webhookが呼び出されます。例えば、conversation。visitor。repliedに購読している場合、訪問者がチャットに返信すると関連データとともに通知されます。
データの内容の定義:
- バージョン - Webhookデータの内容のバージョン
- event - 通知されたイベント
- event_time - イベントが発生した時間
- org_id - お客様のSalesIQポータルID
- app_id - 埋め込みID。データ処理のみ利用可能
- attempt - Webhookを通じてイベント通知を試行した回数
- 項目 - 発生したイベントの項目
- entity_type - 項目の種類(例:Bot、部署、オペレーター)
- entity_id - 項目のユニークID。例えば、conversation.*処理の場合は会話ID
- modified_fields - 更新されたプロパティの一覧
データの内容は以下の形式で受領する必要があります。
- {
- 'バージョン' : '1',
- 'event' : 'operator.作成',
- 'event_time' : $イベントの時間,
- 'org_id' : $soid,
- 'app_id' : $appid,
- 'attempt' : $もう一度試すの件数,
- 'entity_type' : $項目の種類,
- 'entity_id' : $ID,
- '項目' : {
- $項目 OBJECT
- },
- 'modified_fields' : [ ]
- }
例:
- {
- 'entity_type':'conversation',
- 'org_id':'14327896',
- 'event':'conversation。operator。replied',
- 'entity_id':'8000000004009',
- 'attempt':1,
- 'バージョン':'1',
- 'app_id':8000000000047,
- '項目':{
- 'id':'8000000004009',
- 'メッセージ':{
- 'sender':{
- '名前':'Tricia',
- 'id':'8000000000005'
- },
- 'msgid':'1566480708251',
- 'text':'こんにちは、配送ステータスについてヘルプが必要です'
- }
- },
- 'event_time':1566480708268,
- 'customer_info': {
- '支店': 'カリフォルニア',
- 'Band': 'プレミアム'
- }
- }
Webhook 利用前の前提条件
- https URL を利用することを推奨します(セキュリティ理由)。
- サーバーはポート番号付きのURLには接続できません。
- URLは、PostmanやTalend API Testerなど公開APIクライアントでアクセス可能である必要があります。サーバーからアクセス可能であることを確認してください。
- URLが指定されると、5秒の読み取りタイムアウトで検証のためにpingが送信されます。
- 5秒以内に到達できない場合、HTTP HEADリクエストでURLをチェックし、ステータスコード200の確認を行います。
- Webhookは10秒以内にレスポンスを返す必要があります。
Webhookが無効になるケース:
ケース1:WebhookがHTTPコード400以上を返し、完了確認のレスポンスを継続して返せない場合、ポータル担当者およびWebhook作成者にメールで警告が送信されます。
- Webhookが3時間連続で失敗した場合、最初の注意メールが送信され、6時間連続で失敗した場合には2回目の注意メールが送信されます。
- Webhookが12時間連続で失敗した場合、Webhookは無効化され、最終メールが送信されます。
ケース2:Webhookが登録された処理の投稿時にHTTPコード410を返した場合、SalesIQシステムはWebhookを削除し、ポータル担当者とWebhook作成者の両方にメールが送信されます。
メモ: この期間中にWebhookが完了レスポンスを返した場合は、通常通り動作します。ただし、再度失敗した場合は、上記の回数カウントが最初から再開されます。
処理
Webhookを利用すると、特定の処理がSalesIQ上で発生した際に通知を受け取ることができます。下記の処理リストにサブスクリプション登録している場合、各イベント発生時にデータとともに通知が届きます。
Webhookタブ
以下のタブが利用可能で、それぞれのタブに関連する操作が発生した際に通知を受け取ることができます。
- Conversation : Conversationでは、Webサイト訪問者とのやりとりを追跡・記録できます。会話には訪問者/オペレーターのメッセージ、関与したオペレーター、会話を担当する管理者/スーパーバイザー、その他の会話に関連する情報が含まれます。
- 部署 : 部署は管理イベントです。このイベントにサブスクリプション登録し、新規部署の作成・更新・削除時に通知を受け取ることができます。Webhook内の処理はデータ系と管理系の2種類があります。
Conversation
Conversationでは、Webサイト訪問者とのコミュニケーションを追跡・記録できます。会話には訪問者/オペレーターのメッセージ、関与したオペレーター、会話を担当する管理者/スーパーバイザー、その他の関連情報が含まれます。
Conversationに関する処理一覧:
- conversation.作成
- conversation。attender。updated
- conversation。missed
- conversation.完了
- conversation。rated
- conversation。visitor。replied
- conversation。operator。replied
- conversation.完了
- conversation。rated
- conversation。transfer.開始済み
- conversation。transfer.承認済み
- conversation。transfer.却下済み
- conversation.参加者.added
- conversation.参加者.削除
- conversation。supervisor。added
- conversation.メッセージ.編集
- conversation.メッセージ.削除
- conversation。metrics
conversation.作成
このイベントにサブスクリプション登録することで、訪問者がチャットを開始した際に通知を受け取ることができます。
- データの内容:
- {
- 'id': '17000000004021',
- 'visitor_conversation_id': 'ad433hjdid546f8n4b734j4omfhjsrwnet46fklf7',
- 'reference_id': '1',
- 'opened_time': '1556866331533',
- 'attended_time': '1556866331553',
- 'end_time': '1556866331929',
- 'missed_time': '1556866333232',
- 'app_id': '30185567778889',
- 'department_id': '301050000004',
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'1234354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です。',
- 'supervisors': [
- '30102333033336',
- '30102333033337'
- ],
- '参加者': [
- '30102333033336',
- '30102333033337'
- ],
- 'ステータス': '有効',
- 'chat_status': {
- 'status_code': [
- '1,2'
- ],
- '状態': [
- '1,2,3,4'
- ],
- 'ラベル': '有効'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
conversation.attender.updated
オペレーターがチャットを受け取った際に通知を受けるために、サブスクリプション管理でこのイベントを購読できます。
- データの内容:
- {
- 'id': '17000000004021',
- 'visitor_conversation_id': 'ad433hjdid546f8n4b734j4omfhjsrwnet46fklf7',
- 'reference_id': '1',
- 'opened_time': '1556866331533',
- 'attended_time': '1556866331553',
- 'end_time': '1556866331929',
- 'missed_time': '1556866333232',
- 'app_id': '30185567778889',
- 'department_id': '301050000004',
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'124534354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- }
- },
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です。',
- 'supervisors': [
- '30102333033336',
- '30102333033337'
- ],
- '参加者': [
- '30102333033336',
- '30102333033337'
- ],
- 'ステータス': '接続済み',
- 'chat_status': {
- 'status_code': [
- '1,2'
- ],
- '状態': [
- '1,2,3,4'
- ],
- 'ラベル': 'Attended オンライン'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
conversation。missed
サブスクリプション管理でこのイベントに登録すると、訪問者によって開始されたチャットが、いずれのオペレーターにも対応されず未対応となった場合に通知を受け取ることができます。
- データの内容:
- {
- 'id': '17000000004021',
- 'visitor_conversation_id': 'ad433hjdid546f8n4b734j4omfhjsrwnet46fklf7',
- 'reference_id': '1',
- 'opened_time': '1556866331533',
- 'attended_time': '1556866331553',
- 'end_time': '1556866331929',
- 'missed_time': '1556866333232',
- 'app_id': '30185567778889',
- 'department_id': '301050000004',
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'12344354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です。',
- 'supervisors': [
- '30102333033336',
- '30102333033337'
- ],
- '参加者': [
- '30102333033336',
- '30102333033337'
- ],
- 'ステータス': 'Missed',
- 'chat_status': {
- 'status_code': [
- '1,2'
- ],
- '状態': [
- '1,2,3,4'
- ],
- 'ラベル': 'CRMで追跡'
- },
- 'customer_info': {
- '支店': 'カリフォルニア',
- 'Band': 'プレミアム'
- }
- }
conversation。operator。replied
このイベントで、オペレーターが訪問者によって開始されたチャットに返信した際に通知を受け取りたい場合は、サブスクリプション管理で設定できます。
- データの内容:
- {
- 'id':'8000000004009',
- 'メッセージ':{
- 'sender':{
- '名前':'Tricia',
- 'id':'8000000000005'
- },
- 'msgid':'1566480708251',
- 'text':'ダイニングセットの購入についてサポートが必要です。'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'12344354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- '担当者':{
- 'id':'30102333033335',
- '名前':'Patricia',
- 'email_id':'patricia@zylker。com'
- },
- 'バージョン':1
- }
- Bot Conversation データの内容:
- {
- メッセージ : {
- 'sender' : {
- 'id' : $sender wms id,
- '名前' : $sender 名前
- },
- 'text' : $msg, // bot メッセージには含まれません
- 'msgid' : $msg id, // bot メッセージには含まれません
- 'meta' : $meta data, ---> bot メッセージに適用されます
- 'list' : [
- $メッセージ LIST
- ]
- },
- 'customer_info': {
- '支店': 'カリフォルニア',
- 'Band': 'プレミアム'
- }
- }
conversation.visitor.replied
訪問者が返信した際に通知を受け取りたい場合は、このイベントにサブスクリプション管理が可能です。
- データの内容:
- {
- 'id': '8000000005001',
- 'メッセージ': {
- 'sender': {
- '名前': 'Tricia',
- 'id': '$2463902591169630574'
- },
- 'msgid': '1566481170562',
- 'text': 'こんにちは、ダイニングセットの購入に関してサポートが必要です'
- },
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'1234354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- 'バージョン': 1
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
conversation.完了
チャット会話が終了した際に通知を受け取りたい場合は、このイベントにサブスクリプション管理を追加できます。
- データの内容:
- {
- 'id': '17000000004021',
- 'visitor_conversation_id': 'ad433hjdid546f8n4b734j4omfhjsrwnet46fklf7',
- 'reference_id': '1',
- 'opened_time': '1556866331533',
- 'attended_time': '1556866331553',
- 'end_time': '1556866331929',
- 'missed_time': '1556866333232',
- 'app_id': '30185567778889',
- 'department_id': '301050000004',
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'12344354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です。',
- 'supervisors': [
- '30102333033336',
- '30102333033337'
- ],
- '参加者': [
- '30102333033336',
- '30102333033337'
- ],
- 'ステータス': '完了済み',
- 'chat_status': {
- 'status_code': [
- '1,2'
- ],
- '状態': [
- '1,2,3,4'
- ],
- 'ラベル': 'メールによる対応'
- },
- 'customer_info': {
- '支店': 'カリフォルニア',
- 'Band': 'プレミアム'
- }
- }
conversation.rated
サブスクリプション管理でこのイベントに登録することで、訪問者がオペレーターとのチャットの評価やフィードバックを行った際に通知を受け取ることができます。
- 評価用データ内容:
- {
- '評価': 4,
- 'フィードバック': 'Good サポート',
- '担当者': {
- 'id': '30102333033335',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'12344354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
- フィードバック用データ内容:
- {
- 'entity_type': 'conversation',
- 'org_id': '55778119',
- 'event': 'conversation。rated',
- 'entity_id': '40526000001808033',
- 'attempt': 1,
- 'バージョン': '1',
- 'app_id': 40526000000002040,
- '項目': {
- '担当者': {
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- 'id': '40526000000002001'
- },
- 'フィードバック': 'Awesome サポート 差出人 the reps!',
- 'id': '40526000001808033',
- 'ステータス': 'Ended',
- 'visitor':{
- 'email_id':'tricia@zylker。com',
- '電話番号':'12344354',
- '名前':'Tricia',
- '種類' : '連絡先',
- 'id': '30000000090034'
- }
- },
- 'event_time': '1567065865617',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
conversation。transfer.開始済み
このイベントで会話転送が開始された際に通知を受けたい場合は、サブスクリプション管理を設定できます。
データの内容:
- {
- '担当者': {
- 'email_id': 'patricia@zylker。com',
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007'
- },
- 'transfer': {
- 'メモ': '詳細 必須',
- '種類': 'ユーザー|部署',
- 'department_id': '30000000148001',
- 'transferred_by': {
- '種類': 'bot|operator',
- 'email_id': 'patricia@zylker。com',
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007'
- },
- 'transferred_to': [
- {
- 'id': '30000000000006',
- '名前': 'Patricia',
- 'email_id': 'patricia@zylker。com'
- }
- ]
- },
- 'waiting_time': '60',
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です',
- 'department_id': '30000000000018',
- 'id': '30000000095001',
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d',
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- }
conversation。transfer.承認済み
オペレーターによってチャットの移動が承認された際に通知を受け取りたい場合、このイベントにサブスクリプション管理を設定できます。
データの内容:
- {
- 'accepted_by': {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- },
- 'question': 'ダイニングセットの購入についてサポートが必要です。',
- 'department_id': '30000000000018',
- 'id': '30000000158001',
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- 'visitor_conversation_id': '2d665c42a02e919a171b7845509162e6'
- }
conversation。transfer.却下済み
オペレーターによって移動済みチャットが却下された際に通知を受け取りたい場合は、このイベントにサブスクリプション管理を行えます。
データの内容:
- {
- 'rejected_by': {
- '種類': 'auto | manual',
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- },
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です',
- 'department_id': '30000000000018',
- 'id': '30000000158001',
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d'
- }
conversation.参加者.added
チャットに参加者が招待された際に通知を受け取りたい場合は、このイベントにサブスクリプション管理を行えます。
データの内容:
- {
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です',
- 'department_id': '30000000000018',
- 'id': '30000000095001',
- 'invite': {
- 'メモ': 'asdfqsf',
- 'added_by': {
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007',
- 'email_id': 'patricia@zylker。com'
- },
- 'added_operators': [
- {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- }
- ]
- },
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d',
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- '担当者': {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- }
- }
conversation.参加者.削除
このイベントの通知を受け取る場合は、サブスクリプション管理にて設定できます。会話から参加者が削除されると通知されます。
データ内容:
- {
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です',
- 'department_id': '30000000000018',
- 'deleted_by': {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- },
- 'deleted_operators': [
- {
- '名前': 'Patricia+1',
- 'id': '30000000000106',
- 'email_id': 'patricia@zylker。com'
- }
- ],
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- '担当者': {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- },
- 'id': '30000000095001',
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d'
- }
conversation。supervisor。added
このイベントにサブスクリプション管理を行うことで、スーパーバイザーがチャットに追加された際に通知を受け取ることができます。
データの内容:
- {
- 'added_operators': [
- {
- '名前': 'Patricia',
- 'id': '30000000000006',
- 'email_id': 'patricia@zylker。com'
- }
- ],
- 'id': '30000000095001',
- 'question': 'こんにちは、ダイニングセットの購入についてサポートが必要です',
- 'department_id': '30000000000018',
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- '担当者': {
- '名前': 'Patricia+1',
- 'id': '30000000000106',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d'
- }
conversation.メッセージ.編集
チャット内でメッセージが編集された際に通知を受け取りたい場合、このイベントにサブスクリプション管理を行ってください。
データの内容:
- {
- 'id': '8000000005001',
- 'メッセージ': {
- 'sender': {
- '名前': 'Patricia',
- 'id': '30000000000006'
- },
- 'msgid': '1566481170562',
- 'text': 'abcc'
- },
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- '担当者': {
- '名前': 'Patricia+1',
- 'id': '30000000000106',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d'
- }
conversation.メッセージ.削除
チャットでメッセージが削除された際に通知を受け取りたい場合は、このイベントにサブスクリプション管理を設定できます。
データの内容:
- {
- 'id': '8000000005001',
- 'メッセージ': {
- 'sender': {
- '名前': 'Patricia',
- 'id': '30000000000006'
- },
- 'msgid': '1566481170562'
- },
- 'visitor': {
- 'email_id': 'tricia@zylker。com',
- '電話番号': '1234354',
- '名前': 'Tricia',
- '種類': '連絡先',
- 'id': '30000000090034'
- },
- '担当者': {
- '名前': 'Patricia+1',
- 'id': '30000000000106',
- 'email_id': 'patricia@zylker。com'
- },
- 'visitor_conversation_id': '2d665c42a02e919ac0f91f62fa78581d',
- }
conversation.metrics
サブスクリプション管理でこのイベントに登録すると、会話が終了した際に、その会話のメトリクスとメタデータを含む通知を受け取ることができます。
データの内容:
- {
- 'entity_type': 'conversation',
- 'org_id': '65423290',
- 'event': 'conversation。metrics',
- 'entity_id': '115844000014120021',
- 'attempt': 1,
- 'バージョン': '1',
- 'app_id': '115844000002965011',
- '項目': {
- 'inititated_by': '訪問者',
- 'question': '12',
- 'end_time': '1721653023236',
- 'chat_id': '29115',
- 'connected_time': '1721653003085',
- 'opened_time': '1721652997651',
- 'ended_by': 'オペレーター',
- 'id': '115844000014120021',
- 'metrics': {
- 'operator_message_count': '2',
- 'visitor_message_count': '3',
- 'bot_message_count':'2',
- 'info_message_count':'4',
- 'system_event_count':'1',
- 'average_response_time': '5792',
- 'first_response_time': '6105',
- 'total_chat_duration': '20151',
- 'visitor_waiting_time': '5434',
- 'missed_reason':'すべてのオペレーターが対応中です。',
- 'bot_pickup_after':'1721652997651',
- 'bot_duration':'172165299764',
- 'queued_duration':'1721652997751',
- 'first_agent_accept_after':'1721652999651',
- 'total_operator_duration':'1721652997651',
-
- },
- '時間': {
- 'initiated_time':'1721652997651',
- 'connected_time':'1721652997655',
- 'bot_pickup_time':'1721652997655',
部署
Webhook には「データ」と「管理」の2種類の処理があります。部署は管理イベントに該当します。このイベントにサブスクリプション管理を設定すると、新規部署が作成、更新、または削除された際に通知を受け取ることができます。
部署処理の一覧:
- 部署.作成
- 部署.削除
- 部署.updated
部署.作成
このイベントにサブスクリプション管理を設定することで、ポータル内で新規部署が作成されるたびに通知を受け取ることができます。
- データの内容:
- {
- 'entity_type': '部署',
- 'org_id': '55778119',
- 'event': '部署.作成',
- 'entity_id': '40526000001808025',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- 'is_enabled': '真',
- 'created_time': '1571032858870',
- 'modified_time': '1571032858870',
- 'operators': [
- '6000000000005'
- ],
- 'is_system_generated': '無効',
- '名前': 'サポート',
- 'is_public': '真',
- 'email_configurations': {
- 'missedchat_recipients': '',
- 'cc_recipients': '',
- 'is_blockip_mail_enabled': '真',
- 'from_email': 'tricia@zylker。com',
- 'transcript_recipients': 'tricia@zylker。com',
- 'is_feedback_mail_enabled': '真',
- 'blockip_recipients': '',
- 'feedback_recipients': '',
- 'is_missedchat_mail_enabled': '真',
- 'is_cc_mail_enabled': '真',
- 'is_transcript_mail_enabled': '真'
- },
- '説明': 'サイト上の訪問者をサポートするチーム',
- 'id': '6000000009015',
- 'display_name': 'Zylker-サポート',
- 'created_by': '6000000000005'
- },
- 'event_time': '1567065647511',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
部署.削除
サブスクリプション管理でこのイベントを追加すると、ポータル内で部署が削除された際に通知を受け取ることができます。
- データの内容:
- {
- 'entity_type': '部署',
- 'org_id': '55778119',
- 'event': '部署.削除',
- 'entity_id': '40526000001808025',
- 'attempt': 1,
- 'バージョン': '1',
- 'event_time': '1567065647511',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
部署.updated
このイベントにサブスクリプション管理を行うことで、部署の詳細が更新された際に通知を受け取ることができます。
- データの内容:
- {
- 'entity_type': '部署',
- 'org_id': '55778119',
- 'event': '部署.updated',
- 'entity_id': '40526000001808025',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- 'is_enabled': '真',
- 'created_time': '1571032858870',
- 'modified_time': '1571032858870',
- 'operators': [
- '6000000000005'
- ],
- 'is_system_generated': '無効',
- '名前': 'サポート',
- 'is_public': '真',
- 'email_configurations': {
- 'missedchat_recipients': '',
- 'cc_recipients': '',
- 'is_blockip_mail_enabled': '真',
- 'from_email': 'tricia@zylker。com',
- 'transcript_recipients': 'tricia@zylker。com',
- 'is_feedback_mail_enabled': '真',
- 'blockip_recipients': '',
- 'feedback_recipients': '',
- 'is_missedchat_mail_enabled': '真',
- 'is_cc_mail_enabled': '真',
- 'is_transcript_mail_enabled': '真'
- },
- '説明': 'サイト上の訪問者をサポートするチーム',
- 'id': '6000000009015',
- 'display_name': 'Zylker-サポート',
- 'created_by': '6000000000005'
- },
- 'event_time': '1567065647511',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
オペレーター
Webhookには、データ処理と管理処理の2種類があります。オペレーターは管理イベントであり、オペレーターイベントが実行された際に通知を受けるためにサブスクリプション管理を行うことができます。
オペレーター処理一覧:
- operator.作成
- operator。updated
- operator.削除
- operator.部署.関連付け済み
- operator.部署.dissociated
operator.作成
このイベントにサブスクリプション管理を設定すると、組織に新しいオペレーターが追加されるたびに通知を受け取ることができます。
データの内容:
- {
- 'entity_type': 'operator',
- 'org_id': '15188410',
- 'event': 'operator.作成',
- 'entity_id': '115000000029087',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- 'email_id': 'patricia@zylker。com',
- 'access_levels': [
- 'chat',
- 'tracking'
- ],
- '役割': 'Administrator',
- '署名': '2e8132839ffef039e24ab8e162b5b1f1',
- 'date_of_birth': '',
- '説明': '',
- '言語': '',
- 'chat_enabled': 真,
- '種類': 'Salesiq ユーザー',
- 'locale': '',
- 'confirmed': 無効,
- '有効': 真,
- '通知': {
- 'return_visit': 無効,
- 'new_visit': 無効
- },
- 'modified_time': '1596093400214',
- 'id': '115000000029087',
- '部署': [
- '115000000004001',
- '115000000000018'
- ],
- 'first_name': '',
- '担当者': 無効,
- 'created_time': '1596093400198',
- 'time_format': '12 時間',
- '住所': {
- '国': '',
- 'pincode': '',
- '市区町村': '',
- '町名・番地': '',
- '状態': ''
- },
- 'maximum_concurrent_chat': 'なし',
- 'image_url': '',
- 'モバイル': '',
- 'last_name': '',
- 'time_zone': '',
- 'locale_country': '',
- '削除': 無効,
- '電話番号': '',
- 'nick_name': 'Patricia',
- 'social_media': {
- 'Twitter': {
- 'profile_url': ''
- },
- 'linkedin': {
- 'profile_url': ''
- },
- '有効': 無効
- },
- 'ステータス': '利用可能'
- },
- 'event_time': '1596093402483',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
operator。updated
サブスクリプション管理で、オペレーターの設定が更新された時に通知を受け取りたい場合は、このイベントを利用できます。
データの内容:
- {
- 'entity_type': 'operator',
- 'org_id': '15188410',
- 'event': 'operator。updated',
- 'entity_id': '115000000000094',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- 'email_id': 'patricia@zylker。com',
- 'access_levels': [
- 'chat',
- 'トラッキング'
- ],
- '役割': 'Administrator',
- '署名': '2e8132839ffef039e7eaaa00748b47ec',
- '生年月日': '',
- '説明': '',
- '言語': 'en',
- 'チャット有効': 真,
- '種類': 'Salesiq ユーザー',
- 'ロケール': 'en',
- '確認済み': 真,
- '有効': 真,
- '通知': {
- '再訪問': 無効,
- '新規訪問': 無効
- },
- '更新日時': '1596092957234',
- 'ID': '115000000000094',
- '部署': [
- '115000000000018'
- ],
- '名': 'Patricia',
- '担当者': 無効,
- '作成日時': '1594720783132',
- '時間形式': '12時間',
- '住所': {
- '国': 'us',
- '郵便番号': '625012',
- '市区町村': 'Malibu',
- '町名・番地': 'Pacific Coast Highway',
- '州': 'California'
- },
- '同時チャット最大数': 'なし',
- '画像URL': '',
- 'モバイル': '08903694722',
- 'last_name': 'Smith',
- 'time_zone': 'United 都道府県/California',
- 'zuid': '15102744',
- 'locale_country': 'us',
- '削除': 無効,
- '電話番号': '1234567890',
- 'nick_name': 'Patricia',
- 'social_media': {
- 'Twitter': {
- 'profile_url': ''
- },
- 'linkedin': {
- 'profile_url': ''
- },
- '有効': 無効
- },
- 'ステータス': '利用可能'
- },
- 'event_time': '1596092957257',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
operator.削除
オペレーターが削除された際に通知を受け取りたい場合は、このイベントにサブスクリプション管理を設定できます。
データの内容:
- {
- 'entity_type': 'operator',
- 'org_id': '15188410',
- 'entity_id': '115000000029087',
- 'event': 'operator.削除',
- 'バージョン': '1',
- 'attempt': 1,
- 'event_time': '1596093526367',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
operator.部署.関連付け済み
サブスクリプション管理でこのイベントに登録すると、オペレーターが部署に関連付けられるたびに通知を受け取ることができます。
データの内容:
- {
- 'entity_type': 'operator',
- 'org_id': '15188410',
- 'event': 'operator.部署.関連付け済み',
- 'entity_id': '115000000000006',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- '部署': [
- '115000000004001'
- ],
- 'id': '115000000000006'
- },
- 'event_time': '1596094781678',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
operator.部署.dissociated
オペレーターが部署から削除された際に通知を受け取りたい場合、このイベントにサブスクリプション管理を設定できます。
データの内容:
- {
- 'entity_type': 'operator',
- 'org_id': '15188410',
- 'event': 'operator.部署.dissociated',
- 'entity_id': '115000000000006',
- 'attempt': 1,
- 'バージョン': '1',
- '項目': {
- '部署': [
- '115000000004001'
- ],
- 'id': '115000000000006'
- },
- 'event_time': '1596094781678',
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
訪問者
Webhook には2種類の処理タイプ(データと管理)があります。訪問者はデータイベントに該当します。訪問者イベントが発生した際に通知を受け取るには、サブスクリプション管理から設定できます。
訪問者処理の一覧:
- visitor。updated
visitor。updated
このイベントにサブスクリプション登録することで、訪問者情報が更新された際に通知を受け取ることができます。
ケース1: リード情報が更新されると、このデータの内容を受け取ります。
データの内容:
- {
- 'id': '30000000095001',
- '種類': 'lead ',
- 'first_name': 'Scott',
- 'last_name': 'Smith',
- 'modifier': {
- '種類': 'operator',
- 'email_id': 'patricia@zylker。com',
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
ケース2:リードに連絡先情報が追加された際に、このデータの内容を受け取ります。
メモ: メールや電話番号などの情報が初めて提供された場合、リードは連絡先へ変換されます。
データの内容:
- {
- 'id': '30000000095001',
- '種類': '連絡先',
- 'first_name': 'Scott',
- 'last_name': 'Smith',
- 'email_id': 'scottsmith@zylker。com',
- '電話番号': '9123459876',
- 'lead': {
- 'id': '30000000090034'
- },
- 'modifier': {
- '種類': 'operator',
- 'email_id': 'patricia@zylker。com',
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
ケース 3: 連絡先の情報が更新されると、このデータの内容を受領します。
データの内容:
- {
- 'id': '30000000095001',
- '種類': '連絡先',
- 'first_name': 'Scott',
- 'last_name': 'Smith',
- 'email_id': 'scottsmith@zylker。com',
- '電話番号': '91234598121',
- 'modifier': {
- '種類': 'operator',
- 'email_id': 'patricia@zylker。com',
- '名前': 'patricia@zylker。com',
- 'id': '30000000099007'
- },
- 'customer_info': {
- '支店': 'California',
- 'Band': 'プレミアム'
- }
- }
Webhook を設定する
Webhook を設定するには、
-
SalesIQ ダッシュボード内で、設定 > Developers > Webhook に移動します。
- ここでは、管理タブとデータタブでポータルベースおよび埋め込みベースの処理をそれぞれ Webhook 経由で追加できます。イベント発生時には指定した URL へ通知されます。
管理タブでポータルベースの Webhook を追加する方法
管理タブ内で、ポータルの操作に基づいた Webhook を作成できます。サブスクリプションに応じて、ポータルイベント発生時に通知を受け取ることができます。新しい Webhook を追加するには、
- 追加 をクリックします。
- 呼び出す必要のある URL を入力します。
- Webhook に関連付けたい処理を選択します。
- 最後に、Webhook を作成 をクリックすると、Webhook が作成されます。
- ここで Webhook の手順も確認できます。
AdministrationタブでポータルベースのWebhookを削除する方法
Webhookを削除するには、
-
ダッシュボードで削除したいWebhookにカーソルを合わせ、右端に表示される削除アイコンをクリックします。
-
確認のポップアップが表示されます。削除をクリックするとWebhookが削除されます。
AdministrationタブでWebhookを有効化/無効化する方法
Webhookを有効化または無効化するには、
-
各Webhookの右端に表示されるトグルボタンをクリックします。
DataタブでembedベースのWebhookを追加する方法
Dataタブ内で、embed操作に基づいたWebhookを作成できます。サブスクリプション後、embedイベントが発生するたびに通知されます。新規Webhookを追加するには、
- 追加するをクリックします。
- Webhookを作成したいSalesIQアプリを選択します。
- 呼び出すURLを入力します。
- Webhookに関連付ける処理を選択します。
- 最後に、作成 WebhookをクリックするとWebhookが作成されます。
- Webhookの手順もここで確認できます。
DataタブでembedベースのWebhookを削除する方法
Webhookを削除するには、
- ダッシュボードで削除したいWebhookにカーソルを合わせ、右端に表示される削除アイコンをクリックします。
- 確認のポップアップが表示されます。削除をクリックすると、Webhookが削除されます。
DataタブでWebhookを有効にする/無効にする方法
Webhookを有効にする/無効にするには、
- 各Webhookの右端に表示されるトグルボタンをクリックします。
ダッシュボード:
Webhookダッシュボードでは、以下の詳細を表示できます:
- 失敗: Webhookが失敗した回数
- Last 実行済み: Webhookが最後に実行された日時
- App: Webhookが関連付けられているアプリの一覧