Skip to content
Last updated

Zendesk Export Integration CLI

CLI(TD Toolbelt)を使用して、TDからZendesk Sunshineへデータ結果をエクスポートできます。

前提条件

  • TD Toolbeltがインストールされていること。
  • Zendesk SunshineとZendeskアカウントの基本的な知識があること。

制限事項

クエリは、ターゲットイベントと一致する必須カラム(名前とデータ型)を含む必要があります。

コマンドラインを使用した接続の作成

CLIを使用して接続を設定できます。

設定キーと説明は以下の通りです:

Config KeyTypeRequiredDescription
typestringyeszendesk
login_urlstringyesZendeskのログインURL
auth_methodstringyesbasic、token、またはoauth
usernamestringyes if auth_method is basic or tokenZendeskのユーザー名
passwordstringyes if auth_method is basicZendeskのパスワード
tokenstringyes if auth_method is tokenZendeskのtoken
access_tokenstringyes if auth_method is oauthZendeskのOAuth access token
targetstringyesエクスポート先のZendeskターゲット: event_profile、event_profile_id、またはevent_user_id
skip_invalid_recordsstringno無効なレコードがある場合に続行する

接続とクエリの例

プロファイルのイベントを作成

td query --database my_db \
         --result '{
            "type": "zendesk",
            "login_url": "https://{example}.zendesk.com",
            "auth_method": "basic",
            "password": "xxxxx",
            "username": "xxxxx",
            "target": "event_profile",
            "skip_invalid_records": false
         }'
         'SELECT profile_source, profile_type, profile_identifier_1,
          event_source, event_type, event_properties
          FROM your_table;'

プロファイルIDのイベントを作成

td query --database my_db \
         --result '{
            "type": "zendesk",
            "login_url": "https://{example}.zendesk.com",
            "auth_method": "basic",
            "password": "xxxxx",
            "username": "xxxxx",
            "target": "event_profile_id",
            "skip_invalid_records": false
         }'
         'SELECT profile_id, event_source, event_type, event_properties
          FROM your_table;'

ユーザーIDのイベントを作成

td query --database my_db \
         --result '{
            "type": "zendesk",
            "login_url": "https://{example}.zendesk.com",
            "auth_method": "basic",
            "password": "xxxxx",
            "username": "xxxxx",
            "target": "event_user_id",
            "skip_invalid_records": false
         }'
         'SELECT user_id, profile_source, profile_type, profile_identifier_1,
          event_source, event_type, event_properties
          FROM your_table;'