Ce informații ar trebui să ofer atunci când raportez o problemă de integrare la suportul Polyosync?
Atunci când raportezi o problemă de integrare, furnizarea de informații clare și relevante ajută echipa de suport să înțeleagă serviciul afectat, să reproducă problema, acolo unde este posibil, și să identifice cauza probabilă.
O solicitare de suport utilă ar trebui să descrie ce ai încercat, ce te așteptai și ce s-a întâmplat de fapt.
Informații de inclus
1. Numele integrării
Identifică aplicația sau serviciul extern implicat.
2. Descrierea problemei
Explică operațiunea care a eșuat sau a produs un rezultat neașteptat.
3. Comportamentul așteptat
Descrie ce ar fi trebuit să se întâmple.
4. Comportamentul real
Descrie ce s-a întâmplat în schimb.
5. Mesaj de eroare
Include textul exact al erorii sau codul de stare, dacă este disponibil.
6. Marcaj temporal aproximativ
Furnizează data, ora și fusul orar când a avut loc problema.
7. Operațiunea afectată
Identifică acțiunea de integrare relevantă, fluxul de lucru, automatizarea sau procesul de afaceri.
8. Frecvența
Explică dacă problema apare constant sau intermitent.
9. Schimbări recente
Menționează schimbările recente de cont, permisiuni, configurație sau autorizare.
10. Depanare deja încercată
Descrie pașii urmați înainte de a contacta suportul.
11. Impactul asupra afacerii
Explică dacă problema împiedică o operațiune critică, afectează clienții sau cauzează întârzieri.
12. Dovezi de susținere
Include capturi de ecran relevante sau detalii de diagnostic non-sensibile, atunci când sunt disponibile.
Exemplu de solicitare de suport
Subiect: Problemă de conectare a integrării
Integrare: [Numele serviciului extern]
Operațiunea afectată: [Descrierea operațiunii]
Problema a început: [Data și ora cu fus orar]
Rezultatul așteptat: [Ce ar trebui să se întâmple]
Rezultatul real: [Ce s-a întâmplat]
Mesaj de eroare: [Mesajul de eroare exact]
Schimbări recente: [Schimbări relevante, dacă există]
Depanare completă: [Pașii deja încercați]
Impactul asupra afacerii: [Descrierea operațiunilor afectate]
Ce informații nu ar trebui niciodată să fie partajate?
Nu include:
1. Parole.
2. Chei API.
3. Tokenuri de acces OAuth.
4. Tokenuri de reîmprospătare OAuth.
5. Secrete de client.
6. Secrete de semnare Webhook.
7. Credite de autentificare private.
8. Informații personale inutile ale clienților.
9. Documente de afaceri sensibile care nu sunt legate de problemă.
Dacă o captură de ecran conține informații confidențiale, redactează-o înainte de a o partaja.
Ar trebui să deconectez integrarea înainte de a contacta suportul?
Nu automat.
Deconectarea sau reautorizarea unei integrări poate schimba starea acesteia și poate face problema originală mai greu de investigat.
Dacă integrarea este suspectată de activitate neautorizată, prioritizează conținerea adecvată a securității.
Ce se întâmplă dacă problema afectează o operațiune importantă a afacerii?
Descrie clar impactul asupra afacerii și dacă operațiunea este complet blocată sau doar parțial afectată.
Ce se întâmplă dacă furnizorul extern are o întrerupere?
Include orice informații relevante despre starea furnizorului și timpul aproximativ în care a început problema.
Poate suportul să garanteze recuperarea operațiunilor externe eșuate?
Recuperarea depinde de operațiune, comportamentul furnizorului extern și mecanismele disponibile de retry sau recuperare.
Nu presupune că fiecare operațiune eșuată poate fi reîncercată automat.
Abordare recomandată
Trimite un raport concis, dar complet, cu eroarea exactă, integrarea afectată, marcajele temporale relevante și impactul asupra afacerii.
Aceasta ajută la reducerea discuțiilor inutile și susține o investigație mai eficientă.