この記事では、FinとZendesk間でusers、ticket、組織属性のデータを同期する方法と、そのデータを使って条件付きworkflowsを作成し、情報をZendeskに戻す方法を説明します。
注意：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キーの管理が不要になります。
ブランド、スケジュール、フィールド同期はすべて単一の統合ページで管理されます。データ同期設定を管理するには設定 › Zendesk dataに移動してください。
データ同期設定を管理する
データはZendeskから自動的に同期されます。
OAuthを使って接続すると、Finは毎時Zendeskから自動的にデータを同期します。
これには以下が含まれます：
users属性（Peopleデータ）
ticket属性（Conversationデータ）
組織属性（Companyデータ）
Zendeskスケジュール
同期対象は：
既存の属性
新規作成された属性
削除された属性
Zendeskとリストデータを再同期する
Finはリストタイプ属性（例：ドロップダウン、単一選択フィールド）の手動再同期を許可します。
再同期するには：
設定 › Zendesk integrationに移動します。
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のワークスペース内で読み取り専用です。
users属性 = Peopleデータ
設定 > People dataで確認できます。
ここでは、Zendeskアイコンで示されたZendeskから同期されたusers属性と、Finが取得するOSや国などのデフォルトのPeopleデータが表示されます。
Finが取得したすべてのPeopleデータはZendeskに戻すことができます。
Finプラットフォーム内で新しいカスタムPeopleデータ属性を作成することも可能です。右上の「Create attribute」をクリックしてください。
Ticket属性 = 会話データ
設定 > 会話データで見つかります
Zendeskから同期されたtickets属性（Zendeskアイコンで示されます）が表示されます。
Finで取得されたすべての会話データはZendeskに戻すことができます。
Finプラットフォーム内で新しい会話データ属性を作成することが可能です。右上の「Create attribute」をクリックしてください。
Organization属性 = 会社データ
設定 > 会社データで見つかります
Zendeskから同期されたorganization属性（Zendeskアイコンで示されます）が表示されます。
Finで取得されたすべての会社データはZendeskに戻すことができます。
Finプラットフォーム内で新しい会社データ属性を作成することが可能です。右上の「Create attribute」をクリックしてください。
注意：
Zendeskから同期された属性（Zendeskアイコン付き）はFinワークスペース内で読み取り専用です。
これらの属性の変更はZendeskで直接行う必要があり、次の1時間ごとの同期時にFinに反映されます。
Zendeskのorganization「Multi-select」および「Lookup」フィールドの同期は現在サポートされていません。
Zendeskの「tag」フィールドには特定の動作があります：これらのタグに関連付けられた「Yes」または「No」の値のみが同期され、タグ自体は同期されません。
タグはZendesk内で機能するよう設計されており、Finワークスペース内で直接編集することはできません。
Finワークスペースで追加されたタグはエスカレーション時にZendesk ticketsに同期されません。Zendeskで作成されFinに同期されたタグのみが適用され、Zendesk ticketに表示されます。
チケットエスカレーション時のタグとデータ属性の同期方法
Finが会話をZendeskにエスカレーションする際：
Workflow属性（Set conversation dataまたはAI category detection (Finの会話トピック自動分類)で設定）はZendeskのticketフィールドとして同期されます。
fin-involvedなどの統合タグが自動的に追加されます。属性は正しい同期のために引き渡しステップの前に設定する必要があります。
データを使ってworkflowsを構築する
Finを展開するすべてのチャネルにはworkflowがあり、顧客が体験する流れを定義します。workflowを使って、データを様々な方法で活用できます...
特定のデータポイントに基づく条件付き体験を作成する
workflow内で分岐を作成し、データを使って次に何が起こるかを定義できます。例えば、VIP users向けに異なる動作を定義することが可能です。
データを入力してZendeskに戻す
Zendeskにデータを戻すには、手動で入力するかAIで分類する方法があります。これはworkflow経由で行う必要があります。
手動でデータを入力するには、「Set conversation data」ステップを追加できます。
AIで入力するには、「AI category detection」ステップを追加できます。
どちらの方法でも、「Hand off to Zendesk agent」または「Create Zendesk ticket」を使う際にデータをZendeskのticketやライブチャットに戻すために行うべきです。
チケットエスカレーション時にすべての属性が正しく転送されるように、workflowの引き渡しステップ前にデータ設定ステップ（例：「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 HelpdeskやアウトバウンドメッセージングなどのIntercom Suite機能は含まれていません。
一方、Intercom SuiteはFin AI AgentとIntercom独自のHelpdesk、アウトバウンドメッセージング、カスタマーサポートツールを組み合わせていますが、Finを現在のZendeskセットアップと統合することはありません。
Fin for Zendeskのみを利用したい場合、2つの選択肢があります：
Intercom Suiteアカウントを削除してから、Fin for Zendeskの無料トライアルにサインアップする、または
Intercom Suiteアカウントからログアウトしてから、別のメールを使ってFin for Zendeskの無料トライアルを開始してください。
よくある質問
同期されたZendesk組織属性を使ってAnalyzeページでFinデータをフィルタリングできますか？
同期されたZendesk組織属性を使ってAnalyzeページでFinデータをフィルタリングできますか？
現時点ではできません。Zendesk組織（会社）属性はAnalyzeセクションのフィルターとして利用できません。
回避策： Fin Messenger workflowを使用している場合（Zendesk Tickets workflowには適用されません）、Organizationフィールドをチェックする分岐を作成し、その条件に基づいてTagを適用できます。そのタグをFin内のレポートに使用できます。