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?Cosa sono i webhook?
In poche parole, i webhook creano un modo completo per far dialogare tutti i suoi strumenti di marketing e di dati. A titolo di esempio, immaginiamo come funziona l'online banking e la protezione dalle frodi sulla carta di credito. Se qualcuno usa la sua carta in modo fraudolento, la transazione viene registrata dal rivenditore e poi inviata alla sua banca, che la analizza e la avvisa via telefono o e-mail quando c'è un problema con la sua carta. L'acquisto ha indotto una serie di sistemi a comunicare, a spostare questi dati e, infine, ad avvisare l'utente. Molto probabilmente questi sistemi utilizzano i webhook per trasmettere questi dati.
I webhook consentono alla sua applicazione di passare informazioni o di "chiamare" altre applicazioni, strumenti e server tramite una richiesta HTTP. I webhook inviano informazioni su un evento che si è verificato (ad esempio, un ordine effettuato, un nuovo cliente iscritto, ecc). I webhook possono comunicare al suo sistema che si è verificato un evento o notificare l'evento stesso.
Queste informazioni sull'evento saranno poi consegnate nel modo e nel luogo da lei scelti. In altre parole, i webhook rappresentano un modo prezioso per condividere dati e informazioni dall'interno di Klaviyo, verso altri strumenti di marketing e di lavoro, nel modo che lei ritiene più opportuno.
Non dovrebbe utilizzare i webhook per iscrivere i profili a nuove liste.
Componenti chiave dei webhook
I webhook sono composti da alcuni pezzi:
-
Innesco
l'evento che provoca l'attivazione di un webhook -
Messaggio (o "il carico utile")
ciò che il webhook invia, come 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 dei flussi e vengono inviati quando un flusso raggiunge una determinata fase o passaggio. Il 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 abbonato soddisfa i criteri di attivazione, il webhook si attiva, inviando il messaggio all'URL designato. Inoltre, può inviare webhook solo a partire da eventi innescati dal flusso, ossia eventi che possono essere utilizzati come innesco del flusso. Ad esempio, non può inviare un webhook in seguito alla modifica di una proprietà del profilo, in quanto un flusso non può essere attivato direttamente dalle modifiche del profilo.
Esempi di eventi in Klaviyo includono:
- 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.
Gli esempi includono:
- Inviare un messaggio per riattivare i clienti decaduti
- Inviare un messaggio nel giorno del compleanno dei suoi clienti e fare loro un regalo sotto forma di punti fedeltà.
- Inviare il webhook ogni volta che un nuovo abbonato si unisce alle sue liste. Può inviare i dati del loro profilo al suo CDP o CRM, in modo da avere sempre un registro completo degli abbonati sul suo conto.
- Inviare a un cliente un sondaggio NPS per conoscere meglio i suoi abbonati
- Invio di un messaggio o di una richiesta POST che si attiva in base all'aggiunta di un abbonato a un segmento o a una lista (ad esempio, un cliente che effettua un ordine). Tuttavia, si noti che non supportiamo l'evento "Email ricevuta" come trigger di flusso.
Esempio del mondo reale
Lei decide di collegare Klaviyo al suo strumento di direct mailing, in modo da poter comunicare con i clienti online e per posta. Il suo nuovo cliente Shah è andato sul suo sito web e ha acquistato alcuni articoli dal suo negozio di e-commerce. Vuole inviare a Shah un catalogo stampato della sua collezione completa in futuro.
Qui è dove il webhook può collegare queste esperienze. Avrebbe già il suo negozio di e-commerce integrato in Klaviyo. In Klaviyo, lei imposta un flusso che si attiva in base all'evento Ordine effettuato. Dovrebbe quindi fornirci il webhook dello strumento di direct mail 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 un catalogo stampato da inviare al suo indirizzo. L'evento di acquisto webhook richiederà l'invio di informazioni al suo strumento di direct mailing in potenziale 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 essere una sincronizzazione bidirezionale dei dati. Ciò significa che, sebbene possa collegare altre piattaforme a Klaviyo per inviare i dati da noi a loro, non può trasmettere i dati a Klaviyo. Le informazioni fluiranno da Klaviyo verso i sistemi o le applicazioni designate a cui lei si è collegato, ma non potranno fluire dall'altra parte. I webhook, a differenza delle API, funzionano solo in questa modalità unidirezionale.
È anche importante considerare gli eventi che sceglie per richiedere le informazioni, la frequenza con cui ciò avverrà e la destinazione finale dei dati nel suo sistema. Klaviyo fornirà la struttura per collegare i dati dei suoi flussi a una piattaforma, ma il valore finale dipende da dove vanno a finire le informazioni dopo aver lasciato Klaviyo e da che cosa potenzialmente possono suggerire. Pertanto, Klaviyo può solo monitorare se il 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 alcuni punti di dati attraverso un webhook, in base al modo in cui funzionano i nostri trigger di flusso. Ad esempio, non possiamo inviare i dati di coinvolgimento delle aperture delle e-mail per ogni volta che un abbonato apre un'e-mail, in quanto non è possibile attivare un flusso basato sulle aperture.
Allo stesso modo, mentre può utilizzare le variabili dinamiche basate sull'evento nel suo payload webhook in un flusso innescato da un evento, le variabili disponibili sono collegate all'evento originale che ha innescato il flusso (ad es. proprio come nel caso delle e-mail di flusso). Per esempio, se ha un flusso Carrello abbandonato attivato dall'evento Checkout avviato, può utilizzare le variabili dinamiche di quell'evento nel payload dei webhook. Ma se nello stesso flusso utilizza anche un filtro di flusso o una suddivisione che utilizza una metrica Added to Cart, non può includere questi dati aggiuntivi nel payload del webhook.
Pertanto, quando imposta i suoi webhook, è importante considerare quali flussi può supportare per i punti di dati e cosa vuole ottenere con la sua 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 lei collega a Klaviyo, il modo in cui le informazioni o i dati sono confezionati e quali dati o informazioni sceglie di prendere, sono completamente a sua discrezione.
Per questo motivo, consigliamo vivamente a una risorsa di sviluppo di impostare i webhook per garantire che gli eventi giusti vengano inviati da Klaviyo e postati correttamente nella sua applicazione. Klaviyo le fornirà anche gli errori se un webhook fallisce. Tuttavia, potremmo non essere in grado di diagnosticare eventuali problemi più profondi con l'impostazione del webhook o il modo in cui i dati vengono inviati alla sua applicazione. Suggeriamo di consultare la nostra guida Come aggiungere un'azione Webhook a un flusso per assicurarsi di aver impostato correttamente l'azione.
Requisiti e considerazioni di Klaviyo Webhooks
Oltre ad assicurarsi di avere una risorsa di sviluppo per impostare correttamente il suo webhook e testarlo sul suo 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 di marketing esterni. Se è pronto a configurare i suoi webhook, può leggere la nostra guida alla documentazione per sviluppatori su Come aggiungere un'azione webhook a un flusso.
Risorse aggiuntive