Passa al contenuto
Italiano
Vai a ShippyPro
  • Non sono presenti suggerimenti perché il campo di ricerca è vuoto.

Come connettere Zendesk per Tracking Solver

I tuoi agenti CS passano da Zendesk a ShippyPro decine di volte al giorno solo per rispondere ai ticket "dov'è il mio ordine?". Connettere i due strumenti elimina questo continuo passaggio manuale: Tracking Solver collega i tuoi ticket Zendesk direttamente alle spedizioni corrispondenti, così il tuo team vede lo stato del tracking, gli aggiornamenti del corriere e il contesto di consegna senza mai uscire da Zendesk.

Riepilogo:

  1. Cosa ti serve prima di iniziare

  2. Step 1 – Apri le impostazioni di Tracking Solver

  3. Step 2 – Connetti Zendesk

  4. Step 3 – Crea il client OAuth in Zendesk

  5. Step 4 – Completa la connessione in ShippyPro

  6. Step 5 – Configura l'abbinamento dei ticket

  7. Risoluzione dei problemi

  8. FAQ

 

1. Cosa ti serve prima di iniziare

Prima di iniziare la configurazione, assicurati di avere:

  • Un account ShippyPro attivo
  • Un piano attivo per Zendesk Support
  • Accesso Admin al tuo account Zendesk — ti servirà per accedere all'Admin Center e connettere Zendesk

⚠️ Importante: La connessione richiede la creazione di un client OAuth nell'Admin Center di Zendesk. Questo è possibile solo con un ruolo Admin di Zendesk. Se hai un accesso a livello Agent, chiedi al tuo amministratore Zendesk di completare gli step 3–4.

2. Step 1 – Apri le impostazioni di Tracking Solver

  1. Vai su Tracking Solver in ShippyPro.
  2. Clicca su Impostazioni nell'angolo in alto a destra della pagina.
   


3. Step 2 – Connetti Zendesk

  1. Nel pannello Impostazioni, trova la scheda dell'integrazione Zendesk.
  2. Clicca su Connect.
  3. Inserisci il tuo subdomain Zendesk nel campo apposito — è la parte prima di .zendesk.com nel tuo URL Zendesk. Per esempio, se accedi a Zendesk su yourcompany.zendesk.com, inserisci yourcompany.
  4. Clicca su Continue.

4. Step 3 – Crea il client OAuth in Zendesk

Questo step si svolge nell'Admin Center di Zendesk. Stai creando un client OAuth in modo che ShippyPro possa autenticarsi in modo sicuro con il tuo account Zendesk.

💡 Suggerimento: Per saltare direttamente alla pagina Zendesk corretta nello step successivo, clicca su Apri impostazioni OAuth Zendesk— ti porta direttamente ad Apps e Integrazioni > API > OAuth Clients nel tuo Admin Center di Zendesk.

  1. Nell'Admin Center di Zendesk, vai su Apps e Integrazioni > API > OAuth Clients.
  2. Clicca su Add OAuth client.
  3. Copia il Client Name, i Redirect URLs e ogni altro valore mostrato in ShippyPro e incollali nei campi corrispondenti in Zendesk.
  4. Clicca su Save in fondo alla pagina.
  5. Dopo il salvataggio, Zendesk mostrerà il Secret per questo client OAuth. Copialo immediatamente — questo valore viene mostrato una sola volta.

⚠️ Importante: Se chiudi questa pagina senza copiare il Secret, dovrai rigenerarlo. Zendesk non mostra più il Secret dopo che hai lasciato la pagina.

5. Step 4 – Completa la connessione in ShippyPro

  1. Torna su ShippyPro.
  2. Incolla il Secret che hai copiato da Zendesk nel campo dedicato.
  3. Clicca su Connect Zendesk.
  4. Apparirà una finestra di conferma che ti chiede di approvare l'integrazione. Clicca su Allow per completare l'autorizzazione.

6. Step 5 – Configura l'abbinamento dei ticket

L'ultimo step consiste nell'indicare a ShippyPro come abbinare i ticket Zendesk in arrivo alle spedizioni nel tuo account.

Scegli il campo che i ticket Zendesk usano per fare riferimento agli ordini:

  • Order number — usalo se i tuoi ticket includono tipicamente il riferimento dell'ordine del cliente
  • Tracking number — usalo se i tuoi ticket includono il codice di tracking del corriere

