Zendesk コネクターはZendeskからヘルプセンター記事とサポートチケットを同期します。
認証
APIキー — メール/トークン:api_token 形式の基本認証。
設定
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| サブドメイン | 入力 | はい | Zendeskサブドメイン |
| メール | 入力 | はい | API認証用エージェントメール |
| コンテンツタイプ | ドロップダウン | はい | 両方 / 記事のみ / チケットのみ |
| チケット状態 | ドロップダウン | いいえ | すべて / オープン / 保留中 / 解決済み / クローズ |
| 記事ロケール | 入力 | いいえ | 記事の言語ロケール |
| 最大チケット数 | 入力 | いいえ | 最大チケット数（デフォルト: 500） |
動作の仕組み
- 記事取得 — オプションのロケールフィルター付きでヘルプセンター記事をページネーション
- チケット取得 — 状態フィルタリングとページネーションでチケットを取得
- コメント補完 — 各チケットの全コメントを取得（一度に5件ずつバッチ処理）
- HTML変換 — 記事本文とコメント本文をプレーンテキストに変換
文書フォーマット
記事:
記事タイトル
記事本文...チケット:
件名: チケット件名
ステータス: open
優先度: high
作成日: ISO日付
更新日: ISO日付
タグ: tag1, tag2
--- 説明 ---
説明テキスト...
--- コメント ---
[ISO日付] (公開) 作成者 123456:
コメントテキスト...
[ISO日付] (内部) 作成者 789012:
内部メモテキスト...メタデータタグ
| タグ | タイプ | 説明 |
|---|---|---|
| コンテンツタイプ | テキスト | article または ticket |
| ステータス | テキスト | 記事/チケットの状態 |
| ラベル | テキスト | 記事ラベル |
| タグ | テキスト | チケットタグ |
| 最終更新日 | 日付 | 最終更新日時 |
| コメント数 | 数値 | チケットのコメント数 |