BetaUtilizzo dei webhook negli agenti

Utilizza le azioni webhook negli agenti per inviare e ricevere dati da sistemi esterni. Puoi configurare le azioni webhook nel generatore di agenti per effettuare richieste HTTP (ad esempio, GET o POST), per attivare processi esterni o recuperare dati.

Le azioni webhook consentono di collegare gli agenti a strumenti esterni senza richiedere integrazioni personalizzate. Ad esempio, è possibile inviare i dati relativi a un'operazione a un sistema esterno per avviare l'evasione dell'ordine, oppure recuperare le informazioni sui clienti da un'altra piattaforma e utilizzarle nell'output dell'agente.

Nota: puoi gestire l'accesso delle funzionalità IA nelle tue impostazioni IA e configurare quali dati vengono condivisi. Consulta le domande frequenti sull'attendibilità dell'IA e le schede dei modelli di IA di HubSpot per informazioni dettagliate su controlli di sicurezza IA, utilizzo dei dati e conformità.

Prima di iniziare

Prima di iniziare a utilizzare i webhook negli agenti, esamina i requisiti e le considerazioni.

• Un Super Admin deve attivare le seguenti opzioni nelle Impostazioni AI:

  • Concedere agli utenti l’accesso agli strumenti e alle funzionalità di IA generativa

  • Dati CRM

  • Dati di conversione dei clienti

  • Dati relativi ai file

  • Consenti agli utenti l'accesso a Breeze Assistant

Aggiungi un'azione webhook a un agente

Aggiungi un'azione webhook nel generatore di agenti per inviare dati a un sistema esterno o recuperarli da esso. Utilizza il menu a tendina "Metodo" per selezionare la modalità di comunicazione dell'agente con l'URL del webhook:

• GET: recupera valori da un altro sistema. Utilizza le richieste GET quando l’agente deve fare riferimento a informazioni provenienti da un sistema esterno in una fase successiva dell’esecuzione dell’agente, come lo stato di un abbonamento, lo stato di un ordine o un campo del profilo cliente.

• POST: invia valori a un altro sistema. Utilizza le richieste POST quando l’agente deve attivare o aggiornare qualcosa al di fuori di HubSpot, come la creazione di una richiesta di evasione, l’invio di una notifica o l’aggiornamento di un record esterno.

Per aggiungere un'azione webhook:

1. Nel tuo account HubSpot, clicca su Altro, quindi vai su Agenti > Hub degli agenti. Se la voce Altro non compare nel tuo account, vai direttamente su Agenti > Hub degli agenti.

2. Fai clic sulla scheda Agenti.

3. Fai clic su Modifica sulla scheda di un agente esistente oppure crea un nuovo agente.

4. Nel generatore di agenti, clicca su Aggiungi azione nella sezione Azioni.

5. Nel pannello di destra, inserisci "Invia un webhook " nel campo " Cerca ". Quindi fai clic sull'azione "Invia un webhook ".

6. Fai clic sul menu a discesa "Metodo " e seleziona il tipo di richiesta (ad esempio, POST o GET).

7. Nel campo " URL webhook ", inserisci l'URL a cui deve essere inviata la richiesta.

8. Fai clic sul menu a discesa Tipo di autenticazione e seleziona un tipo di autenticazione.

9. A seconda del metodo selezionato (ad esempio, GET o POST), configura i valori da includere nella richiesta.

   • Per le richieste GET, nella sezione "Parametri di query", fare clic su "Aggiungi valore statico" per aggiungere i nomi e i valori da appendere all'URL del webhook.

   • Per le richieste POST, nella sezione Corpo della richiesta, fare clic su Aggiungi valore statico per aggiungere i valori da includere nel corpo della richiesta del webhook.

10. Per testare l’azione del webhook, fare clic su Prova. Esaminare la risposta per confermare che la richiesta sia configurata correttamente. Se il test fallisce, verificare l’URL del webhook, il metodo, il tipo di autenticazione, i parametri di query o il corpo della richiesta, quindi ripetere il test dell’azione.

11. Al termine, fare clic su Salva e aggiungi.
12. Continua a personalizzare l’agente e poi pubblicalo.

Passaggi successivi

• Creare e personalizzare gli agenti nel generatore di agenti
• Esegui gli agenti e controlla i risultati nella casella di posta in arrivo degli agenti
• Verifica i costi di credito stimati quando utilizzi gli agenti