Capire i webhook nei flussi

Imparerai

Scopra i webhook nei flussi e come inviano informazioni da Klaviyo ai suoi strumenti e applicazioni di terze parti. È importante notare che l'impostazione dei webhook può essere complessa. Si consiglia di avere conoscenze di sviluppo o risorse di sviluppo per completare correttamente questa configurazione. Se sta cercando queste indicazioni di sviluppo, impari ad aggiungere un'azione webhook ad un flusso.

Cosa sono i webhook?

In poche parole, i webhook creano un modo completo per far dialogare tra loro tutti i tuoi strumenti di marketing e dati. Per fare un esempio, immaginiamo come funzionano l'online banking e la protezione antifrode della tua carta di credito. Se qualcuno usa la tua carta in modo fraudolento, la transazione viene registrata dal rivenditore e poi inviata alla tua banca, che la analizza e ti avvisa per telefono o via e-mail se c'è un problema con la tua carta. L'acquisto ha dato vita a una serie di sistemi che comunicano tra loro, spostano questi dati e infine ti avvisano. Molto probabilmente questi sistemi utilizzano dei webhook per trasmettere questi dati. webhook:

• Consente alla tua applicazione di passare informazioni o "chiamare" altre applicazioni, strumenti e server tramite una richiesta HTTP.
• Invia informazioni su un evento che si è verificato (ad esempio, un ordine effettuato, un nuovo cliente iscriviti, ecc.)
• Può comunicare al sistema che si è verificato un evento o notificare l'evento stesso.

Le informazioni sull'evento verranno poi consegnate nel modo e nel luogo da te scelto. In altre parole, i webhook rappresentano un modo prezioso per condividere i dati e le informazioni dall'interno di Klaviyo verso altri strumenti di marketing e nel modo che ritieni più opportuno.

Componenti chiave dei webhook

I webhook sono composti da alcuni pezzi:

• Trigger
  L'evento che provoca l'attivazione di un webhook
• Messaggio (o "il carico utile")
  Ciò che il webhook invia, come ad esempio i dettagli chiave sull'URL dell'evento scatenante dove viene inviato il messaggio o l'URL del sistema che riceve il messaggio.
