メインコンテンツにスキップ

FinのZendesk接続をAPIキーからOAuthに切り替える方法

2027年1月31日までにFinのZendesk ticketsおよびmessaging接続をAPIキーからOAuthに切り替えてください。

この記事を使って、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に切り替える方法

  1. 左のナビでConnectに移動します。

  2. Connect to Zendeskを展開します。

  3. Manage Connectionを選択します。

  4. Reconnectを選択します。

  5. ポップアップウィンドウが開きます。管理者アカウントでZendeskにサインインし、アクセスを承認してください。

  6. ポップアップが閉じてFinに戻ります。Zendesk ticketsに関するバナーは消えます。


Zendesk messagingをOAuthに切り替える方法

Zendesk messagingにはまずZendesk tickets接続が必要です。APIトークンを使っているZendesk tickets接続でも十分ですが、先に切り替えることを推奨します。

  1. 左のナビでConnectに移動します。

  2. Connect to Zendesk Sunshineを展開します。

  3. Manage Connectionを選択します。

  4. Reconnectを選択します。

  5. ポップアップウィンドウが開きます。同じZendeskアカウントでサインインし、アクセスを承認してください。

  6. ポップアップが閉じて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を選択してチャネルが選択されているか確認してください。

こちらの回答で解決しましたか?