Orygo AI
Prenota una demo
Logistica

Integrazione Qapla’: il chatbot AI che risponde sul tracking con i dati di Qapla’

L’integrazione Qapla’ di Orygo AI collega l’agente AI del tuo ecommerce al Control Panel di Qapla’ con la API key privata del canale. Quando un cliente chiede “dov’è il mio ordine?” in chat, per email o su WhatsApp, l’agente cerca l’ordine con email e riferimento, controlla che l’email sia quella del destinatario e risponde con stato del corriere, consegna stimata e ultimi passaggi del pacco. Se il cliente ha solo il numero di spedizione, l’agente cerca direttamente quello. Le due azioni sono in sola lettura: Orygo AI legge da Qapla’, non crea spedizioni e non modifica ordini.

Prenota una demoCome si collega
  • 2

    azioni in sola lettura: ordine con spedizione, tracking per numero

  • 15

    eventi di tracking letti al massimo per ogni spedizione

  • 10

    righe d’ordine lette al massimo, con SKU, quantità e prezzo

  • 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

Cosa fa l’agente AI con Qapla’?

Con Qapla’ collegato, Orygo AI ha due azioni per rispondere sul post-vendita: la prima legge ordine e spedizione insieme partendo da email e riferimento d’ordine, la seconda legge una spedizione partendo dal numero di tracking del corriere. L’agente le usa in qualsiasi conversazione, dalla chat del sito a WhatsApp fino ai ticket di Zendesk e Freshdesk, e ognuna si accende o si spegne per conto suo.

// Le due azioni dell’integrazione Qapla’ di Orygo AI
AzioneCosa serve al clienteCosa riceve l’agenteTipo
Leggi ordine e spedizioneEmail e riferimento dell’ordine, per esempio ORD-12345L’ordine completo e, se esiste già, la spedizione con la cronologia del trackingLettura
Leggi trackingIl numero di tracking del corriere, per esempio 080010017684806La spedizione collegata a quel numeroLettura

Perché passare da Qapla’ se lo store ha già l’ordine? Lo store sa che il pacco è partito e con quale numero di tracking. Qapla’ sa dove si trova adesso, cosa ha registrato il corriere a ogni passaggio e quando è prevista la consegna. È la differenza fra rispondere “il tuo ordine è stato spedito” e rispondere “il pacco è in consegna oggi a Bologna”.

Questa pagina spiega l’integrazione Qapla’ nel dettaglio: campi letti, scelta fra le due ricerche, collegamento e protezione dei dati. Il flusso completo del tracking, con i dati dalle sei piattaforme ecommerce, i ritardi, i pacchi persi e i canali, è nella pagina tracking ordini automatico con l’AI.

Dati

Quali dati legge Orygo AI da un ordine su Qapla’?

Con una sola chiamata Orygo AI riceve da Qapla’ l’ordine e la spedizione collegata. Dell’ordine legge riferimento, stato, importo, pagamento, corriere e fino a 10 righe di prodotto; della spedizione legge stato del corriere, luogo, consegna stimata, link di tracking e fino a 15 eventi della cronologia. Se l’ordine non è ancora stato spedito, la ricerca restituisce comunque l’ordine.

// Campi che Orygo AI legge da Qapla’ con la ricerca per ordine
GruppoCampiDomanda del cliente a cui risponde
OrdineRiferimento, ID ordine Qapla’, stato, spedito sì o no, data di creazione e di aggiornamento, data di spedizione, note“Il mio ordine è partito?”
PagamentoImporto, valuta, metodo di pagamento, contrassegno sì o no“Quanto devo pagare al corriere alla consegna?”
DestinazioneCittà, provincia o regione, paese e CAP (indirizzo parziale)“Lo state mandando all’indirizzo giusto?”
ArticoliFino a 10 righe con SKU, nome, quantità, prezzo e totale riga“Nel pacco c’è anche la seconda taglia?”
CorriereNome e codice del corriere“Con chi viaggia il mio pacco?”
SpedizioneNumero di tracking, link di tracking Qapla’, link di tracking del corriere, stato, dettaglio dello stato, data dello stato, luogo, consegna stimata, consegnato sì o no“Dov’è il pacco adesso e quando arriva?”
CronologiaFino a 15 eventi, ciascuno con data, stato, dettaglio e luogo“Perché è fermo da tre giorni?”

Due dettagli fanno la differenza nelle risposte. Il flag del contrassegno permette all’agente di ricordare al cliente quanto dovrà pagare al corriere, prima che il pacco arrivi alla porta. I due link di tracking, quello di Qapla’ e quello del corriere, si possono lasciare in chat a chi preferisce seguire il pacco da solo.

La lettura dell’ordine su Qapla’ si somma a quella dello store, non la sostituisce: per il profilo cliente, lo storico ordini e i prodotti l’agente continua a usare l’integrazione con Shopify, WooCommerce, PrestaShop, Magento, BigCommerce o Salesforce Commerce Cloud.

Ordine o tracking

