Come possiamo aiutarti?

Quando segnali un problema di integrazione, fornire informazioni chiare e pertinenti aiuta il team di supporto a comprendere il servizio interessato, a riprodurre il problema quando possibile e a identificare la causa probabile. Una richiesta di supporto utile dovrebbe descrivere cosa hai tentato, cosa ti aspettavi e cosa è realmente successo. Informazioni da includere 1. Nome dell'integrazione Identifica l'applicazione o il servizio esterno coinvolto. 2. Descrizione del problema Spiega l'operazione che è fallita o ha prodotto un risultato inaspettato. 3. Comportamento atteso Descrivi cosa avrebbe dovuto succedere. 4. Comportamento reale Descrivi cosa è successo invece. 5. Messaggio di errore Includi il testo esatto dell'errore o il codice di stato se disponibile. 6. Timestamp approssimativo Fornisci la data, l'ora e il fuso orario in cui si è verificato il problema. 7. Operazione interessata Identifica l'azione di integrazione, il flusso di lavoro, l'automazione o il processo aziendale pertinente. 8. Frequenza Spiega se il problema si verifica in modo costante o intermittente. 9. Modifiche recenti Menziona le recenti modifiche a account, autorizzazioni, configurazione o autorizzazione. 10. Risoluzione dei problemi già tentata Descrivi i passaggi intrapresi prima di contattare il supporto. 11. Impatto sul business Spiega se il problema impedisce un'operazione critica, influisce sui clienti o causa ritardi. 12. Prove di supporto Includi screenshot pertinenti o dettagli diagnostici non sensibili quando disponibili. Esempio di richiesta di supporto Oggetto: Problema di connessione all'integrazione Integrazione: [Nome del servizio esterno] Operazione interessata: [Descrizione dell'operazione] Il problema è iniziato: [Data e ora con fuso orario] Risultato atteso: [Cosa dovrebbe succedere] Risultato reale: [Cosa è successo] Messaggio di errore: [Messaggio di errore esatto] Modifiche recenti: [Modifiche pertinenti, se presenti] Risoluzione dei problemi completata: [Passaggi già tentati] Impatto sul business: [Descrizione delle operazioni interessate] Quali informazioni non dovrebbero mai essere condivise? Non includere: 1. Password. 2. Chiavi API. 3. Token di accesso OAuth. 4. Token di aggiornamento OAuth. 5. Segreti del cliente. 6. Segreti di firma Webhook. 7. Credenziali di autenticazione private. 8. Informazioni personali non necessarie sui clienti. 9. Documenti aziendali sensibili non correlati al problema. Se uno screenshot contiene informazioni riservate, oscuralo prima di condividerlo. Dovrei disconnettere l'integrazione prima di contattare il supporto? Non automaticamente. Disconnettere o riautorizzare un'integrazione può cambiare il suo stato e rendere più difficile l'indagine sul problema originale. Se si sospetta che l'integrazione abbia attività non autorizzate, dai priorità a una corretta contenimento della sicurezza. Cosa succede se il problema influisce su un'importante operazione aziendale? Descrivi chiaramente l'impatto sul business e se l'operazione è completamente bloccata o solo parzialmente interessata. Cosa succede se il fornitore esterno sta vivendo un'interruzione? Includi eventuali informazioni pertinenti sullo stato del fornitore e il tempo approssimativo in cui è iniziato il problema. Il supporto può garantire il recupero delle operazioni esterne fallite? Il recupero dipende dall'operazione, dal comportamento del fornitore esterno e dai meccanismi di ripetizione o recupero disponibili. Non presumere che ogni operazione fallita possa essere riprodotta automaticamente. Approccio raccomandato Invia un rapporto conciso ma completo con l'errore esatto, l'integrazione interessata, i timestamp pertinenti e l'impatto sul business. Questo aiuta a ridurre il ping-pong inutile e supporta un'indagine più efficace.