Come funzionano i webhook nei flussi

Cosa imparerai

Scopri i webhook nei flussi e come inviano informazioni da Klaviyo ai tuoi strumenti e applicazioni di terze parti. È importante notare che configurare i webhook può essere complesso. È consigliabile avere conoscenze di sviluppo o risorse di sviluppo per completare correttamente questa configurazione. Se cerchi queste indicazioni di sviluppo, scopri come aggiungere un'azione webhook a un flusso.

Che cosa sono i webhook?

In poche parole, i webhook creano un modo completo per consentire a tutti gli strumenti di marketing e dati di comunicare tra loro. Come esempio, immaginiamo come funzionano l'online banking e la protezione dalle frodi sulla tua carta di credito. Se qualcuno utilizza fraudolentemente la tua carta, la transazione viene registrata dal rivenditore e poi inviata alla tua banca, che la analizza e ti avvisa tramite telefono o e-mail quando c’è un problema con la tua carta. Questo acquisto ha portato una serie di sistemi a comunicare, spostare questi dati e, in ultima analisi, avvisarti. È molto probabile che questi sistemi utilizzino i webhook per trasmettere questi dati. webhook:

• Consenti alla tua applicazione di passare informazioni o di “chiamare” altre applicazioni, strumenti e server tramite richiesta HTTP.
• Invia informazioni su un evento che si è verificato (ad es. un ordine effettuato, un nuovo cliente che si è iscritto, ecc.).
• Può indicare al tuo sistema che si è verificato un evento o notificarti quell’evento.

Queste informazioni sull'evento verranno quindi inviate nella modalità e nella posizione che preferisci. In altre parole, i webhook offrono modi preziosi per condividere dati e informazioni da Klaviyo ai tuoi altri strumenti di marketing e strumenti, nel modo che ritieni più opportuno.

Componenti chiave dei webhook

I webhook sono composti da alcuni elementi:

• Attivazione
  L’evento che fa scattare un webhook
• Messaggio (o "il payload")
  Cosa invia il webhook, come i dettagli chiave dell'evento di attivazione, l'URL a cui viene inviato il messaggio o l'URL del sistema che riceve il messaggio
