この記事を使って、Zendesk ticketsおよびZendesk messaging接続をAPIキーからOAuth(Open Authorization、Zendeskの安全なサインイン)に2027年1月31日までに移行してください。APIキーでFin for Zendeskを設定した管理者向けです。
IntercomでCan install, configure and delete appsの権限とZendeskの管理者アカウントが必要です。
重要:Zendesk messagingの切り替えが完了するまで、既存のConversations APIキーをZendeskで削除または無効にしないでください。Finは最後にもう一度それを使ってメッセージングチャネルを新しい接続に移行します。
なぜAPIキーからOAuthに切り替える必要があるのですか?
Zendeskは、Zendeskに接続するアプリのためのAPIトークンとAPIキー(ZendeskからコピーしてFinに貼り付ける認証情報)を廃止しています。Finは現在OAuthで接続します:Zendeskにサインインしてアクセスを承認し、キーのコピーや管理は不要です。
APIキーでFin for Zendeskを設定した場合は、2027年1月31日までに両方の接続をOAuthに切り替えてください。その間は現在の接続は引き続き動作します。
どのZendesk接続がAPIキーを使っているか確認する方法
Finには2つのZendesk接続があり、どちらもConnectページにあります。
Zendesk tickets(Connect to Zendesk):Finはこれを使ってZendesk ticketsを読み取り、返信します。
Zendesk messaging(Connect to Zendesk Sunshine):FinはZendesk MessagingおよびFin MessengerからZendeskエージェントへの引き継ぎにこれを使います。
接続がまだAPIキーを使っている場合、Finの上部に2027年1月31日までに再接続するよう促すバナーが表示されます。Connectページのその接続にもAPI key: reconnect by 31 Jan 2027と表示されます。バナーのReconnectを選択すると、再接続が必要な接続に直接移動します。
開始前に必要なものは?
IntercomでのCan install, configure and delete appsの権限。
Finが既に接続されているZendeskアカウントの管理者アカウント。
ブラウザでapp.intercom.comのポップアップを許可してください。
Zendesk ticketsをOAuthに切り替える方法
左のナビでConnectに移動します。
Connect to Zendeskを展開します。
Manage Connectionを選択します。
Reconnectを選択します。
ポップアップウィンドウが開きます。管理者アカウントでZendeskにサインインし、アクセスを承認してください。
ポップアップが閉じてFinに戻ります。Zendesk ticketsに関するバナーは消えます。
Zendesk messagingをOAuthに切り替える方法
Zendesk messagingにはまずZendesk tickets接続が必要です。APIトークンを使っているZendesk tickets接続でも十分ですが、先に切り替えることを推奨します。
左のナビでConnectに移動します。
Connect to Zendesk Sunshineを展開します。
Manage Connectionを選択します。
Reconnectを選択します。
ポップアップウィンドウが開きます。同じZendeskアカウントでサインインし、アクセスを承認してください。
ポップアップが閉じてFinに戻ります。
切り替え後に変わらないことは?
Zendesk tickets: Finは既存の接続を更新します。ワークフロー、Fin Zendeskエージェント、FinのZendeskトリガー、データ同期設定はそのままです。
Zendesk messaging: Finは同じメッセージングチャネルで応答を続け、ワークフローもそのままです。
再設定は不要です。
OAuthへの切り替えトラブルシューティング方法
IntercomでCan install, configure and delete appsの権限があり、Zendeskに管理者としてサインインしていることを確認してください。
app.intercom.comのポップアップが許可されていることを確認してください。
ポップアップにZendesk connection failedが表示されたり、バナーがまだある場合は、再度Reconnectを選択してください。その間は既存の接続は動作し続けます。
失敗後にFinがZendesk messagingチャネルで応答しなくなった場合は、ZendeskのAI > AI agents > Marketplace botsに移動し、Fin AI Agentを選択してチャネルが選択されているか確認してください。
