**Per configurare il Capitano di Papo (https://papo.global/) per consultare lo stato dell'ordine in tempo reale, usa uno Strumento (Tool) personalizzato via HTTP. Collega l'assistente all'endpoint del tuo ERP, e-commerce o CRM e permette all'IA di interpretare il messaggio del cliente, inviare il numero dell'ordine al sistema esterno e restituire lo stato durante la conversazione su WhatsApp.**

Con questa configurazione, il Capitano non è più solo un assistente che risponde alle domande, ma inizia a eseguire azioni pratiche. Il cliente può inviare "dov'è il mio ordine 12345?" e ricevere una risposta automatica, come "Ordine in transito", senza intervento umano. Questo riduce la coda, accelera l'assistenza e libera il team per i casi complessi.

## Riepilogo della configurazione

| Fase | Cosa fare | Nota |
| :--- | :--- | :--- |
| **1. Accedere al Capitano** | Aprire le impostazioni dell'assistente nella piattaforma Papo. | I nomi esatti dei menu possono variare. |
| **2. Creare uno Strumento personalizzato** | Usare il tipo HTTP per collegare il Capitano a un sistema esterno con API. | Richiede conoscenze tecniche di API e richieste HTTP. |
| **3. Definire l'endpoint** | Inserire l'URL dell'API del tuo ERP, e-commerce o CRM. | Esempio: `https://api.meusistema.com/v1/pedidos`. |
| **4. Configurare metodo e autenticazione** | Usare GET per recuperare i dati e includere header di sicurezza, come il token di autenticazione. | Esempio: `Authorization: Bearer tua_chiave_segreta`. |
| **5. Inviare il numero dell'ordine** | Permettere al Capitano di usare le informazioni fornite dal cliente nella conversazione. | L'azione diventa dinamica in base all'ordine indicato. |
| **6. Collegare a WhatsApp** | Attivare l'assistente nell'inbox di WhatsApp. | La consultazione inizia a funzionare durante l'assistenza. |

## Come funziona la consulta dello stato con il Capitano

Il flusso è un ciclo che collega il messaggio del cliente a un'azione concreta:

1. **Il cliente chiede informazioni sull'ordine:** Invia qualcosa come "Dov'è il mio ordine 12345?".
2. **Il Capitano comprende l'intenzione:** In base alle istruzioni e alle descrizioni degli strumenti configurati, identifica che deve consultare lo stato.
3. **Lo Strumento viene attivato:** L'assistente invia il numero "12345" all'endpoint del tuo sistema esterno.
4. **Il sistema restituisce lo stato:** L'API restituisce un risultato, come "Ordine in transito" o "Ordine consegnato".
5. **Il Capitano risponde al cliente:** L'IA usa questo ritorno per formulare una risposta naturale e completa su WhatsApp.

Tutto questo processo avviene in tempo reale, senza che un agente umano debba copiare il numero dell'ordine e aprire un altro sistema.

## Prerequisiti per usare uno Strumento personalizzato HTTP

Prima di configurare, è importante avere:

- **Un assistente Capitano creato** nella piattaforma Papo, con nome e descrizione definiti.
- **Un sistema esterno con API disponibile**, come ERP, CRM o piattaforma di e-commerce.
- **L'URL dell'endpoint** che verrà chiamato per consultare l'ordine.
- **Credenziali di autenticazione**, come chiave API o token di accesso, per mantenere la richiesta sicura.
- **Conoscenza delle API e delle richieste HTTP**, poiché la configurazione di Strumenti personalizzati è avanzata.

Se non disponi di un'API nel tuo sistema o non sai quali dati accetta, i dettagli tecnici devono essere validati con il team di sviluppo o con la documentazione del fornitore.

## Strumenti nativi vs. personalizzati per gli ordini

Papo offre due tipi di Strumenti per il Capitano:

| Tipo | Descrizione | Esempio d'uso | Conoscenza tecnica |
| :--- | :--- | :--- | :--- |
| **Nativo** | Integrazioni preconfigurate e pronte all'uso nella piattaforma. | Pianificare una demo su Google Calendar. | Bassa, basta attivare e collegare l'account. |
| **Personalizzato (HTTP)** | Azioni personalizzate che si collegano a sistemi esterni o all'API di Papo. | Consultare lo stato di un ordine nell'e-commerce aziendale. | Avanzata, richiede API e richieste HTTP. |

Per consultare lo stato dell'ordine in tempo reale, il percorso più comune è lo Strumento personalizzato HTTP, poiché l'ordine di solito si trova in un sistema proprietario dell'azienda. Non esiste un'integrazione nativa automatica per qualsiasi ERP o e-commerce; ogni sistema deve essere collegato tramite l'endpoint corrispondente.

## Configurare lo Strumento personalizzato per lo stato dell'ordine

Il processo concettuale per abilitare la consulta degli ordini segue una logica chiara:

1. **Accedi alle impostazioni dell'assistente:** Nel pannello di Papo, apri l'area di configurazione del Capitano dove vengono gestiti gli Strumenti.
2. **Crea uno Strumento di tipo personalizzato HTTP:** Scegli l'opzione che permette di collegarsi a un sistema esterno tramite API.
3. **Compila i dati della richiesta:** Inserisci l'URL dell'endpoint, il metodo HTTP (GET per recuperare i dati) e gli header di autenticazione, come `Authorization: Bearer tua_chiave_segreta`.
4. **Definisci come verrà inviato il numero dell'ordine:** Lo Strumento può usare i dati della conversazione per rendere l'azione dinamica. Così, quando il cliente indica l'ordine 12345, il Capitano invia questo valore nella chiamata.
5. **Descrivi chiaramente quando lo Strumento deve essere usato:** Il Capitano seleziona lo strumento adatto in base alle istruzioni e alle descrizioni che hai configurato. Includi esempi di messaggi, come "consultare stato", "dov'è il mio ordine" o "tracciare ordine".
6. **Collega l'assistente a un inbox:** Attiva il Capitano nell'inbox di WhatsApp o di un altro canale collegato a Papo. Da quel momento, inizierà a rispondere alle richieste di stato all'interno della conversazione.

I nomi esatti delle schermate e dei pulsanti possono variare all'interno della piattaforma. In caso di dubbi sulla posizione di un campo, consulta il Centro Assistenza o il supporto di Papo.

## Quando questa automazione ha senso

Configurare la consulta dello stato dell'ordine in tempo reale è utile per le operazioni che:

- Ricevono molte domande ripetute sugli ordini su WhatsApp.
- Vendono tramite e-commerce o lavorano con tempi di consegna.
- Vogliono ridurre il tempo di prima risposta nelle conversazioni di post-vendita.
- Hanno bisogno di liberare il team per i casi che richiedono analisi umana, come cambi, rimborsi o reclami.
- Possiedono già un sistema esterno con API di consultazione ordini.

Se la tua operazione non dispone ancora di un'API per gli ordini, la personalizzazione completa potrebbe non essere possibile immediatamente. In questo caso, vale la pena valutare se uno Strumento nativo di Papo soddisfa un'altra fase dell'assistenza, come la pianificazione di una demo su Google Calendar.

## Domande frequenti

### Devo saper programmare per configurare la consulta dello stato?

Sì, per gli Strumenti personalizzati HTTP è necessaria una conoscenza avanzata delle API e delle richieste HTTP. Gli Strumenti nativi hanno una configurazione più semplice, ma non coprono automaticamente tutti i sistemi esterni.

### Il Capitano può consultare più di un sistema?

Sì. Puoi configurare più Strumenti personalizzati affinché il Capitano comunichi con diverse API, come ERP, CRM o piattaforma di e-commerce.

### Come garantire la sicurezza della consulta?

Usa header di autenticazione, come un token di accesso, affinché la richiesta sia sicura e autorizzata. Ad esempio, `Authorization: Bearer tua_chiave_segreta`. Non condividere le chiavi pubblicamente e convalida l'accesso solo all'endpoint necessario.

### Posso testare prima di attivare su WhatsApp?

Sì. L'ideale è validare la chiamata API con uno strumento di test esterno prima di attivare l'assistente nell'inbox, evitando risposte errate al cliente.

### Cosa succede se il sistema esterno restituisce un errore?

Il Capitano può rispondere solo in base al ritorno dell'API. Se l'endpoint è offline o restituisce un errore, la risposta potrebbe non contenere lo stato. Per questo è importante monitorare la disponibilità del sistema integrato.

Leggi anche:
- [Come addestrare il Capitano a identificare l'intenzione di acquisto e trasferire a un venditore](/hc/papo/articles/addestrare-capitano-intenzione-acquisto-venditore)
- [Come testare la connessione di un webhook di Papo prima di attivare l'automazione](/hc/papo/articles/testare-connessione-webhook-papo-prima-attivare-automazione)

---

**[Inizia gratis e configura la consulta degli ordini con il Capitano →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=configurare-capitano-consultare-stato-ordine-tempo-reale&utm_content=it)**

Centralizza WhatsApp, Instagram, e-mail e SMS in un'unica inbox con l'IA di Papo che risponde in 2 secondi.