Se i tuoi ticket non contengono in modo costante nessuno dei due campi, seleziona il più comune. ShippyPro userà come fallback l'abbinamento avanzato — incrociando automaticamente più parametri (email del cliente, riferimento dell'ordine, codice di tracking) per trovare la spedizione corretta.

Clicca su Activate integration.

Attendi qualche minuto — i ticket Zendesk inizieranno a comparire in Tracking Solver collegati alle spedizioni corrispondenti. ✅

7. Risoluzione dei problemi

Problema: La connessione fallisce dopo aver cliccato su Connect Zendesk.

  • Causa: Il Secret è stato inserito in modo errato o è già scaduto (Zendesk invalida i Secret se il client OAuth viene modificato dopo la creazione).
  • Soluzione: Torna in Zendesk Admin Center > Apps e Integrazioni > API > OAuth Clients, apri il client ShippyPro, rigenera il Secret e incolla il nuovo valore in ShippyPro.

Problema: I ticket non compaiono in Tracking Solver dopo aver attivato l'integrazione.

  • Causa: La configurazione dell'abbinamento potrebbe non allinearsi con il contenuto dei tuoi ticket, oppure non ci sono ticket recenti che contengono un riferimento dell'ordine o di tracking riconoscibile.
  • Soluzione: Apri manualmente un ticket Zendesk recente e verifica che contenga un order number o un tracking number. Se non lo contiene, passa all'abbinamento avanzato nelle impostazioni dell'integrazione.

Problema: Il pulsante Apri impostazioni OAuth non apre la pagina corretta.

  • Causa: La scorciatoia usa il tuo subdomain per costruire l'URL. Se il subdomain è stato inserito in modo errato, aprirà il workspace sbagliato.
  • Soluzione: Torna indietro, clicca su Disconnetti, reinserisci con attenzione il tuo subdomain e riprova. Il tuo subdomain Zendesk è sempre la parte prima di .zendesk.com — controllalo direttamente nella barra degli indirizzi del browser quando sei loggato in Zendesk.

Problema: Il client OAuth è stato salvato in Zendesk ma il Secret non è stato copiato.

  • Causa: Zendesk mostra il Secret una sola volta, nella pagina immediatamente successiva al salvataggio.
  • Soluzione: In Zendesk Admin Center, apri il client OAuth che hai creato, clicca su Rigenera Secret, copia il nuovo valore e incollalo in ShippyPro.

8. FAQ

D: Mi serve un piano Zendesk specifico per connettermi?
R: No. L'API OAuth usata per questa integrazione è disponibile su tutti i piani Zendesk Support, inclusi Suite Team, Growth, Professional ed Enterprise.

D: La connessione funziona con più subdomain Zendesk?
R: Attualmente ShippyPro supporta una connessione Zendesk per account ShippyPro.

D: Cosa succede ai ticket esistenti quando l'integrazione è attiva?
R: ShippyPro inizierà ad abbinare i nuovi ticket man mano che arrivano. I ticket storici degli ultimi 7 giorni già presenti nella tua inbox Zendesk vengono collegati retroattivamente. I ticket eliminati non verranno importati.

D: Posso cambiare il campo di abbinamento dei ticket dopo l'attivazione?
R: Sì. Vai su Tracking Solver > Impostazioni > Zendesk e aggiorna il campo di abbinamento in qualsiasi momento. Tutti i ticket abbinati verranno rimossi e verrà eseguita immediatamente una nuova sincronizzazione.

D: Cosa controlla esattamente l'"abbinamento avanzato"?
R: Quando nessun singolo campo trova una corrispondenza chiara, ShippyPro incrocia simultaneamente l'indirizzo email del cliente, il numero di riferimento dell'ordine e il numero di tracking per trovare la spedizione più probabile. Funziona bene per i ticket in cui i clienti scrivono senza includere un riferimento strutturato.

D: Cosa succede se disconnetto Zendesk?
R: L'integrazione si interrompe immediatamente. I ticket già collegati alle spedizioni in Tracking Solver verranno rimossi e la sincronizzazione dei ticket con il tuo account Zendesk verrà interrotta immediatamente. Per riconnetterti dovrai ripetere la procedura di configurazione OAuth.

D: Quanto tempo richiede la prima sincronizzazione?
R: Tipicamente 30 minuti dal momento in cui clicchi su Attiva integrazione. Se non compare nessun ticket dopo qualche ora, contatta il nostro Team di Supporto.