Dépanner le connecteur Zendesk Support
Cette page décrit les erreurs courantes lors de l'utilisation du connecteur Zendesk Support.
Pour des conseils généraux de dépannage qui s’appliquent à tous les pipelines d’ingestion gérés, consultez Dépanner les pipelines d’ingestion gérés.
La ressource n’existe pas ou l’accès est interdit
Message d'erreur :
Error suggests either resource does not exist or access to resource is forbidden
**Cause :** Votre plan Zendesk actuel pourrait ne pas avoir accès à l'entité en cours d'ingestion.
Solution : Assurez-vous que votre plan Zendesk actuel a accès à l'entité en cours d'ingestion. Certaines tables et fonctionnalités ne sont disponibles que sur certains niveaux d'abonnement Zendesk.
Le pipeline s'exécute trop lentement
Symptôme : Le pipeline d'ingestion s'exécute plus lentement que prévu.
Cause : Zendesk a des limites strictes de taux d’API, et l’ingestion de trop de tables en même temps peut provoquer un étranglement.
**Solution :** Assurez-vous que peu de tables sont ingérées simultanément afin d'éviter la limitation de débit. Vous pouvez répartir les tables sur plusieurs pipelines et les planifier à différents moments pour respecter les limites de débit de Zendesk.
Je continue d'être redirigé(e) vers la page de connexion de Zendesk après avoir saisi mon identifiant client et mon secret client
Veuillez confirmer que vous utilisez la valeur correcte pour l'**identifiant client**. La valeur correcte est le **champ Identifiant** du client OAuth dans la console d'administration Zendesk. Il s'agit du nom interne, orienté code (par exemple, my_new_app), et non du nom d'affichage montré aux utilisateurs finaux. La saisie du nom d'affichage au lieu de l'identifiant provoque la boucle de redirection.
Pour confirmer la valeur :
- Dans Zendesk, allez à Admin > Apps and Integrations > APIs > Zendesk API > OAuth Clients .
- Ouvrez le client OAuth et copiez la valeur du champ Identifiant (pas le nom du client).
- Saisissez à nouveau cette valeur comme **ID client** dans Databricks.
Si les informations d'identification sont correctes et que le problème persiste, créez un ticket de support avec l'ID de votre workspace, l'ID de pipeline et le message d'erreur complet. Consultez Obtenir de l'aide.
Je rencontre des erreurs sur un Endpoint d'API Zendesk spécifique
Le comportement de certains Endpoint de l'API Zendesk n'est pas contrôlé par le connecteur. Si l'ajustement de vos paramètres de synchronisation ne résout pas le problème, créez un ticket de support avec l'ID de votre Workspace, l'ID du pipeline et le message d'erreur complet. Voir Obtenir de l'aide.
Un champ d’un enregistrement d’audit ingéré est vide ou obsolète
Symptôme : Un champ imbriqué dans la table ticket_audits, tel que la transcription du chat dans l'événement ChatStartedEvent, est vide ou contient moins d'enregistrements dans la table de destination que ce que l'API Zendesk renvoie pour le même audit. Aucune erreur n'est signalée, et les autres enregistrements sont ingérés correctement.
Cause : Zendesk documente les audits de tickets comme immuables, mais certains champs d'un audit peuvent continuer à changer après la création de l'audit. Puisque le connecteur ingère ticket_audits de manière incrémentielle à l'aide du curseur created_at, il lit chaque audit une seule fois et ne le revisite pas, de sorte que le connecteur ne détecte pas les modifications apportées après l'ingestion. C'est une limitation de l'API Zendesk plutôt que du connecteur. Pour plus d'informations, consultez Les enregistrements d'audit peuvent être modifiés après la création.
Solution : Effectuez une refresh complète de la table ticket_audits pour recharger les valeurs actuelles de Zendesk.