--- description: Scopri come l'azione Make HTTP requests dell'Agente AI permette al tuo Agente AI di chiamare API esterne durante le conversazioni per recuperare dati in tempo reale o attivare azioni in sistemi di terze parti. title: Azione Agente AI: Make HTTP requests image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0 --- [NuovoAbbiamo appena raccolto 62,5 milioni di dollari nel round di Serie B! 🎉 Cosa significa per te![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](https://respond.io/blog/respond-io-raises-62-million-series-b) Aiutami con... ⌘ 1. [All Collections >](/it/help) 2. [ Prodotto >](/it/help/product) 3. [ Agenti di intelligenza artificiale >](/it/help/ai-agents) 4. [ Azioni dell'Agente AI >](/it/help/ai-skills) 5. Azione Agente AI: Make HTTP requests # Azione Agente AI: Make HTTP requests > **Idoneità al piano:** Disponibile nei piani Advanced, Enterprise e in alcuni piani Legacy. Il test è disponibile per tutti gli utenti, ma per pubblicare è necessario un piano idoneo. L'azione **Make HTTP requests** permette al tuo Agente AI di chiamare API esterne durante una conversazione. Questo consente all'Agente AI di recuperare dati in tempo reale o di attivare azioni in sistemi esterni in base alla richiesta del Contatto. Ad esempio, può verificare lo stato dell'ordine, recuperare informazioni sul conto o creare record in un altro sistema. In questo articolo imparerai a configurare l'azione di richiesta HTTP e a testarla con il tuo Agente AI. L'Agente AI: 1. Analizza il messaggio del Contatto per determinare se corrisponde all'intento definito nelle tue istruzioni per l'azione. 2. Raccoglie le informazioni richieste. 3. Invia la richiesta HTTP. 4. Interpreta la risposta API. 5. Risponde in modo naturale al Contatto. ## Aggiungi un'azione Make HTTP requests Attiva l'azione e clicca sul pulsante "Add action" per iniziare a configurare la tua richiesta HTTP. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Tbaws3LvA9FysLz9eC0Iv/594d61b1024dfcb48ca704559cc37070/addhttprequest.png?fm=jpg&q=80&w=1200&fl=progressive) ### Definisci quando l'azione deve essere eseguita Assegna un nome descrittivo all'azione nel campo **Action name** . Nel campo **When and how should this action be performed?** campo, descrivi: * Quando l'Agente AI dovrebbe usare questa azione * Cosa recupera o invia * Eventuali condizioni o risultati da gestire ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Ry7D5PA3Efyy2GFykdlYs/88cfe62f2b7c9b0792e81c1bb9d75c45/httprequest1.png?fm=jpg&q=80&w=1200&fl=progressive) Esempio: ```html Usa questa azione per recuperare lo stato dell'ordine di un Contatto quando chiede informazioni sul suo ordine. Se l'API restituisce un errore 404, informa il Contatto che l'ordine non è stato trovato. ``` L'Agente AI usa questa descrizione per decidere quando attivare la richiesta. ### Informazioni di cui l'Agente AI potrebbe avere bisogno (opzionale) Definisci qui gli input richiesti prima di chiamare la tua API. Si tratta di variabili strutturate che l'AI deve raccogliere. La richiesta viene attivata solo dopo che tutti gli input richiesti sono disponibili. Se un valore è: * Già menzionato nella conversazione → l'AI lo usa. * Mancante → l'AI chiede al Contatto di fornirlo. Le variabili create qui possono essere usate nella configurazione dell'API. Le variabili del Contatto (come $contact.email) sono disponibili automaticamente e non devono essere aggiunte. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1SOzjJK2pM8p7CorIfIpLw/f4613151ecf044cacd5685035b823b06/httprequest2.png?fm=jpg&q=80&w=1200&fl=progressive) **Impostazioni del campo** | Campo | Annotazioni | | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nome | L'identificatore della variabile usato nella tua richiesta API. \- Unico per azione\- Solo lettere, numeri e underscore\- Sensibile alle maiuscole/minuscole\- Max 30 caratteri Riferiscilo usando: $agent.variable\_name Esempio: $agent.order\_id | | Formato | Definisce il tipo di dato previsto: \- Testo (predefinito)\- Numero\- Booleano\- Data Scegli il formato corretto per ridurre l'ambiguità e migliorare l'affidabilità. | | Descrizione | Spiega cosa rappresenta il valore e aiuta l'AI a chiederlo in modo chiaro.Esempio: ID ordine di 8 cifre dall'email di conferma. | | Array (opzionale) | Attivalo per raccogliere più valori invece di uno. Ogni elemento segue il Formato selezionato.Usalo quando ti aspetti:\- Più ID prodotto\- Diversi numeri di tracking • Selezioni multiple | ### Configurazione API Definisci come l'Agente AI deve chiamare la tua API. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/HXBkfyTj6XeXtOX4FMBNB/fe70bf8f63cdb56cd6025cdeff0a341a/apiconfig1.png?fm=jpg&q=80&w=1200&fl=progressive) Puoi configurare: * Metodo * URL * Parametri di query * Intestazioni * Corpo JSON (per POST, PUT, PATCH) **Riferimento alle variabili** Puoi inserire variabili nell'URL, nei parametri, nelle intestazioni o nel corpo usando $. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/VJWbtyiJ64nQ175Or2uAd/bd77f2a10db9c58cd207ab2fd4f03873/apiconfig2.png?fm=jpg&q=80&w=1200&fl=progressive) Ci sono due tipi: * Variabili del Contatto — campi esistenti del Contatto * `$contact.email` * Variabili dell'Agente AI — campi definiti in _Informazioni di cui l'Agente AI potrebbe avere bisogno_ * `$agent.order_id` Le variabili vengono sostituite con valori reali quando la richiesta viene eseguita. Se manca una variabile obbligatoria dell'Agente AI, l'AI la richiederà prima di attivare la chiamata API. **Come l'AI gestisce le risposte API** Esempio di body: ```json { "order_id": "$agent.order_id", "email": "$contact.email" } ``` L'Agente AI interpreta automaticamente la risposta JSON dell'API e genera una risposta naturale. Esempio di risposta API: ```json { "status": "shipped", "eta": "2025-12-12" } ``` Risposta AI: “Buone notizie! Il tuo ordine è stato spedito e dovrebbe arrivare il 12 dicembre 2025.” **Invio di immagini o file dalla risposta API** Se la risposta API include un URL valido di un'immagine o di un file (es. una pianta, una fattura o la foto di un prodotto), l'Agente AI può inviarlo come allegato renderizzato — lo stesso meccanismo usato per gli URL di Knowledge Source e Instruction. Vedi [Invio di file e immagini come allegati](https://respond.io/it/help/ai-agents/how-to-write-effective-ai-agent-prompts#sending-files-and-images-as-attachments). Questo richiede un'istruzione esplicita che lo autorizzi, per esempio: ```plain Invia immagine o file come allegato ogni volta che nella risposta API è presente un URL valido di immagine o file. ``` Senza questa istruzione, l'Agente AI utilizzerà l'URL solo per comporre la risposta testuale — non lo invierà come allegato. ## Test Puoi testare la tua azione di richiesta HTTP nel pannello **Test AI Agent** prima di pubblicare. ### Come testare 1. Avvia una conversazione di test che corrisponda alle condizioni della tua azione. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/78KDUCw0a23kfXjjNmSM3M/6033d09c4ccec2669a0f122442ed54ab/testinghttprequest1.png?fm=jpg&q=80&w=1200&fl=progressive) 2. Quando l'intento viene rilevato e gli input richiesti sono disponibili, l'Agente AI esegue la richiesta HTTP. 3. Un evento di esecuzione appare nel pannello di test: ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/29SmyR5RSQ4gQ5Z3DpuV3K/4763b778c773d906fcbf2659eecf471d/testinghttprequest2.png?fm=jpg&q=80&w=1200&fl=progressive) 1. **{AI Agent name} ha eseguito {Action name}** 2. Le risposte 2xx vengono considerate un successo 3. Tutti gli altri codici di stato vengono mostrati come errore 4. Clicca l'evento per visualizzare: 1. **Response** scheda (predefinita) — corpo completo della risposta API 2. **Request** scheda — payload completo della richiesta cURL 3. Opzione copia per il debug 5. Dopo aver ricevuto la risposta API, l'Agente AI genera una risposta basata sui dati restituiti. **Note importanti** * Gli eventi di esecuzione appaiono **solo nel pannello Test AI Agent**. Non appaiono nella Inbox o in Contact Activity. * Se mancano input obbligatori, l'Agente AI li richiederà prima di attivare la richiesta. ## Buone pratiche * Sii preciso nella descrizione dell'azione. Istruzioni vaghe portano ad attivazioni vaghe. * Definisci chiaramente gli input richiesti. Se l'AI deve chiedere qualcosa, rendilo ovvio. * Gestisci i casi di errore nelle tue istruzioni. * Testa sempre prima di pubblicare. * Evita di duplicare la logica già gestita dai Workflows a meno che non sia progettato intenzionalmente. ## Limitazioni * Massimo 10 azioni di richiesta HTTP per Agente AI. * Massimo per azione: * 20 campi di input dati * 50 parametri * 50 intestazioni * L'Agente AI determina quando chiamare l'API in base alla tua descrizione scritta. Istruzioni scritte male possono causare attivazioni impreviste. * La gestione della risposta API è automatica. Non puoi mappare manualmente i campi della risposta — l'AI interpreta il JSON contestualmente. * Gli eventi di esecuzione delle richieste HTTP appaiono solo nel pannello Test AI Agent e non in Contact Activity. * Gli Agenti AI vocali possono attivare l'azione Make HTTP requests. Tuttavia, la risposta API restituita non viene passata indietro all'Agente AI vocale per generare la risposta, il che significa che le conversazioni vocali non possono rispondere dinamicamente in base al risultato dell'API. * Se il tuo Agente AI aggiorna un campo contatto e usa anche quel campo in questa azione nello stesso turno, la richiesta invia sempre il valore precedente (o vuoto, se non è mai stato impostato). Questo accade indipendentemente da quale azione venga eseguita per prima. Se sei interessato, vota la [richiesta di funzionalità](https://respond.canny.io/feature-request/p/contact-field-http-request-ensure-http-requests-use-latest-contact-field-values). ## Domande frequenti e risoluzione problemi ### Posso attivare più endpoint API? Sì. Puoi configurare fino a 10 azioni di richiesta HTTP separate per Agente AI. ### Posso passare i dati del Contatto nell'API? Sì. Usa $contact.field\_name nell'URL, nelle intestazioni, nei parametri o nel corpo. ### Cosa succede se mancano i dati richiesti? L'Agente AI chiederà al Contatto le informazioni mancanti prima di attivare la richiesta. ### L'AI attende la risposta API? Sì. L'Agente AI attende la risposta, la interpreta e risponde in modo naturale basandosi sui dati restituiti. ### Posso chiamare un endpoint API che richiede l'autenticazione OAuth 2.0? No. HTTP Request non supporta i flussi di autenticazione OAuth 2.0, come il consenso dell'utente, lo scambio del codice di autorizzazione, l'aggiornamento del token di accesso o la generazione dinamica dei token. Puoi usare HTTP Request con endpoint che accettano metodi di autenticazione semplici, come API key o token statici aggiunti all'URL, ai parametri di query o agli header. Ad esempio, se stai chiamando un endpoint API di Google e la richiesta fallisce, verifica se quell'endpoint richiede l'autenticazione OAuth 2.0\. Se lo richiede, non è supportato. Se invece l'endpoint supporta API key o token statici, puoi usare quel metodo di autenticazione nella configurazione di HTTP Request. Condividi questo articolo [![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests) ## Articoli correlati 👩‍💻 * [Azione dell'Agente IA: Aggiungi commentiScopri come gli Agenti IA aggiungono commenti interni in respond.io per condividere il contesto, taggare i colleghi e agevolare il passaggio di consegne. ](/it/help/ai-skills/ai-agent-action-add-comments) * [Azione Agente AI: Assegna a un agente o a un teamScopri come gli Agenti AI assegnano le conversazioni ad agenti, team o ad altri Agenti AI su respond.io, inclusi i metodi di assegnazione, il comportamento di trasferimento e le principali limitazioni. ](/it/help/ai-skills/ai-skill-assign-to-agent-or-team) * [Azione dell'Agente IA: Chiudi le conversazioniScopri come funziona l'azione Chiudi conversazioni per gli Agenti IA in respond.io, incluso come attivarla, applicare le note di chiusura e gestire i riassunti. ](/it/help/ai-skills/ai-skill-close-conversations) * [Azione dell'Agente AI: Gestire le chiamateScopri come gli Agenti AI gestiscono le chiamate in entrata su respond.io, incluso il comportamento vocale, le opzioni di configurazione e le principali limitazioni. ](/it/help/ai-skills/ai-skill-handle-calls) * [Azione dell'Agente IA: Avvia workflowScopri come gli Agenti AI attivano Workflow esistenti in respond.io per eseguire automazioni e integrazioni avanzate. ](/it/help/ai-skills/ai-skill-trigger-workflow) Non riesci a trovare quello che stai cercando? 🔎 [Contatta il supporto](/it/contact-us) 2026-10-02T10:06:20.381Z help ```json {"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Scopri come l'azione Make HTTP requests dell'Agente AI permette al tuo Agente AI di chiamare API esterne durante le conversazioni per recuperare dati in tempo reale o attivare azioni in sistemi di terze parti.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/it/author"},"dateCreated":"2026-03-04T00:00:00.000Z","dateModified":"2026-10-02T08:29:04.095Z","datePublished":"2026-03-04T00:00:00.000Z","headline":"Azione Agente AI: Make HTTP requests","mainEntityOfPage":"https://respond.io/it/help/ai-skills","publisher":{"@id":"https://respond.io/#organization"},"url":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests"},{"@context":"https://schema.org","@id":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Help","item":"https://respond.io/it/help"},{"@type":"ListItem","position":2,"name":"Prodotto","item":"https://respond.io/it/help/product"},{"@type":"ListItem","position":3,"name":"Agenti di intelligenza artificiale","item":"https://respond.io/it/help/ai-agents"},{"@type":"ListItem","position":4,"name":"Azioni dell'Agente AI","item":"https://respond.io/it/help/ai-skills"},{"@type":"ListItem","position":5,"name":"Azione Agente AI: Make HTTP requests","item":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests"}]},{"@type":"Organization","@id":"https://respond.io/#organization","name":"Respond.io","alternateName":"respond.io","url":"https://respond.io/","image":["https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"],"logo":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4045649d540241d398c39ab07b2b62bb","description":"Respond.io is an AI-powered customer conversation platform that helps businesses manage conversations, automate workflows and scale sales, marketing and support operations. Trusted by 10,000+ B2C brands, it unifies WhatsApp, TikTok, Instagram and Facebook in a single AI-powered team inbox for chats, calls and campaigns.","email":"success@respond.io","telephone":"+6011-54211197","foundingDate":"2017-02-17","address":{"@type":"PostalAddress","streetAddress":"Level 41, Permata Sapura Tower, Jalan Pinang","addressLocality":"Kuala Lumpur","addressRegion":"Federal Territory of Kuala Lumpur","postalCode":"50088","addressCountry":"MY"},"areaServed":"Worldwide","contactPoint":{"@type":"ContactPoint","contactType":"Customer Service","url":"https://respond.io/contact"},"sameAs":["https://respond.io/","https://www.facebook.com/getrespondio/","https://www.linkedin.com/company/respondio/","https://play.google.com/store/apps/details?id=com.respond.inbox.io","https://www.youtube.com/@respondio","https://twitter.com/respond_io","https://apps.apple.com/my/app/respond-io-inbox/id1667772955","https://www.g2.com/products/respond-io/reviews","https://www.producthunt.com/products/respond-io","https://zapier.com/apps/respondio/integrations","https://www.capterra.com/p/179311/Rocketbots/","https://www.crunchbase.com/organization/respondio","https://builtin.com/company/respondio","https://respond-io.en.softonic.com/web-apps","https://my.jobstreet.com/companies/respondio-168558101085004","https://brandfetch.com/respond.io","https://webcatalog.io/en/apps/respond-io"],"knowsAbout":["WhatsApp API","WhatsApp Business API","WhatsApp CRM","WhatsApp automation","omnichannel communication platform","WhatsApp Business Multiple Users","WhatsApp BSP","WhatsApp Business Solution Provider","WhatsApp automation tool","WhatsApp team inbox","WhatsApp AI agent","WhatsApp Business AI chatbot","WhatsApp marketing software","conversational sales platform","WhatsApp appointment booking"]},{"@type":"WebPage","@id":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests#webpage","url":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests","name":"Azione Agente AI: Make HTTP requests","description":"Scopri come l'azione Make HTTP requests dell'Agente AI permette al tuo Agente AI di chiamare API esterne durante le conversazioni per recuperare dati in tempo reale o attivare azioni in sistemi di terze parti.","isPartOf":{"@id":"https://respond.io/#website"},"primaryImageOfPage":{"@type":"ImageObject","url":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"},"breadcrumb":{"@id":"https://respond.io/it/help/ai-skills/ai-skill-make-http-requests#breadcrumb"}},{"@type":"WebSite","@id":"https://respond.io/#website","name":"Respond.io","url":"https://respond.io/","potentialAction":{"@type":"SearchAction","query-input":"required name=search_term_string","target":"https://respond.io/search?query={search_term_string}"},"publisher":{"@id":"https://respond.io/#organization"}}]} ```