注意：ZendeskはAPIトークン認証を廃止しています。新規のお客様はすべてOAuthを使用してFinをZendeskに接続する必要があります。
新規非契約のお客様：OAuthが必須です。
新規契約のお客様：ワークスペースがOAuth対応になるとOAuthが必須になります。
既存のお客様：APIトークン接続は引き続き動作しますが、切断された場合はOAuthで再接続する必要があります。OAuthが有効になるまでFinワークスペースに常駐バナーが表示されます。
Zendeskに接続する
接続は設定ではなく統合されたConnectセクションから管理されます。接続するには：
左のナビゲーションでConnectに移動します。
Connect to Zendeskを展開し、Connectを選択します。ポップアップが開くのでOAuthでZendeskにサインインし、アクセスを承認してください。
ポップアップが閉じ、自動的にFinに戻ります。
接続がConnectedと表示され、Zendeskアカウントのdomainが表示されていることを確認してください。
ヒント：OAuthは安全でトークン不要の認証を提供し、APIキーの管理が不要になります。
ブランド、スケジュール、フィールドの同期はすべて単一の統合ページで管理されます。データ同期設定を管理するにはSettings › Zendesk data に移動してください。
データ同期設定を管理する
Zendeskから自動的にデータが同期されます。
OAuthを使用して接続すると、FinはZendeskから毎時自動的にデータを同期します。
これには以下が含まれます：
ユーザー属性（Peopleデータ）
Ticket属性（Conversationデータ）
組織属性（Companyデータ）
Zendeskスケジュール
同期対象：
既存の属性
新規作成された属性
削除された属性
Zendeskとリストデータを再同期する
Finはリストタイプ属性（例：ドロップダウン、単一選択フィールド）の手動再同期を許可します。
再同期するには：
Sync data from Zendeskで属性を選択します。
Re-syncをクリックします。
これにより、Finの選択可能な値がZendeskと一致するように更新されます。
JWTによる自動同期
Fin MessengerでJWT認証を使用している場合、以下のタイミングでFinはZendeskからusersおよび組織フィールドを自動的に同期します：
Messengerが読み込まれたとき
Zendesk Messenger経由で新しいメッセージが送信されたとき
これにより、Finワークスペースで最も正確なデータが利用可能になり、よりパーソナライズされ効率的なworkflowsが促進されます。
Finが収集するデータを管理する
FinはZendeskとは少し異なる名前でデータを管理しています。以下では、Finで利用可能な各データタイプがZendeskにどのように対応し、どのように機能するかを説明します。Zendeskから同期されたすべての属性はデータの整合性を保つためにFinワークスペース内で読み取り専用です。
ユーザー属性 = Peopleデータ
Settings > People dataで確認できます。
ここではZendeskアイコンで示されたZendeskから同期されたuser属性と、Finが取得するOSや国などのデフォルトのPeopleデータが表示されます。
Finが取得したすべてのPeopleデータはZendeskに戻すことができます。
Finプラットフォーム内で新しいカスタムPeopleデータ属性を作成することも可能です。右上の「Create attribute」をクリックしてください。
Ticket属性 = Conversationデータ
Settings > Conversation dataで確認できます。
Zendeskアイコンで示されたZendeskから同期されたtickets属性が表示されます。
Finが取得したすべてのConversationデータはZendeskに戻すことができます。
Finプラットフォーム内で新しいConversationデータ属性を作成することも可能です。右上の「Create attribute」をクリックしてください。
組織属性 = 会社データ
設定 > 会社データで見つかります
Zendeskから同期された組織属性（Zendeskアイコンで示されます）が表示されます。
Finで取得したすべての会社データはZendeskに戻すことができます。
Finプラットフォーム内で新しい会社データ属性を作成することも可能です。右上の「Create attribute」をクリックしてください。
注意：
Zendeskから同期された属性（Zendeskアイコン付き）はFinワークスペース内で読み取り専用です。
これらの属性の変更はZendeskで直接行う必要があり、次の1時間ごとの同期時にFinに反映されます。
Zendeskの組織「Multi-select」および「Lookup」フィールドの同期は現在サポートされていません。
Zendeskの「tag」フィールドには特定の動作があります：これらのタグに関連付けられた「Yes」または「No」の値のみが同期され、タグ自体は同期されません。
タグはZendesk内で機能するよう設計されており、Finワークスペース内で直接編集することはできません。
Finワークスペースで追加されたタグはエスカレーション時にZendesk ticketsに同期されません。Zendeskから同期されたタグのみが適用され、Zendesk ticketに表示されます。
ticketエスカレーション時のタグとデータ属性の同期方法
FinがZendeskに会話をエスカレーションする際：
Workflow属性（Set conversation dataまたはAI category detectionで設定）はticketフィールドとしてZendeskに同期されます。
fin-involvedのような統合タグが自動的に追加されます。正しい同期のために、属性はhand-offステップの前に設定する必要があります。
データを使ってworkflowsを構築する
Finを展開するすべてのチャネルにはworkflowがあり、エンドusersが体験する流れを定義します。workflowsを使って、データをさまざまな方法で活用できます。
特定のデータポイントに基づく条件付き体験を作成する
workflow内で分岐を作成し、データを使って次に何が起こるかを定義できます。例えば、VIP customers向けに異なる動作を定義することが可能です。
データを入力してZendeskに戻す
Zendeskにデータを戻すには、手動で入力するかAIを使って分類する方法があります。これはworkflow経由で行う必要があります。
手動でデータを入力するには、「Set conversation data」ステップを追加できます。
AIで入力するには、「AI category detection」ステップを追加できます。
どちらの方法を選んでも、「Hand off to Zendesk agent」または「Create Zendesk ticket」を使用する際に、データをZendeskのticketやライブチャットに戻すために行うべきです。
ticketエスカレーション時にすべての属性が正しく転送されるように、workflowのhand-offステップの前にデータ設定ステップ（例：「Set conversation data」または「AI category detection」）を含めてください。
1. 使用しているZendeskチャネルのworkflowを編集する
Deployに移動し、該当チャネルを選択してください。各チャネル（Zendesk Tickets、Zendesk Messaging、Fin Messenger）には専用の設定とworkflowページがあります。
まだチャネルを設定していない場合は、使用したいチャネルを選択し、Workflowステップに進んでください。
設定済みのチャネルの場合は、該当チャネルの隣にあるworkflow名をクリックしてください。
2. workflowの最後に「Hand off to Zendesk agent」または「Create Zendesk ticket」ステップを追加する
workflowを編集中に、「Hand off to Zendesk agent」ステップか「Create Zendesk ticket」ステップのいずれかを追加できます。以下の例では、営業時間中かどうかで両方のオプションを使い分けています。
3. 「Add step」をクリックする
4. 「Set conversation data」または「AI category detection」を選択する
「Set conversation data」を選択すると、属性を手動で定義できます。
| 
|
「AI category detection」を選択すると、AIを使って属性を入力できます。
上の画像のように「Add description」が表示された場合は、以下を行う必要があります：
| 
|
注意：
Fin for Zendeskを設定しているのにDeployでこれらのオプションが表示されない場合：
Fin Messenger
ZD Messaging
ZD tickets
Copilot
…おそらくIntercom Suite workspaceにサインアップしている可能性があります。👇
Fin for ZendeskはZendesk統合専用に構築されており、Zendesk内のticketingおよびknowledge base機能に焦点を当てています。Intercom SuiteのHelpdeskやアウトバウンドメッセージングなどの機能は含まれていません。
Intercom Suite は、一方で Fin AI Agent と Intercom 独自の Helpdesk、アウトバウンドメッセージング、およびカスタマーサポートツールを組み合わせていますが、現在の Zendesk セットアップと Fin を統合することはありません。
Zendesk 用の Fin のみを利用したい場合、2つのオプションがあります：
Intercom Suite アカウントを削除してから、Zendesk 用 Fin の無料トライアルにサインアップする、または
Intercom Suite アカウントからログアウトしてから、別のメールアドレスを使ってZendesk 用 Fin の無料トライアルを開始してください。
よくある質問
同期された Zendesk 組織属性を使って Analyze ページで Fin のデータをフィルタリングできますか？
同期された Zendesk 組織属性を使って Analyze ページで Fin のデータをフィルタリングできますか？
現時点ではできません。Zendesk 組織（会社）属性は Analyze セクションのフィルターとして利用できません。
回避策：Fin Messenger ワークフローを使用している場合（Zendesk Tickets ワークフローには適用されません）、Organization フィールドをチェックする分岐を作成し、その条件に基づいてTagを適用できます。そのタグを Fin 内のレポートに使用できます。