Comment pouvons-nous vous aider ?

Lors du signalement d'un problème d'intégration, fournir des informations claires et pertinentes aide l'équipe de support à comprendre le service concerné, à reproduire le problème lorsque cela est possible et à identifier la cause probable. Une demande de support utile doit décrire ce que vous avez essayé, ce que vous attendiez et ce qui s'est réellement passé. Informations à inclure 1. Nom de l'intégration Identifiez l'application ou le service externe concerné. 2. Description du problème Expliquez l'opération qui a échoué ou qui a produit un résultat inattendu. 3. Comportement attendu Décrivez ce qui aurait dû se passer. 4. Comportement réel Décrivez ce qui s'est passé à la place. 5. Message d'erreur Incluez le texte exact de l'erreur ou le code d'état si disponible. 6. Horodatage approximatif Fournissez la date, l'heure et le fuseau horaire lorsque le problème s'est produit. 7. Opération affectée Identifiez l'action d'intégration, le flux de travail, l'automatisation ou le processus métier concerné. 8. Fréquence Expliquez si le problème se produit de manière constante ou intermittente. 9. Changements récents Mentionnez les changements récents de compte, de permissions, de configuration ou d'autorisation. 10. Dépannage déjà tenté Décrivez les étapes prises avant de contacter le support. 11. Impact sur l'entreprise Expliquez si le problème empêche une opération critique, affecte les clients ou cause des retards. 12. Preuves à l'appui Incluez des captures d'écran pertinentes ou des détails de diagnostic non sensibles lorsque cela est possible. Exemple de demande de support Objet : Problème de connexion d'intégration Intégration : [Nom du service externe] Opération affectée : [Description de l'opération] Le problème a commencé : [Date et heure avec fuseau horaire] Résultat attendu : [Ce qui devrait se passer] Résultat réel : [Ce qui s'est passé] Message d'erreur : [Message d'erreur exact] Changements récents : [Changements pertinents, le cas échéant] Dépannage complété : [Étapes déjà tentées] Impact sur l'entreprise : [Description des opérations affectées] Quelles informations ne doivent jamais être partagées ? N'incluez pas : 1. Mots de passe. 2. Clés API. 3. Jetons d'accès OAuth. 4. Jetons de rafraîchissement OAuth. 5. Secrets de client. 6. Secrets de signature Webhook. 7. Informations d'authentification privées. 8. Informations personnelles inutiles sur les clients. 9. Documents commerciaux sensibles non liés au problème. Si une capture d'écran contient des informations confidentielles, masquez-les avant de les partager. Dois-je déconnecter l'intégration avant de contacter le support ? Pas automatiquement. Déconnecter ou réautoriser une intégration peut changer son état et rendre l'enquête sur le problème original plus difficile. Si l'intégration est suspectée d'activité non autorisée, priorisez la containment de sécurité appropriée. Que se passe-t-il si le problème affecte une opération commerciale importante ? Décrivez clairement l'impact sur l'entreprise et si l'opération est complètement bloquée ou seulement partiellement affectée. Que se passe-t-il si le fournisseur externe connaît une panne ? Incluez toute information pertinente sur l'état du fournisseur et le moment approximatif où le problème a commencé. Le support peut-il garantir la récupération des opérations externes échouées ? La récupération dépend de l'opération, du comportement du fournisseur externe et des mécanismes de réessai ou de récupération disponibles. Ne supposez pas que chaque opération échouée peut être rejouée automatiquement. Approche recommandée Soumettez un rapport concis mais complet avec l'erreur exacte, l'intégration affectée, les horodatages pertinents et l'impact sur l'entreprise. Cela aide à réduire les allers-retours inutiles et soutient une enquête plus efficace.