Integrazione ShippyPro: l’agente AI risponde sul tracking con i dati del corriere
L’integrazione ShippyPro di Orygo AI collega l’agente AI del tuo ecommerce al tuo account ShippyPro con una API key, disponibile con il piano Enterprise. Quando un cliente chiede dov’è il suo pacco in chat, per email o su WhatsApp, l’agente legge prima l’ordine dallo store con email e numero d’ordine, ne prende il numero di tracking e chiede a ShippyPro stato del corriere, data di spedizione, consegna stimata e fino a 15 eventi del viaggio. Poi risponde con parole sue, seguendo le tue regole su ritardi e pacchi fermi. L’azione è in sola lettura.
1
azione in sola lettura: tracking per numero del corriere
15
eventi di tracking letti al massimo, con data, stato e luogo
3 date
spedizione, consegna stimata e ultimo evento
31,9%
delle procedure di assistenza di Yeppon erano “stato ordine”
Dato Yeppon: 3.132 procedure eseguite in 2.932 sessioni, 21 settembre - 20 ottobre 2026. Leggi il caso Yeppon.
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Cosa fa l’agente AI con ShippyPro?
Con ShippyPro collegato, Orygo AI ha un’azione: legge una spedizione a partire dal numero di tracking del corriere, per esempio un codice UPS che inizia con 1Z. Riceve stato, date, consegna stimata e cronologia degli eventi, e li usa per rispondere al cliente in qualsiasi conversazione, dalla chat del sito a WhatsApp fino ai ticket di Zendesk e Freshdesk.
ShippyPro non cerca per numero d’ordine: l’ordine, con articoli, importi e numero di tracking, l’agente lo legge dallo store su cui vendi. Le due integrazioni lavorano in coppia. Lo store dice cosa ha comprato il cliente e con quale numero è partito il pacco; ShippyPro dice dove si trova adesso e quando arriverà.
Questa pagina spiega l’integrazione ShippyPro nel dettaglio: dati letti, da dove arriva il numero di tracking, collegamento e differenze con Qapla’. Il flusso completo del tracking, con i ritardi, i pacchi persi e i canali, è nella pagina tracking ordini automatico con l’AI.
Quali dati del corriere legge Orygo AI da ShippyPro?
Da ShippyPro Orygo AI legge sette informazioni sulla spedizione: stato, nome del corriere, data di spedizione, consegna stimata, data dell’ultimo evento, l’ultimo evento con data, stato e luogo, e la cronologia fino a 15 eventi. Bastano per rispondere alle tre domande più frequenti: dov’è il pacco, quando arriva, perché non si muove.
| Dato | Cosa contiene | Come lo usa l’agente nella risposta |
|---|---|---|
| Stato | Lo stato attuale della spedizione | “Il pacco è in transito” |
| Corriere | Il nome del corriere | “Viaggia con UPS” |
| Data di spedizione | Quando il pacco è partito | “È partito martedì dal nostro magazzino” |
| Consegna stimata | La data di consegna prevista | “La consegna è prevista per giovedì” |
| Data dell’ultimo evento | Quando il corriere ha registrato l’ultimo passaggio | Capire se il pacco è fermo e da quanto |
| Ultimo evento | Data, stato e luogo | “Ieri sera era nel centro di smistamento di Piacenza” |
| Cronologia | Fino a 15 eventi, ciascuno con data, stato e luogo | Ricostruire il viaggio quando il cliente chiede cosa è successo |
La data dell’ultimo evento è il dato più utile per i casi difficili. Confrontata con la data di oggi, dice all’agente se il pacco si sta muovendo o se è fermo da giorni, e quindi se basta una risposta o serve passare il caso al team. La soglia la decidi tu, nella procedura.
La risposta di ShippyPro riguarda solo il viaggio del pacco. Articoli, importi e indirizzo parziale (città, regione e paese) arrivano dall’ordine letto sullo store: Shopify, WooCommerce, PrestaShop, Magento, BigCommerce o Salesforce Commerce Cloud.
Da dove prende l’agente il numero di tracking?
L’azione ShippyPro riceve solo il numero di tracking e non controlla l’email del cliente. Per questo il flusso parte dallo store: l’agente chiede email e numero d’ordine, legge l’ordine sulla tua piattaforma ecommerce, dove l’email deve combaciare con quella dell’acquisto, e passa a ShippyPro il numero di tracking registrato su quell’ordine verificato.
[01]
[02]
L’agente verifica l’ordine sullo storeCon email e numero d’ordine. Se l’email non coincide, la risposta è “ordine non trovato”.[03]
Prende il numero di trackingDall’ordine appena letto, insieme a stato dell’ordine e articoli.[04]
Legge la spedizione su ShippyProE risponde con stato, consegna stimata e ultimo passaggio, seguendo la tua procedura.
Se il cliente scrive direttamente il numero di tracking
Tecnicamente l’azione accetta qualsiasi numero di tracking, come il sito di un corriere. Nella procedura decidi tu come comportarti: l’agente può usare il codice scritto dal cliente così com’è, oppure chiedere prima email e numero d’ordine e usare solo il numero letto dall’ordine verificato. La seconda strada è quella prevista dall’integrazione, ed è la più prudente se la cronologia mostra località che preferisci non far vedere a chi non ha fatto l’ordine.
Una procedura di tracking con ShippyPro
Ecco un esempio di procedura scritta in linguaggio naturale; nomi delle azioni, soglie e team sono di esempio e vanno adattati al tuo store.
Traccia ordine con ShippyPro
- 1Quando il cliente chiede dov’è il suo ordine, chiedi l’email usata per l’acquisto e il numero d’ordine.
- 2Leggi l’ordine con @Leggi ordine. Se non è ancora spedito, di’ quando è stato fatto e che il numero di tracking sarà disponibile alla partenza del pacco.
- 3Se l’ordine ha un numero di tracking, controlla la spedizione con @Tracking ShippyPro usando quel numero.
- 4Rispondi con stato, consegna stimata e ultimo evento, con data e luogo.
- 5Se l’ultimo evento risale a più di 5 giorni lavorativi fa, scusati e passa il caso al team logistica con il numero di tracking.
- 6Se il cliente scrive solo un numero di tracking, chiedi anche email e numero d’ordine prima di cercarlo.
Come si scrivono e si modificano le procedure: procedure in linguaggio naturale. Come avviene il passaggio a una persona, live o con un ticket: passaggio dal chatbot all’operatore.
Come si collega ShippyPro a Orygo AI?
Per collegare ShippyPro a Orygo AI serve una API key del tuo account ShippyPro, che richiede il piano Enterprise. La generi nella sezione API di ShippyPro, la incolli nelle integrazioni del tuo agente in Orygo AI e accendi l’azione di tracking. Non serve scrivere codice.
[01]
Verifica il pianoOrygo AI richiede ShippyPro Enterprise. Secondo la pagina prezzi di ShippyPro (consultata a novembre 2026) l’accesso completo alle API multicorriere è incluso nel piano Enterprise e non nel piano Professional.[02]
Genera la chiaveIn ShippyPro apri Integrazioni › API e clicca Add API. ShippyPro permette più chiavi sullo stesso account: crearne una dedicata a Orygo AI ti aiuta a riconoscerla fra le altre integrazioni.[03]
Scegli il tipo giustoShippyPro chiede il tipo di chiave: Full Access, Maps o PII Excluded. La chiave Maps serve solo per la mappa dei punti di ritiro e non va bene per il tracking.[04]
Incollala nell’agenteIn Orygo AI apri le integrazioni dell’agente, scegli ShippyPro e inserisci la chiave. La credenziale appartiene a quell’agente: se hai più agenti, ognuno ha la sua.[05]
Accendi e provaAttiva l’azione, citala nella procedura di tracking e prova le domande vere dei clienti nel playground, dove vedi ogni chiamata a ShippyPro fatta dall’agente.
Generazione e tipi di chiave sono descritti nella guida alle API di ShippyPro (consultata a novembre 2026). Come l’agente sceglie quale azione usare: azioni e strumenti AI. I passaggi dal contratto al lancio: come si va live.
ShippyPro o Qapla’: cosa cambia per l’agente AI?
Con entrambe le piattaforme Orygo AI legge lo stato del corriere, la consegna stimata e fino a 15 eventi di tracking. La differenza è il punto di partenza: Qapla’ permette anche la ricerca per email e riferimento d’ordine, con il controllo sull’email del destinatario; ShippyPro lavora solo sul numero di tracking, quindi l’ordine si verifica prima sullo store.
| ShippyPro | Qapla’ | |
|---|---|---|
| Credenziale | API key, con piano Enterprise | API key privata del canale |
| Azioni | 1: tracking per numero | 2: ordine con spedizione, tracking per numero |
| Ricerca per numero d’ordine | No: l’ordine si legge dallo store | Sì, con email e riferimento |
| Controllo sull’email | Sullo store, prima del tracking | Su Qapla’, sull’email del destinatario |
| Articoli e importi | Dallo store | Da Qapla’, fino a 10 righe, oppure dallo store |
| Consegna stimata | Sì | Sì |
| Cronologia | Fino a 15 eventi con data, stato e luogo | Fino a 15 eventi con data, stato, dettaglio e luogo |
La scelta fra le due non la fa l’agente: dipende dalla piattaforma di spedizione che usi già. Orygo AI si adatta a quella, e le procedure di tracking cambiano solo nel primo passaggio. Tutte le integrazioni sono nella pagina integrazioni di Orygo AI.
Cosa resta a ShippyPro e cosa fa Orygo AI?
ShippyPro resta la piattaforma con cui crei le etichette, segui i corrieri e informi i clienti con pagina di tracking e notifiche. Orygo AI entra quando il cliente fa una domanda: legge la spedizione su ShippyPro, la spiega con parole sue nella conversazione e applica le tue regole su ritardi, pacchi fermi e passaggi al team.
ShippyPro
Etichette, corrieri collegati, tracking, pagina di tracking e notifiche di spedizione: tutto resta configurato come oggi, nel tuo account.
Orygo AI
Risponde alle domande sul tracking in chat, email, WhatsApp, Instagram, Messenger, Amazon e nei ticket di Zendesk e Freshdesk.
Il tuo team
Riceve solo i casi che la procedura gli passa, con ordine e tracking già nel ticket, e ritrova le conversazioni nell’helpdesk di Orygo AI.
Perché serve anche con le notifiche attive? Perché il cliente che vede lo stesso stato da giorni scrive comunque all’assistenza. In Yeppon, ecommerce di elettronica servito da Orygo AI, la procedura “stato ordine” è stata la più usata: il 31,9% delle procedure di assistenza eseguite fra il 21 settembre e il 20 ottobre 2026 (caso Yeppon).
Domande frequenti sull’integrazione ShippyPro
Serve il piano Enterprise di ShippyPro per usare Orygo AI?
Sì. L’integrazione usa una API key di ShippyPro, e Orygo AI la richiede con il piano Enterprise. La pagina prezzi di ShippyPro, a novembre 2026, indica l’accesso completo alle API multicorriere nel piano Enterprise e non nel piano Professional.
Il cliente può chiedere il tracking con il solo numero d’ordine?
Sì, insieme all’email dell’acquisto. L’agente legge l’ordine dallo store, prende il numero di tracking registrato e lo passa a ShippyPro. Il cliente non deve cercare il codice del corriere nelle email di spedizione.
Perché l’azione ShippyPro non chiede l’email del cliente?
Perché lavora solo sul numero di tracking, come il sito di un corriere. Il controllo sull’identità avviene prima, sullo store, dove l’email deve combaciare con quella dell’ordine. Per questo il flusso consigliato usa il numero di tracking letto dall’ordine verificato.
Quanti passaggi del tracking vede l’agente?
Fino a 15 eventi per spedizione, ciascuno con data, stato e luogo, più l’ultimo evento, la data di spedizione e la consegna stimata. Bastano per ricostruire il viaggio del pacco e capire da quanti giorni è fermo.
Con quali corrieri funziona l’integrazione ShippyPro di Orygo AI?
Con i corrieri che hai collegato al tuo account ShippyPro. Orygo AI non si collega ai corrieri uno per uno: legge stato e cronologia attraverso ShippyPro, che li ha già integrati.
Orygo AI usa i dati di ShippyPro anche nei ticket Zendesk o Freshdesk?
Sì. L’azione di tracking ShippyPro è disponibile in ogni conversazione dell’agente, compresi i ticket di Zendesk e Freshdesk collegati. L’agente risponde sul ticket con stato e consegna stimata e imposta lo stato che hai scelto, per esempio risolto dopo la risposta.
Collega Qapla’ a Orygo AI con la API key del canale: l’agente AI legge ordine e spedizione e risponde ai clienti su dov’è il pacco, in chat e su WhatsApp.
Scopri qapla’Vuoi che l’AI risponda sul tracking con i dati del tuo ShippyPro?
Prenota una demo: ti mostriamo l’agente AI di Orygo mentre verifica un ordine sul tuo store, legge la spedizione su ShippyPro e risponde con stato, consegna stimata e ultimo passaggio, e insieme scriviamo la procedura di tracking con le tue regole.