Utilizzare i webhook con i flussi di lavoro di HubSpot

Usa i webhooks nei flussi di lavoro per inviare richieste POST o GET dai tuoi flussi di lavoro. Ci sono una varietà di usi per i webhooks, esempi di casi d'uso popolari per i webhooks includono:

• Inviare i dati dei contatti di HubSpot a un altro sistema, come un CRM, quando quel contatto compila un particolare modulo sul tuo sito.

• Invio dei dati dell'affare a un sistema esterno di gestione delle spedizioni per creare un ordine di acquisto.

• Invio di avvisi di chat dal sistema esterno al flusso di chat dell'azienda per notificare ai dipendenti che è successo qualcosa di importante.

• Recuperare dati da un altro sistema per aggiornare i tuoi record di HubSpot.

HubSpot regola il traffico webhook separatamente dagli altri processi di workflow. Questo viene fatto per ottimizzare il flusso di lavoro e le prestazioni del webhook. Quando un webhook è lento o va in time out, l'azione del workflow potrebbe richiedere più tempo del previsto per essere eseguita.

Nota: HubSpot riproverà i webhook falliti per un massimo di tre giorni, a partire da un minuto dopo il fallimento. I fallimenti successivi saranno riprovati a intervalli crescenti, con un intervallo massimo di otto ore tra i tentativi. Scopri le specifiche eccezioni dei codici di errore nella documentazione per gli sviluppatori di HubSpot.

Scopri di più sui webhooks nella documentazione per gli sviluppatori webhooks. Se hai domande sull'implementazione specifica dei webhook con HubSpot, contatta il forum degli sviluppatori di HubSpot.

Imposta un webhook nel tuo flusso di lavoro

• Nel tuo account HubSpot, naviga su Automazione > Flussi di lavoro.
• Clicca sulnomedel flusso di lavoro.
• Clicca sull'icona +per aggiungere un'azione.
• Nel pannello di destra, selezionaInvia un webhook.
• Fai clic sul menu a discesa Method, quindi seleziona POST o GET.
• Inserisci l'URL del webhook. Gli URL webhook sono limitati a un protocollo sicuro e devono iniziare con HTTPS. Per richiedere informazioni specifiche, aggiungere parametri di query all'URL Webhook. Se non sono stati aggiunti parametri di query, verrà inviata una richiesta generica POST o GET.
• Per autenticare qualsiasi richiesta al tuo webhook:
  • Fai clic sul menu a discesa del tipo di autenticazione, quindi seleziona Includi la firma della richiesta nell'intestazione.
  • Inserisci il tuo ID HubSpot App. Scopri comeverificare le firme delle richieste.
• Fare clic su Save.
  
  

Prova il tuo webhook all'interno di HubSpot

Quando imposti il tuo webhook POST o GET, puoi eseguire un test per visualizzare la risposta del webhook. Durante il test, mentre i dati vengono inviati e recuperati da una terza parte, i record esistenti in HubSpot non saranno interessati.

Dopo aver testato il webhook, è possibileselezionare quali campi per l'output da utilizzare come input in seguito nel tuo flusso di lavoro. Seleziona solo gli output disponibili in ogni risposta. Se l'output viene utilizzato in un'azione successiva ma non è disponibile nella risposta, l'azione fallirà.

• Nel pannello laterale, clicca su Test action per espandere la sezione.
• Fai clic sul menu a discesa Oggetto, quindi seleziona un Record da testare.
• Fai clic su Test.
• Per controllare i dettagli del webhook, seleziona la scheda Response o Request. In ogni scheda, è possibile fare clic su Open all per espandere tutte le sezioni o su Collapse all per comprimere tutte le sezioni.
  
  • Nella scheda Response, clicca su headers: o body: per espandere ogni sezione.
  • Nella scheda Request , fai clic su httpHeaders: per espandere la sezione.
    
    

Testare il webhook esternamente

Dopo aver creato il flusso di lavoro con un'azione webhook, è possibile eseguire un rapido test con un URL webhook fittizio:

• Nel tuo browser, vai su https://webhook.site e copia l'URL unico.
• Nel campo Webhook URL nell'azione webhook, incollare l'URL.
  
  

• Una volta che il flusso di lavoro è stato attivato, è possibile iscrivere manualmente un contatto di prova.

Se viene attivata un'azione webhook con una richiesta POST, un corpo di risposta JSON verrà inviato al webhook contenente tutte le informazioni sul contatto, compresi i moduli inviati, le iscrizioni alle liste e tutti i valori delle proprietà del contatto. Il sistema ricevente può quindi analizzare i dati JSON e usarli per la propria applicazione.

Se viene attivata un'azione webhook con una richiesta GET, verrà inviata una richiesta GET generica, a meno che non siano stati applicati parametri di query aggiuntivi.

Nota: i valori delle proprietà storiche saranno restituiti solo nei flussi di lavoro basati sui contatti. I webhook utilizzati in tutti gli altri tipi di flusso di lavoro restituiranno solo il valore più recente.

Verificare le firme delle richieste nei webhook del flusso di lavoro

Se hai selezionato Request signature nella sezione Authentication per la tua azioneTrigger a webhook, HubSpot popolerà il webhook con un'intestazione X-HubSpot-Signature con un hash SHA-256 della concatenazione dell'app-secret della tua applicazione, il metodo HTTP, l'URI e il corpo non analizzato. Per saperne di più su questo nelladocumentazione per gli sviluppatori.

Per verificare che le richieste ricevute al tuo URL provengano da HubSpot:

• Possedere un account da sviluppatore. Se non ne hai uno, registrati per un account sviluppatore.
• Possedere un'app. Se non hai un'app, impara a creare un'app.
• Controlla il valore dell'hash della firma.