Ricerca per ordine o per numero di tracking: quale usa l’agente?

Orygo AI usa la ricerca per ordine quando il cliente dà email e numero d’ordine, che è il caso più frequente, e la ricerca per numero di tracking quando il cliente ha solo il codice del corriere, per esempio copiato dall’email di spedizione. Quando usare l’una o l’altra lo scrivi nella procedura di tracking, in italiano, come un’istruzione a un collega.

// Le due ricerche su Qapla’ a confronto
Ricerca per ordineRicerca per numero di tracking
Cosa chiede l’agenteEmail e riferimento dell’ordineSolo il numero di tracking del corriere
Controllo sull’identitàL’email deve coincidere con quella del destinatario dell’ordineNessuna email: serve il codice del corriere
Cosa restituisceOrdine e spedizione in un’unica rispostaLa spedizione
Ordine non ancora speditoRestituisce l’ordine senza spedizione, senza erroriNon si applica: il numero di tracking non esiste ancora
Quando convieneDomanda generica: “dov’è il mio ordine?”, “cosa ho ordinato?”Il cliente incolla un codice e non ricorda il numero d’ordine

Come scrive il cliente il riferimento dell’ordine

Il riferimento è quello con cui l’ordine è registrato in Qapla’, per esempio ORD-12345 o BAT-234241299. Il cancelletto iniziale viene tolto in automatico: se il cliente scrive “#12345” o “12345”, l’agente cerca lo stesso ordine. Con il pulsante Order Info nella chat del sito il cliente inserisce email e numero in un modulo, senza doverli scrivere nel messaggio.

Una procedura di tracking con Qapla’

Le due azioni lavorano dentro una procedura scritta in linguaggio naturale. Ecco un esempio; nomi delle azioni, tempi e team sono di esempio e vanno adattati al tuo store.

Traccia ordine con Qapla’

Esempio
  1. 1
    Quando il cliente chiede dov’è il suo ordine, chiedi l’email usata per l’acquisto e il numero d’ordine.
  2. 2
    Cerca l’ordine con @Ordine Qapla’. Se non lo trovi, chiedi di ricontrollare email e numero, senza dire se l’ordine esiste.
  3. 3
    Se l’ordine non è ancora spedito, di’ quando è stato creato e che il numero di tracking sarà disponibile alla partenza del pacco.
  4. 4
    Se è spedito, rispondi con stato, luogo dell’ultimo passaggio e consegna stimata, e lascia il link di tracking.
  5. 5
    Se l’ordine è in contrassegno, ricorda l’importo da pagare al corriere.
  6. 6
    Se il cliente ti dà solo un numero di spedizione, usa @Tracking Qapla’.
  7. 7
    Se il pacco risulta consegnato ma il cliente dice di non averlo ricevuto, passa il caso al team logistica.

Come si scrivono e si modificano le procedure: procedure in linguaggio naturale. Come avviene il passaggio a una persona, con ordine e tracking già nel ticket: passaggio dal chatbot all’operatore.

Collegamento

Come si collega Qapla’ a Orygo AI?

Per collegare Qapla’ a Orygo AI serve una sola credenziale: la API key privata del canale Qapla’ su cui arrivano gli ordini del tuo negozio. La copi dal Control Panel di Qapla’, la incolli nelle integrazioni del tuo agente in Orygo AI e accendi le azioni che ti servono. Non c’è codice da scrivere.

  1. [01]

    Apri il canale in Qapla’Nel Control Panel vai su Impostazioni › Canali, scegli il canale del negozio e apri Configura › Canale.
  2. [02]

    Copia la API KEY PrivateQapla’ chiede di tenerla segreta: incollala solo nel pannello di Orygo AI, non in email o chat.
  3. [03]

    Incollala nell’agenteIn Orygo AI apri le integrazioni dell’agente, scegli Qapla’ e inserisci la chiave. La credenziale appartiene a quell’agente: se hai più agenti, ognuno ha la sua.
  4. [04]

    Accendi le azioniPuoi attivarle entrambe o solo una: ordine con spedizione, tracking per numero.
  5. [05]

    Provale prima di andare liveCita le azioni nella procedura di tracking e prova le domande vere dei tuoi clienti nel playground, dove vedi ogni chiamata a Qapla’ fatta dall’agente.

Il percorso della chiave è quello indicato nella guida alle API di Qapla’ (consultata a novembre 2026). Le stesse azioni e il modo in cui l’agente sceglie quale usare sono descritti nella pagina azioni e strumenti AI; i passaggi dal contratto al lancio sono in come si va live.

Dati clienti

Come protegge i dati dei clienti l’integrazione con Qapla’?

Nella ricerca per ordine Orygo AI mostra i dati solo se l’email indicata dal cliente coincide con quella del destinatario registrato in Qapla’. Se non coincide, la risposta è “ordine non trovato”, così nessuno può leggere l’ordine di un altro. L’indirizzo letto è parziale, cioè città, provincia, paese e CAP, e le azioni sono in sola lettura.

Email del destinatario

