Utilisez cet article pour migrer vos connexions Zendesk tickets et Zendesk messaging des clés API à OAuth (Open Authorization, la connexion sécurisée de Zendesk) avant le 31 janvier 2027. Il s'adresse aux administrateurs qui ont configuré Fin pour Zendesk avec des clés API.
Vous avez besoin de la permission Can install, configure and delete apps dans Intercom et d'un compte administrateur dans Zendesk.
Important : Ne supprimez pas et ne désactivez pas votre clé API Conversations existante dans Zendesk tant que la migration pour Zendesk messaging n'est pas terminée. Fin l'utilise une dernière fois pour transférer vos canaux de messagerie vers la nouvelle connexion.
Pourquoi devez-vous passer des clés API à OAuth ?
Zendesk retire les jetons API et les clés API (identifiants que vous copiez depuis Zendesk et collez dans Fin) pour les applications qui se connectent à Zendesk. Fin se connecte désormais avec OAuth : vous vous connectez à Zendesk et approuvez l'accès, sans clé à copier ou gérer.
Si vous avez configuré Fin pour Zendesk avec des clés API, passez les deux connexions à OAuth avant le 31 janvier 2027. Vos connexions actuelles continueront de fonctionner en attendant.
Comment vérifier quelles connexions Zendesk utilisent des clés API
Fin a deux connexions Zendesk, toutes deux sur la page Connect :
Zendesk tickets (Connect to Zendesk) : Fin l'utilise pour lire et répondre aux tickets Zendesk.
Zendesk messaging (Connect to Zendesk Sunshine) : Fin l'utilise pour Zendesk Messaging et pour les transferts du Fin Messenger vers vos agents Zendesk.
Si une connexion utilise encore une clé API, une bannière en haut de Fin vous demande de vous reconnecter avant le 31 janvier 2027. Cette connexion sur la page Connect affiche aussi API key: reconnect by 31 Jan 2027. Sélectionnez Reconnect sur la bannière pour accéder directement à la connexion concernée.
Que faut-il avant de commencer ?
La permission Can install, configure and delete apps dans Intercom.
Un compte administrateur pour le compte Zendesk auquel Fin est déjà connecté.
Les popups autorisés pour app.intercom.com dans votre navigateur.
Comment passer les Zendesk tickets à OAuth
Allez dans Connect dans la navigation de gauche.
Développez Connect to Zendesk.
Sélectionnez Manage Connection.
Sélectionnez Reconnect.
Une fenêtre popup s'ouvre. Connectez-vous à Zendesk avec votre compte administrateur et approuvez l'accès.
La popup se ferme et vous revenez à Fin. La bannière concernant les Zendesk tickets disparaît.
Comment passer Zendesk messaging à OAuth
Zendesk messaging nécessite d'abord la connexion Zendesk tickets en place. Une connexion Zendesk tickets utilisant encore un jeton API suffit, mais nous recommandons de la passer d'abord.
Allez dans Connect dans la navigation de gauche.
Développez Connect to Zendesk Sunshine.
Sélectionnez Manage Connection.
Sélectionnez Reconnect.
Une fenêtre popup s'ouvre. Connectez-vous au même compte Zendesk et approuvez l'accès.
La popup se ferme et vous revenez à Fin.
Qu'est-ce qui reste identique après la migration ?
Zendesk tickets : Fin met à jour votre connexion existante. Vos workflows, votre agent Fin Zendesk, les déclencheurs Zendesk de Fin et vos paramètres de synchronisation des données restent inchangés.
Zendesk messaging : Fin continue de répondre sur les mêmes canaux de messagerie, et vos workflows restent inchangés.
Vous n'avez rien à reconfigurer.
Comment résoudre les problèmes lors de la migration vers OAuth
Vérifiez que vous avez la permission Can install, configure and delete apps dans Intercom, et que vous êtes connecté à Zendesk en tant qu'administrateur.
Vérifiez que les popups sont autorisés pour app.intercom.com.
Si la popup affiche Zendesk connection failed, ou si la bannière est toujours présente, sélectionnez à nouveau Reconnect. Votre connexion existante continue de fonctionner en attendant.
Si Fin cesse de répondre sur un canal Zendesk messaging après une tentative échouée, allez dans AI > AI agents > Marketplace bots dans Zendesk, sélectionnez Fin AI Agent, et vérifiez que le canal est sélectionné.