• Intestazioni
  Uno spazio per passare informazioni aggiuntive (come l'autenticazione)

Webhook nei flussi

I webhook sono attualmente disponibili solo nei flussi e inviano un messaggio quando un flusso raggiunge una determinata fase o passaggio. Il webhook invierà quindi una richiesta POST con i dati sull'evento o sul destinatario che ha attivato il flusso.

È importante notare che un solo evento può avviare l'invio del webhook. Quando un iscritto soddisfa i criteri di attivazione, il webhook si attiva e invia il messaggio all'URL designato. Inoltre, puoi inviare webhook solo a partire da eventi attivati dal flusso, cioè eventi che possono essere usati come attivatori di un flusso. Ad esempio, non puoi inviare un webhook a partire dalla modifica di una Proprietà del profilo, perché un flusso non può attivarsi direttamente dalle modifiche del profilo.
Esempi di eventi in Klaviyo includono:

• Ordine effettuato
• Pagamento avviato
• Iscritto all'elenco

Casi d’uso dei webhook

È fondamentale comprendere gli attivatori del flusso che possono generare webhook, oltre ad alcuni casi d'uso pratici su come implementarli con le altre applicazioni.

Gli esempi includono:

• Inviare un messaggio per ricoinvolgere i clienti inattivi.
• Inviare un messaggio il giorno del compleanno dei clienti e offrire loro un regalo sotto forma di punti fedeltà.
• Invio del webhook ogni volta che un nuovo iscritto entra nei tuoi elenchi. Puoi inviare i dati del suo profilo a un’altra piattaforma.
• Inviare a un cliente un sondaggio NPS per scoprire di più sui tuoi iscritti.
• Invio di un messaggio o di una richiesta POST che si attiva in base all’aggiunta di un iscritto a un segmento o a un elenco. Tieni presente, tuttavia, che non supportiamo l'evento "Received Email" come trigger per un flusso.

Esempio reale

Decidi di collegare Klaviyo al tuo strumento di direct mailing, così da poter comunicare con i clienti online e tramite posta. Il tuo nuovo cliente Shah è andato sul tuo sito web e ha acquistato alcuni articoli dal tuo negozio e-commerce. In futuro vuoi inviare a Shah un catalogo cartaceo con l’intera collezione.

Qui è dove il webhook può collegare tra loro queste esperienze. Avresti già il tuo negozio e-commerce integrato in Klaviyo. In Klaviyo, configuri un flusso che si attiva in base all'evento Placed Order. Poi ci fornisci il webhook dello strumento di direct mailing e includi nel messaggio dettagli come il nome e l'indirizzo del cliente e cosa ha ordinato (ovvero il payload).

Ora, ogni volta che qualcuno (come Shah) effettua un ordine, un evento potrebbe avviare l’invio di un catalogo stampato al suo indirizzo. L’evento di acquisto del webhook attiverà l’invio di informazioni al tuo strumento di direct mailing potenzialmente in tempo reale direttamente da Klaviyo (ad esempio il messaggio o il payload).

Cosa non possono fare i webhook Klaviyo?

I webhook non sono pensati per una sincronizzazione bidirezionale dei dati. Ciò significa che, anche se puoi collegare altre piattaforme a Klaviyo per inviare dati da noi a loro, non puoi inviare dati a Klaviyo. Le informazioni passeranno da Klaviyo ai sistemi o alle applicazioni designati che hai collegato, ma non potranno passare nell’altra direzione. I webhook, a differenza delle API, funzionano solo in questa modalità a senso unico.

È anche importante considerare gli eventi che scegli per attivare la richiesta di informazioni, con quale frequenza ciò accadrà e dove questi dati finiranno nel tuo sistema. Klaviyo fornirà la struttura per collegare i dati del tuo flusso a una piattaforma, ma il valore finale dipende da dove vanno queste informazioni dopo aver lasciato Klaviyo e da cosa potrebbero attivare. Di conseguenza, Klaviyo può solo monitorare se il webhook funziona, non dove vanno i dati o cosa fanno dopo aver lasciato il nostro sistema.

Infine, è importante considerare i dati che Klaviyo può e non può inviare tramite un webhook. Klaviyo non può inviare determinati punti dati tramite un webhook in base al modo in cui funzionano i trigger dei nostri flussi. Ad esempio, non possiamo inviare i dati di coinvolgimento degli utenti delle e-mail ogni volta che un iscritto apre un’e-mail, perché non puoi attivare un flusso in base alle aperture.

Allo stesso modo, anche se puoi usare variabili dinamiche basate su eventi nel payload del webhook in un flusso attivato da un evento, le variabili disponibili sono collegate all’evento originale che ha attivato il flusso (ovvero, proprio come per le e-mail del flusso). Ad esempio, se hai un flusso di carrello abbandonato attivato dall’evento Started Checkout, puoi usare nel payload dei webhook le variabili dinamiche di quell’evento. Ma se nello stesso flusso stai anche usando un filtro del flusso o uno split con una metrica Added to Cart, non puoi includere questi dati aggiuntivi nel payload del webhook.

Quindi, quando configuri i webhook, è importante considerare quali flussi possono supportare per i punti dati e cosa vuoi ottenere con la configurazione dei webhook.

Al momento, i codici coupon, i feed web e i feed dei prodotti non sono supportati nei webhook del flusso.

Chi dovrebbe configurare i webhook?

Come indicato sopra, i sistemi che colleghi a Klaviyo, il modo in cui le informazioni o i dati vengono organizzati e quali dati o informazioni scegli di acquisire sono completamente a tua discrezione.

Tenendo presente questo, consigliamo vivamente di coinvolgere una risorsa di sviluppo per configurare i webhook e assicurarti che gli eventi giusti vengano inviati da Klaviyo e pubblicati correttamente nella tua applicazione. Klaviyo ti fornirà anche gli errori se un webhook non riesce. Tuttavia, potremmo non essere in grado di diagnosticare problemi più profondi relativi alla configurazione del webhook o al modo in cui, in ultima analisi, i dati vengono pubblicati sulla tua applicazione.

Requisiti e considerazioni

Oltre ad assicurarti di avere una risorsa di sviluppo per configurare correttamente il tuo webhook e testarlo sul sistema associato, Klaviyo ha alcuni requisiti chiave per utilizzare questa funzionalità:

• Solo i ruoli utente che hanno accesso per creare flussi possono configurare i webhook in Klaviyo. Sono inclusi i ruoli di Manager, Amministratore e Proprietario.
• Per una maggiore sicurezza, l’autenticazione a due passaggi deve essere abilitata nel tuo account per poter utilizzare i webhook o aggiungere nuove azioni webhook all’interno di un flusso esistente.

Prontə per configurare?

I webhook offrono potenti meccanismi per comunicare dati da Klaviyo ad altri sistemi o applicazioni esterni. Se sei pronto a configurare i tuoi webhook, puoi leggere la nostra guida alla documentazione per sviluppatori su Come aggiungere un’azione webhook a un flusso.

Risorse aggiuntive