**Per creare una Tool del Capitão che cerca quotazioni di spedizione, utilizza una Tool personalizzata HTTP sulla piattaforma Papo (https://papo.global/). Essa collega l'assistente all'API del tuo corriere o piattaforma logistica e permette all'IA di interpretare dati come CAP di destinazione, peso e dimensioni inviati dal cliente, consultare il sistema esterno e restituire automaticamente il costo di spedizione durante la conversazione su WhatsApp.** Con questa configurazione, il Capitão non è più solo un assistente che risolve dubbi, ma inizia a eseguire azioni pratiche di logistica. Il cliente può chiedere “Quanto costa la spedizione per il CAP 02030‑040?” e ricevere subito una risposta come “La spedizione per questo CAP costa R$ 18,90 con consegna in 3 giorni lavorativi”, senza intervento umano. Questo riduce l'attrito nell'acquisto, accelera l'assistenza e libera il team per negoziazioni più complesse. ## Riepilogo della configurazione | Fase | Cosa fare | Osservazione | | :--- | :--- | :--- | | **1. Accedere alle impostazioni del Capitão** | Aprire le definizioni dell'assistente su Papo. | I nomi esatti dei menu possono variare. | | **2. Creare una Tool personalizzata** | Usare il tipo HTTP per collegare il Capitão a un'API di corriere. | Richiede conoscenze tecniche di richieste HTTP. | | **3. Definire l'endpoint** | Inserire l'URL dell'API che calcola la spedizione (es.: Correios, Braspress, Intelipost). | Esempio: `https://api.transportadora.com/v1/cotacao`. | | **4. Configurare metodo e autenticazione** | Usare POST o GET con header di sicurezza, come token di accesso. | Esempio: `Authorization: Bearer tua_chiave_api`. | | **5. Inviare i dati della quotazione** | Permettere al Capitão di estrarre dalla conversazione il CAP, peso, formato o altri parametri richiesti dall'API. | L'azione diventa dinamica in base a ciò che il cliente fornisce. | | **6. Collegare a WhatsApp** | Attivare l'assistente nella casella di posta di WhatsApp. | La consultazione inizia a funzionare in tempo reale durante l'assistenza. | ## Come funziona la consultazione della spedizione con il Capitão Il flusso collega una domanda comune del cliente a un calcolo in tempo reale: 1. **Il cliente chiede una quotazione:** Invia un messaggio come “Qual è la spedizione per il CAP 04123‑000?”. 2. **Il Capitão interpreta l'intenzione:** In base alle istruzioni e descrizioni delle tool, riconosce che deve usare la Tool di quotazione. 3. **La Tool viene attivata:** L'assistente invia i valori estratti dalla conversazione (CAP, peso del prodotto, ecc.) all'endpoint del corriere. 4. **L'API restituisce il valore e il termine:** Il sistema esterno restituisce un JSON con le opzioni di spedizione disponibili. 5. **Il Capitão risponde al cliente:** L'IA traduce questi dati in una risposta naturale, come “Abbiamo PAC a R$ 22,90 (7 giorni) e Sedex a R$ 39,50 (2 giorni)”. Tutto il processo avviene senza che un agente umano debba copiare il CAP e aprire un altro sistema. ## Prerequisiti per configurare la Tool di quotazione Prima di creare la tool, è necessario avere: - **Un assistente Capitão già creato** sulla piattaforma Papo, con nome e descrizione definiti. - **Un'API del corriere disponibile**, che sia delle Poste (Correios), di una piattaforma logistica (Intelipost, Frenet, SuperFrete) o di un sistema proprio di gestione delle consegne. - **L'URL dell'endpoint** che verrà chiamato per calcolare la spedizione. - **Credenziali di autenticazione** (chiave API, token o header specifico) affinché la richiesta sia sicura. - **Conoscenza di API e richieste HTTP**, poiché la configurazione di Tool personalizzate è avanzata. Se il tuo corriere non offre un'API pubblica, sarà necessario sviluppare un intermediario o utilizzare una soluzione di quotazione che esponga già un endpoint. Le specifiche tecniche devono essere validate con il team di sviluppo o con la documentazione del fornitore. ## Tool native vs. personalizzate per la logistica Papo offre due tipi di Tool per il Capitão: | Tipo | Descrizione | Esempio d'uso | Conoscenza tecnica | | :--- | :--- | :--- | :--- | | **Nativa** | Integrazioni preconfigurate e pronte all'uso sulla piattaforma. | Programmare una demo su Google Calendar. | Bassa, basta attivare e collegare l'account. | | **Personalizzata (HTTP)** | Azioni personalizzate che si collegano a sistemi esterni via API. | Consultare quotazioni di spedizione in tempo reale su WhatsApp. | Avanzata, richiede API e richieste HTTP. | Per cercare quotazioni di spedizione, il percorso indicato è la Tool personalizzata HTTP, poiché il calcolo dipende da ogni corriere o operatore logistico. Non esiste un'integrazione nativa generica per qualsiasi corriere; avrai bisogno dell'endpoint specifico del servizio di quotazione che utilizzi. ## Configurare la Tool personalizzata per la quotazione di spedizione Il processo concettuale per abilitare questa automazione segue una logica chiara, senza la necessità di memorizzare nomi di schermate o pulsanti: 1. **Accedi alle impostazioni dell'assistente:** Nel pannello di Papo, vai all'area di configurazione del Capitão dove vengono gestite le Tool. 2. **Crea una Tool di tipo personalizzata HTTP:** Scegli l'opzione che permette di collegarsi a un sistema esterno via API. 3. **Inserisci i dati della richiesta:** Compila l'URL dell'endpoint del corriere, il metodo HTTP (generalmente POST, poiché invii il CAP e ricevi il calcolo) e gli header di autenticazione, come `Authorization: Bearer tua_chiave`. 4. **Definisci i parametri dinamici:** Il grande vantaggio è che il Capitão può usare informazioni che il cliente stesso fornisce nella conversazione. Puoi configurare la tool per inviare il CAP che è apparso nel messaggio, il peso standard del prodotto o il formato del pacco. La tool interpreterà questi valori automaticamente. 5. **Istruisci il Capitão su come rispondere:** Nella descrizione della tool o nelle linee guida dell'assistente, puoi orientare l'IA a presentare il valore e il termine in modo amichevole, come “La tua spedizione per il CAP … costa R$ … e arriva in …”. 6. **Collega l'assistente alla casella di posta:** Assicurati che il Capitão sia attivato per WhatsApp (o un altro canale) dove i clienti faranno la domanda. Dopo la configurazione, qualsiasi messaggio che menzioni “spedizione”, “quotazione” o “invio” attiverà il flusso — a condizione che il Capitão riconosca l'intenzione. La risposta finale proviene dai dati reali del corriere, senza che un collaboratore debba intervenire. ## Domande frequenti ### Devo avere un'API del mio corriere per usare questa Tool? Sì. La Tool personalizzata HTTP funziona chiamando un endpoint che restituisce il costo della spedizione. Se il tuo corriere non offre un'API, puoi usare un servizio di quotazione (come Intelipost, Frenet o SuperFrete) che consolida più corrieri e fornisce un unico endpoint. ### Come fa il Capitão a sapere quale CAP o peso usare? Durante la configurazione, puoi indicare che il valore del CAP deve essere estratto direttamente dal messaggio del cliente. La tool usa variabili dinamiche per catturare questi dati. L'assistente può anche confermare con il cliente se l'informazione è incompleta, a seconda delle istruzioni che fornisci. ### È necessario uno sviluppatore per configurare? Sì. La creazione di una tool personalizzata HTTP richiede conoscenza di API, metodi HTTP e autenticazione. Normalmente, uno sviluppatore o qualcuno con esperienza in integrazioni esegue questa fase. Papo non fornisce l'endpoint del corriere, ma solo l'infrastruttura per collegarlo. ### La quotazione di spedizione viene registrata nel CRM di Papo? La cronologia della conversazione e la risposta generata vengono salvate nella casella di posta. Papo non crea automaticamente un record di quotazione in un modulo specifico (come un affare nel Kanban), ma puoi completare il flusso usando altre automazioni, come webhook, per creare un lead o un'attività da questa interazione. ### Posso usare la stessa Tool per consultare i tempi di consegna? Sì. Generalmente il ritorno dell'API di spedizione include già il termine stimato. La Tool può essere configurata per mostrare sia il valore che il termine nella risposta del Capitão. ### Esiste un costo aggiuntivo per usare Tool personalizzate? Le Tool personalizzate fanno parte delle funzionalità del Capitão per gli account che hanno accesso a questa risorsa. Per dettagli sulla disponibilità in base al piano, consulta il sito di Papo. ## Leggi anche - [Come configurare il Capitão per consultare lo stato dell'ordine in tempo reale](/hc/papo/articles/configurare-capitano-consultare-stato-ordine-tempo-reale) - [Come generare una chiave pubblica e una chiave segreta dell'API Papo](/hc/papo/articles/come-generare-chiave-pubblica-segreta-api-papo) --- **[Inizia gratis e crea il tuo assistente con tool intelligenti →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-creare-una-tool-del-capitao-per-cercare-quotazioni-di-spedizione&utm_content=it)** Centralizza assistenza e automazioni su WhatsApp con l'IA, senza moltiplicare gli strumenti.