Capire i diversi webhook disponibili in Klaviyo
Cosa imparerai
Scopri le differenze tra le soluzioni webhook disponibili in Klaviyo e quando dovresti usare ciascuna di esse.
Prima di iniziare
Advanced Klaviyo Data Platform non è incluso nell’applicazione di marketing standard di Klaviyo e per accedere alle funzionalità associate è necessario un abbonamento. Visita la nostra guida alla fatturazione per scoprire come acquistare questo piano.
Che cosa sono i webhook?
I webhook consentono a Klaviyo di trasmettere informazioni o "chiamare" altre applicazioni, strumenti e server tramite richieste HTTP. Possono inviare informazioni su un evento che si è verificato (ad es. un ordine effettuato, un nuovo cliente iscritto, ecc.) oppure notificare ai tuoi sistemi esterni che l'evento si è verificato.
I webhook sono composti da alcuni componenti chiave:
- Argomento
L'evento che causa l'attivazione di un webhook. - Corpo (o “payload”)
I dati inviati dal webhook. - Intestazioni
Uno spazio per passare informazioni aggiuntive (ad esempio l'autenticazione).
Webhook del flusso
Puoi aggiungere webhook nei flussi come azione che si verifica quando il flusso raggiunge una determinata fase o un determinato passaggio. Quando un flusso raggiunge l'azione webhook, viene inviata una richiesta POST con dati sull'evento o sul destinatario che ha attivato il flusso, in base a come costruisci il payload.
I webhook del flusso possono inviare solo in base a eventi attivati dal flusso (cioè eventi che possono essere utilizzati come attivatore del flusso). Inoltre, i webhook del flusso non supportano eventi relativi ai messaggi (ad esempio, e-mail ricevuta, e-mail cliccata, e-mail contrassegnata come spam) perché i flussi in genere terminano con la ricezione del messaggio.
Annullare l'iscrizione al marketing via e-mail può essere utilizzato come trigger del flusso e come argomento per un webhook del flusso.
Casi d'uso di esempio per i webhook del flusso
Alcuni esempi di casi d'uso in cui i webhook dei flussi sarebbero più efficaci includono:
- Invia un messaggio o una richiesta POST che si attiva quando un iscritto viene aggiunto a un segmento o a un elenco.
- Automatizza la sospensione quando un profilo entra in un segmento non coinvolto.
- Invia un messaggio di ringraziamento personalizzato tramite un servizio come Whatsapp o Facebook Messenger quando chi acquista effettua un acquisto.
Webhook in Advanced Klaviyo Data Platform
Advanced KDP non è inclusa nell'applicazione di marketing standard di Klaviyo e per accedere alle funzionalità associate è necessario un abbonamento. Visita la nostra guida alla fatturazione per saperne di più sull'aggiunta di questa funzionalità al tuo piano o per iniziare se sei un nuovo cliente.
I webhook di Advanced KDP ti permettono di notificare sistemi esterni in risposta a eventi, senza dipendere da una serie di passaggi che portano all'azione di webhook. I webhook avanzati della Klaviyo Data Platform non richiedono la costruzione manuale o la specificazione del corpo della richiesta webhook. Se vuoi notificare ai tuoi sistemi esterni che si è verificato un evento senza alcuno sviluppo personalizzato, i webhook in Advanced Klaviyo Data Platform sono i più efficaci.
I webhook Advanced Klaviyo Data Platform supportano anche un’ampia gamma di argomenti per attivare la richiesta e consentono di inviare informazioni in risposta a qualsiasi evento che può essere interrogato tramite la API Get Events.
Tra questi rientrano:
- Eventi e-mail (ad esempio, e-mail ricevuta, e-mail cliccata, e-mail contrassegnata come spam)
- Eventi SMS (ad es. SMS inviato, SMS ricevuto)
- Eventi notifiche push (ad esempio, push ricevuta, push rimbalzata)
- Eventi dalle integrazioni (ovvero, eventi dalle integrazioni first-party create da Klaviyo)
- Eventi API (ad es., eventi sincronizzati tramite le API di Klaviyo)
Sono inclusi eventi relativi ai messaggi come Annullare l'iscrizione, E-mail ricevuta o E-mail cliccata che non sono supportati dai webhook del flusso.
Inoltre, i webhook di Advanced KDP ti permettono di iscriviti a più trigger contemporaneamente, a differenza dei webhook di Flusso, che dipendono da Flusso a singolo trigger.
Gli URL di destinazione devono essere endpoint HTTP accessibili pubblicamente.
Casi d'uso di esempio per i webhook di Advanced Klaviyo Data Platform
- Sincronizza gli eventi annullare l'iscrizione dei clienti con sistemi esterni.
- Segnala gli eventi E-mail ricevuta al software dell'help desk in modo che gli agenti possano vedere la cronologia delle e-mail per servire meglio i clienti.
- Sincronizza tutti gli invii, le aperture e i clic delle e-mail in un magazzino dati non supportato dalla sincronizzazione del magazzino dati di Klaviyo.
Codice
Il codice è una funzionalità inclusa in Klaviyo Advanced KDP. Non è inclusa nell'applicazione di marketing standard di Klaviyo e per accedere alle funzionalità associate è necessario un abbonamento alla Advanced KDP. Visita la nostra guida alla fatturazione per saperne di più sull'aggiunta di questa funzionalità al tuo piano o per iniziare se sei un nuovo cliente.
Il codice sfrutta i webhook per consentire l’esecuzione di funzioni personalizzate in risposta all’attivazione di un evento. Puoi scrivere il codice direttamente nell’editor di Klaviyo e Klaviyo gestisce l’esecuzione, il monitoraggio e la registrazione del codice.
Se vuoi inviare richieste ai tuoi sistemi esterni senza ospitare un endpoint HTTP pubblico, puoi usare Code. Inoltre, se vuoi eseguire funzioni personalizzate in risposta al verificarsi di un evento, dovresti usare Code invece delle altre soluzioni webhook disponibili in Klaviyo.
Il codice offre anche una maggiore granularità con i trigger degli eventi rispetto ai webhook in Advanced KDP. Puoi selezionare una singola metrica come argomento piuttosto che tutte le integrazioni o gli eventi di API.
Tieni presente che Code non supporta i seguenti eventi come argomenti:
- E-mail aperta
- E-mail ricevuta
Casi d'uso del codice di esempio
- Importa le librerie JSON di Python per analizzare i payload degli eventi ed estrarre qualcosa.
- Imposta Proprietà del profilo personalizzate in base ai metadati dell'evento utilizzando le API di Klaviyo.
- Importa le librerie di chatGPT e crea un messaggio personalizzato per ciascun carrello abbandonato in base al profilo e agli articoli nel carrello.
Risorse aggiuntive
- Come funzionano i webhook nei flussi
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 stai cercando queste indicazioni di sviluppo, scopri come aggiungere un’azione webhook a un flusso.
- Capire i webhook all'interno di Advanced KDP
Scopri i webhook e come puoi usarli per inviare informazioni alle tue applicazioni di terze parti in risposta agli eventi acquisiti in Klaviyo. Per informazioni più dettagliate su come ricevere i webhook di sistema, vai alla nostra risorsa per sviluppatori su come lavorare con i webhook di sistema.
- Primi passi con Code
Scopri Code e come creare funzioni personalizzate eseguite direttamente da Klaviyo.