**Per configurare il Capitão di Papo (https://papo.global/) per consultare le scorte dei prodotti in tempo reale, crea uno Strumento (Tool) personalizzato via HTTP. Collega l'assistente all'endpoint del tuo sistema di gestione delle scorte (ERP, WMS o e-commerce) e permette all'IA di interpretare la domanda del cliente, inviare il codice del prodotto all'API e restituire la disponibilità durante la conversazione su WhatsApp.**

Con questa configurazione, il Capitão non è più solo un assistente che risponde a dubbi, ma inizia a eseguire azioni pratiche di consultazione. Il cliente può chiedere “Avete la scarpa X nel numero 42?” e ricevere una risposta automatica come “Sì, abbiamo 3 unità in magazzino”, senza intervento umano. Questo riduce i tempi di attesa, evita frustrazioni e libera il team per trattative più complesse.

## Riepilogo della configurazione

| Fase | Cosa fare | Nota |
| :--- | :--- | :--- |
| **1. Accedere al Capitão** | 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 Capitão a un sistema esterno con API. | Richiede conoscenza tecnica di API e richieste HTTP. |
| **3. Definire l'endpoint** | Inserire l'URL dell'API del tuo sistema di scorte. | Esempio: `https://api.meusistema.com/v1/estoque`. |
| **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 codice del prodotto** | Permettere al Capitão di usare l'informazione fornita dal cliente nella conversazione. | L'azione diventa dinamica in base al prodotto indicato. |
| **6. Collegare a WhatsApp** | Attivare l'assistente nella casella di posta di WhatsApp. | La consulta inizia a funzionare durante l'assistenza. |

## Come funziona la consulta delle scorte con il Capitão

Il flusso è un ciclo che collega la domanda del cliente a un'azione concreta:

1. **Il cliente chiede informazioni sulla disponibilità:** Invia qualcosa come “Avete il modello X nel colore blu?”.
2. **Il Capitão comprende l'intenzione:** In base alle istruzioni e alle descrizioni degli strumenti configurati, identifica che deve consultare le scorte.
3. **Lo Strumento viene attivato:** L'assistente invia il codice del prodotto (estratto dalla conversazione) all'endpoint del tuo sistema esterno.
4. **Il sistema restituisce la quantità:** L'API restituisce un risultato, come `{ "disponibile": true, "quantita": 5 }`.
5. **Il Capitão 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 aprire un altro sistema per verificare manualmente.

## Prerequisiti per usare uno Strumento personalizzato HTTP

Prima di configurare, è importante avere:

- **Un assistente Capitão creato** nella piattaforma Papo, con nome e descrizione definiti.
- **Un sistema esterno con API disponibile**, come ERP, WMS o piattaforma di e-commerce che esponga la consulta delle scorte.
- **L'URL dell'endpoint** che sarà chiamato per ottenere la disponibilità del prodotto.
- **Credenziali di autenticazione**, come chiave API o token di accesso, per mantenere la richiesta sicura.
- **Conoscenza di API e richieste HTTP**, poiché la configurazione di Strumenti personalizzati è avanzata.

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

## Strumenti nativi vs. personalizzati per le scorte

Papo offre due tipi di Strumenti per il Capitão:

| Tipo | Descrizione | Esempio d'uso | Conoscenza tecnica |
| :--- | :--- | :--- | :--- |
| **Nativo** | Integrazioni preconfigurate e pronte all'uso nella piattaforma. | Programmare 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 le scorte di un prodotto nell'ERP aziendale. | Avanzata, richiede API e richieste HTTP. |

Per consultare le scorte in tempo reale, il percorso più comune è lo Strumento personalizzato HTTP, poiché i dati si trovano generalmente in un sistema proprio dell'azienda. Non esiste un'integrazione nativa automatica per qualsiasi ERP o WMS; ogni sistema deve essere collegato tramite l'endpoint corrispondente.

## Configurare lo Strumento personalizzato per la consulta delle scorte

Il processo concettuale per abilitare questa automazione segue una logica chiara, senza bisogno di memorizzare nomi di schermate o pulsanti:

1. **Accedi alle impostazioni dell'assistente:** Nel pannello di Papo, apri l'area di configurazione del Capitão dove vengono gestiti gli Strumenti.
2. **Crea uno Strumento di tipo personalizzato HTTP:** Scegli l'opzione che permette di collegarsi a un sistema esterno via 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 codice del prodotto:** Lo Strumento può usare i dati della conversazione per rendere l'azione dinamica. Così, quando il cliente indica il prodotto, il Capitão invia questo valore nella chiave attesa dall'API (ad esempio, `?sku=XYZ`).
5. **Collega l'assistente alla casella di posta di WhatsApp:** Attiva il Capitão nella casella desiderata affinché la consulta funzioni durante l'assistenza.

Ricorda che l'uso di Strumenti personalizzati può consumare crediti IA del tuo account, in base alla frequenza di attivazione.

## Per chi è indicata questa configurazione?

- **E-commerce e negozi online** che devono rispondere rapidamente sulla disponibilità dei prodotti.
- **Rivenditori con scorte fisiche** che assistono via WhatsApp e desiderano automatizzare la consulta.
- **Distributori e grossisti** che gestiscono grandi cataloghi e vogliono velocizzare l'assistenza al cliente.
- **Aziende che possiedono già un'API delle scorte** e cercano di integrare l'assistenza senza sviluppare un chatbot da zero.

## Domande frequenti

### Devo avere un'API delle scorte per usare questa funzionalità?
Sì. Lo Strumento personalizzato HTTP si collega a un endpoint esterno. Se il tuo sistema di scorte non offre un'API, sarà necessario sviluppare uno strato intermedio o utilizzare una soluzione che esponga già questi dati.

### Posso consultare le scorte di più prodotti in una sola domanda?
Dipende dalla capacità della tua API. Se l'endpoint accetta più codici contemporaneamente, il Capitão può inviare la lista e interpretare il ritorno. In caso contrario, effettuerà consultazioni individuali per ogni prodotto menzionato.

### Il Capitão riesce a prenotare o scaricare automaticamente le scorte?
No. Lo Strumento personalizzato descritto qui è solo per la consulta. Per azioni come prenotazione o scarico, sarebbe necessario configurare endpoint che accettino metodi POST/PUT e programmare la logica adeguata, il che richiede uno sviluppo più avanzato.

### La consulta delle scorte è sicura?
Sì, a condizione che tu utilizzi l'autenticazione tramite token o chiave API negli header della richiesta. Il traffico tra il Capitão e il tuo sistema avviene tramite HTTPS, mantenendo i dati protetti.

### Questa configurazione ha un costo aggiuntivo?
La creazione di Strumenti personalizzati è disponibile nella piattaforma Papo, ma l'uso di questi strumenti può consumare crediti IA. I dettagli sul consumo dei crediti sono disponibili nel pannello del tuo account.

## Leggi anche

- [Come ottimizzare la Base di Conoscenza per migliorare la ricerca RAG del Capitão](/hc/papo/articles/come-ottimizzare-base-di-conoscenza-migliorare-ricerca-rag-capitao)
- [Come addestrare il Prompt e l'IA con esempi di conversazioni reali](/hc/papo/articles/come-addestrare-prompt-e-ia-con-esempi-di-conversazioni-reali)

---

**[Inizia gratis e configura il Capitão per consultare le scorte →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=configurare-capitao-consultare-disponibilita-prodotti-tempo-reale&utm_content=it)**

Con Papo, automatizzi l'assistenza su WhatsApp, riduci i tempi di risposta e liberi il tuo team per ciò che conta davvero.