• Intestazioni
  Un posto dove passare informazioni aggiuntive (come l'autenticazione)

Webhook nei flussi

I webhook sono attualmente disponibili solo all'interno di Flusso e vengono inviati quando un Flusso raggiunge una determinata fase o passaggio. Il sito webhook invierà quindi una richiesta POST con i dati relativi all'evento o al destinatario che ha attivato il Flusso.

È importante notare che solo un evento può avviare l'invio del webhook. Quando un iscritto soddisfa i criteri di attivazione, il sito webhook si attiva, inviando il messaggio all'URL designato. Inoltre, puoi inviare webhook solo a partire da eventi attivati da Flusso, ovvero eventi che possono essere utilizzati come trigger di Flusso. Ad esempio, non puoi inviare un webhook a seguito di una modifica della Proprietà del profilo, poiché un Flusso non può essere attivato direttamente dalle modifiche del profilo.
Esempi di eventi in Klaviyo sono:

• Ordine effettuato
• Avviato il checkout
• Iscritta alla lista

Casi d'uso dei webhook

È fondamentale comprendere i trigger di Flusso che possono generare webhook, oltre ad alcuni casi d'uso pratici su come implementarli con altre applicazioni.

Alcuni esempi sono:

• Invio di un messaggio per ri-coinvolgere i clienti decaduti.
• Inviare un messaggio il giorno del compleanno del tuo cliente e regalargli dei punti fedeltà.
• Inviare il sito webhook ogni volta che un nuovo iscritto si unisce al tuo elenco. Puoi inviare i loro dati del profilo a un'altra piattaforma.
• Inviare a un cliente un sondaggio NPS per saperne di più sul tuo iscritto.
• 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. Tuttavia, si noti che l'evento "Received Email" non viene considerato come un trigger di Flusso.

Esempio del mondo reale

Decidi di collegare Klaviyo al tuo strumento di direct mailing in modo da poter comunicare con i clienti online e per posta. Il tuo nuovo cliente Shah è andato sul tuo sito web e ha acquistato alcuni articoli dal tuo negozio e-commerce. Vuoi inviare a Shah un catalogo cartaceo della tua collezione completa in futuro.

È qui che il webhook può collegare queste esperienze. Il tuo negozio e-commerce è già integrato in Klaviyo. In Klaviyo, imposti un Flusso che si attiva in base all'evento Placed Order. Dovrai quindi fornirci il sito webhook dello strumento di direct mailing e includere nel messaggio dettagli come il nome del cliente, l'indirizzo e ciò che ha ordinato (cioè il payload).

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

Cosa non possono fare i webhook di Klaviyo?

I webhook non sono pensati per una sincronizzazione bidirezionale dei dati. Questo significa che, sebbene sia possibile collegare altre piattaforme a Klaviyo per inviare dati da noi a loro, non è possibile passare dati indietro a Klaviyo. Le informazioni possono fluire da Klaviyo verso i sistemi o le applicazioni designate a cui ti sei collegato, ma non possono fluire dall'altra parte. I webhook, a differenza delle API, funzionano solo in un'unica direzione.

È importante anche considerare gli eventi che sceglierai per richiedere le informazioni, la frequenza con cui ciò avverrà e la destinazione finale dei dati nel tuo sistema. Klaviyo fornisce il quadro di riferimento per collegare i tuoi dati di Flusso a una piattaforma, ma il valore finale dipende da dove vanno a finire le informazioni dopo aver lasciato Klaviyo e da cosa potenzialmente suggeriscono. Pertanto, Klaviyo può solo controllare se il sito webhook funziona e 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 attraverso il sito webhook in base al modo in cui funzionano i nostri trigger di Flusso. Ad esempio, non possiamo inviare dati di coinvolgimento per ogni volta che un iscritto apre un'e-mail, in quanto non è possibile attivare un Flusso basato sulle aperture.

Allo stesso modo, anche se puoi utilizzare variabili dinamiche basate sull'evento nel payload di webhook in un Flusso attivato da un evento, le variabili disponibili sono collegate all'evento originale che ha attivato il Flusso (come nel caso delle e-mail di Flusso). Ad esempio, se hai un carrello abbandonato Flusso attivato dall'evento Inizio pagamento, puoi utilizzare le variabili dinamiche di quell'evento nel payload del webhook. Tuttavia, se nello stesso Flusso utilizzi anche un filtro del flusso o split una metrica Added to Cart, non puoi includere questi dati aggiuntivi nel payload di webhook.

Pertanto, quando imposti il tuo webhook, è importante considerare ciò che Flusso può fornire per i punti dati e ciò che vuoi ottenere con la tua configurazione di webhook.

Attualmente, i codici coupon, i feed web e i feed di prodotto non sono supportati nei webhook di flusso.

Chi dovrebbe impostare i webhook?

Come già detto, i sistemi che connetti a Klaviyo, il modo in cui le informazioni o i dati vengono confezionati e i dati o le informazioni che decidi di acquisire sono completamente a tua discrezione.

Per questo motivo, consigliamo vivamente a una risorsa di sviluppo di impostare i webhook per assicurarsi che gli eventi giusti vengano inviati da Klaviyo e pubblicati correttamente nella tua applicazione. Klaviyo ti fornirà anche gli errori se un webhook fallisce. Tuttavia, potremmo non essere in grado di diagnosticare eventuali problemi più profondi nella configurazione del webhook o nel modo in cui i dati vengono inviati alla tua applicazione. 

Requisiti e considerazioni

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

• Solo i ruoli utente che hanno accesso alla creazione di flussi possono impostare i webhook in Klaviyo. Questo include i ruoli di Manager, Admin e Proprietario.
• Per una maggiore sicurezza, l' autenticazione in due passaggi deve essere abilitata all'interno del suo account per poter utilizzare i webhook o aggiungere nuove azioni webhook all'interno di un flusso esistente.

È pronto a preparare il tutto?

I webook forniscono potenti meccanismi per comunicare i dati da Klaviyo ad altri sistemi o applicazioni esterne. Se sei pronto a configurare il tuo webhook, puoi leggere la nostra guida alla documentazione per sviluppatori su Come aggiungere un'azione webhook a un Flusso.

Risorse aggiuntive

• Comprendere i trigger e i filtri del flusso
• Come visualizzare l'anteprima della configurazione di un trigger di flusso
• Come aggiungere un'azione webhook a un flusso