Il controllo avviene sull’email del destinatario dell’ordine in Qapla’. Se per un regalo il destinatario ha un’email diversa da chi ha comprato, la procedura può proporre la ricerca per numero di tracking o passare il caso al team.

Sola lettura

Orygo AI legge ordini e spedizioni ma non crea etichette, non cambia lo stato di un ordine e non modifica l’indirizzo. Le richieste di modifica arrivano al team come pratica pronta.

Una chiave per agente

La API key resta nel pannello dell’agente che la usa, e ogni azione si spegne da sola. Le altre protezioni della chat, da bot e spam, sono nella pagina sicurezza.

Chi fa cosa

Orygo AI, avvisi di Qapla’ e server MCP: chi fa cosa?

Qapla’ gestisce la spedizione e la comunica: tracking dei corrieri, pagina di tracking, avvisi email, SMS e WhatsApp. Orygo AI entra quando il cliente fa una domanda: legge i dati da Qapla’ e risponde nella conversazione, applicando le tue regole. Il server MCP di Qapla’ serve invece al tuo team, per interrogare le spedizioni da Claude o ChatGPT.

// Strumenti intorno a Qapla’ e a cosa servono
StrumentoChi lo usaQuando entra in giocoCosa fa
Avvisi e pagina di tracking di Qapla’Il cliente finaleA ogni cambio di stato della spedizioneInforma sullo stato con il marchio del negozio
Server MCP di Qapla’Il tuo teamQuando qualcuno lo interroga da Claude o ChatGPTRisponde a domande interne sulle spedizioni, per esempio quante sono in giacenza
Orygo AI con Qapla’Il cliente finaleQuando scrive in chat, per email, su WhatsApp, Instagram, Messenger, Amazon o in un ticketRisponde con i dati di ordine e spedizione, segue la procedura e passa al team i casi che lo richiedono

Gli avvisi e l’agente AI non si escludono. Anche con gli avvisi attivi, il cliente che vede lo stesso stato da giorni scrive all’assistenza, e lì serve una risposta che spieghi cosa succede e cosa fare. 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).

Se le spedizioni le gestisci con ShippyPro invece che con Qapla’, l’integrazione funziona in modo diverso, solo per numero di tracking: trovi le differenze nella pagina integrazione ShippyPro. Tutte le integrazioni sono nella pagina integrazioni di Orygo AI.

FAQ

Domande frequenti sull’integrazione Qapla’

Dove trovo la API key privata di Qapla’?

Nel Control Panel di Qapla’, in Impostazioni › Canali: scegli il canale del negozio, apri Configura › Canale e copia il valore del campo API KEY Private. Va incollata nelle integrazioni dell’agente in Orygo AI e tenuta segreta.

Quale numero d’ordine deve dare il cliente per la ricerca su Qapla’?

No. Orygo AI toglie in automatico il cancelletto iniziale, quindi “#12345” e “12345” portano allo stesso ordine. Il riferimento è quello registrato in Qapla’, per esempio ORD-12345, e va sempre accompagnato dall’email del destinatario.

Cosa risponde l’agente se l’ordine non è ancora stato spedito?

La ricerca per ordine su Qapla’ restituisce l’ordine anche quando la spedizione non esiste ancora. L’agente può quindi dire al cliente quando l’ordine è stato creato, cosa contiene e in che stato si trova, seguendo quello che hai scritto nella procedura per gli ordini in preparazione.

Ho più canali su Qapla’: quale API key uso?

La API key privata di Qapla’ è assegnata al singolo canale. Usa la chiave del canale su cui arrivano gli ordini del negozio servito dall’agente. Se hai più negozi con agenti diversi, ogni agente Orygo AI ha la sua credenziale.

Orygo AI manda gli avvisi di spedizione al posto di Qapla’?

No. Orygo AI risponde quando il cliente chiede, sul canale da cui scrive. Gli avvisi email, SMS e WhatsApp a ogni cambio di stato e la pagina di tracking restano a Qapla’, che li gestisce come oggi.

Con quali corrieri funziona l’integrazione Qapla’ di Orygo AI?

Con i corrieri che segui già su Qapla’. Orygo AI non si collega ai corrieri uno per uno: legge stato e cronologia attraverso Qapla’, che sul suo sito dichiara oltre 450 corrieri per il tracking (novembre 2026).

Altre integrazioniGli altri strumenti della stessa categoria
LogisticaShippyPro

Collega ShippyPro a Orygo AI con la API key Enterprise: l’agente AI legge stato, consegna stimata e ultimi 15 eventi del corriere e risponde ai clienti.

Scopri ShippyPro
Tutte le integrazioni →Tutte le funzionalità →Tutti i canali →
Demo

Vuoi che l’AI risponda sul tracking con i dati del tuo Qapla’?

Prenota una demo: ti mostriamo l’agente AI di Orygo mentre cerca un ordine su Qapla’ con email e riferimento, legge la cronologia del corriere e risponde come faresti tu, e insieme scriviamo la procedura di tracking con le tue regole.