I webhook ti consentono di estendere le capacità di flusso automatizzato di Omnisend collegando sistemi e servizi esterni. Ti consentono di attivare eventi in altre piattaforme o inviare dati in tempo reale, migliorando la funzionalità dei tuoi flussi di lavoro automatizzati.
In questa guida, ti guideremo attraverso come configurare e utilizzare i webhooks nelle automazioni di Omnisend, con esempi e casi d'uso.
⚠️ Disponibilità del Piano: I webhook nelle Automazioni sono disponibili solo per i Piani a pagamento. Per utilizzare questa funzionalità, aggiorna il tuo Piano alla voce Impostazioni Negozio → Fatturazione.
⚠️ Importante: L'implementazione dei webhook richiede un notevole impegno da parte vostra e spesso richiede il coinvolgimento di uno sviluppatore. Potrebbe essere necessario preparare endpoint API dedicati, gestire i payload e garantire una corretta integrazione tra Omnisend e sistemi esterni.
Cosa sono i webhook?
I webhook sono callback HTTP che inviano dati in tempo reale da Omnisend ad altri servizi quando si verificano specifici eventi di flusso automatizzato. Questo ti permette di:
Notifica i sistemi di terze parti sugli eventi di flusso automatizzato.
Invia messaggi personalizzati tramite piattaforme come WhatsApp.
Attiva flussi di lavoro personalizzati in CRM, strumenti di gestione dei progetti o piattaforme di comunicazione come Slack.
Analogia 💡 Un sistema di cercapersone per ristoranti
Immagina di essere in un ristorante e di ricevere un cercapersone per avvisarti quando il tuo tavolo è pronto. Questo cercapersone è come un webhook, che ti avvisa di eventi specifici senza che tu debba controllare manualmente.
Comprendere la struttura e i componenti dei webhook
Quando si configurano i webhook in Omnisend, è fondamentale comprendere i componenti chiave coinvolti nella configurazione di una richiesta webhook.
Questa sezione illustra la struttura e i componenti che incontrerai durante la modifica di un webhook in Omnisend:
Componente 1. URL webhook
L'URL è l'endpoint di destinazione in cui verranno inviati i dati del tuo webhook. Questo è in genere un sistema o servizio esterno che gestirà ed elaborerà i dati inviati da Omnisend.
Importante ⚠️Assicurati che questo URL sia corretto e accessibile. Se il servizio ricevente richiede una comunicazione sicura, assicurati che l'URL inizi con https:// for encrypted transmission.
Componente 2. Intestazioni
I webhook ti consentono di includere intestazioni aggiuntive con la tua richiesta. Le intestazioni sono coppie chiave-valore che contengono metadati sulla richiesta webhook o fungono da autenticazione per il sistema ricevente.
Chiave. Il nome dell'intestazione (ad esempio,
Authorization,Content-Type).Valore. Il valore associato alla chiave dell'intestazione (ad es.,
Bearer your_access_token,application/json).Esempio di intestazioni:
Authorization: Bearer your_access_tokenContent-Type: application/json
Caso d'uso comune. Se il tuo servizio di ricezione richiede autenticazione, come una Chiave API o un token, dovresti passarla nelle intestazioni.
Suggerimento 💡 Verifica sempre che le intestazioni necessarie siano configurate correttamente per evitare richieste non autorizzate o fallite.
Componente 3. Corpo
Il Corpo è dove vengono inviati i dati effettivi (payload). Contiene le informazioni pertinenti che desideri passare al sistema esterno, come i dettagli del Cliente, le informazioni sull'Ordine o trigger di eventi specifici.
Formato. Il corpo è solitamente strutturato in formato JSON, il che consente alla maggior parte dei servizi di gestirlo e leggerlo facilmente.
Esempio di corpo (payload JSON):
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Personalizzazione del corpo. Puoi personalizzare il payload per includere solo i dati specifici di cui il servizio ricevente ha bisogno. Omnisend fornisce variabili (ad esempio,
[[contact.email]]) che inserisce dinamicamente i dati dal tuo flusso automatizzato nel payload. Maggiori dettagli sui dati disponibili sonoqui
⚠️ Importante! Assicurati che la struttura del corpo corrisponda a quanto previsto dall'endpoint ricevente. Ciò include il formato corretto (JSON, XML, ecc.) e i nomi dei campi.
Test del webhook
Dopo aver impostato URL, intestazioni e corpo, è essenziale testare il webhook per verificare che i dati vengano inviati correttamente. Assicurati sempre che la risposta dal sistema ricevente sia quella prevista e che non ci siano errori nella trasmissione.
Come configurare i webhook nelle automazioni di Omnisend
Passaggio 1. Crea un Flusso automatizzato
Inizia creando un nuovo flusso automatizzato o modificandone uno esistente all'interno di Omnisend.
Passaggio 2. Aggiungi un'azione webhook
Nel tuo flusso automatizzato, trascina e rilascia un blocco 'Webhook' nel punto in cui desideri che l'evento esterno si attivi.
Passaggio 3. Configura l'URL e le intestazioni del webhook
Inserisci l'URL del webhook del sistema esterno, che riceverà i dati. Questo potrebbe essere un CRM, uno strumento di comunicazione o un servizio API come l'API di WhatsApp Business. Le intestazioni sono coppie chiave-valore che contengono metadati sulla richiesta webhook o fungono da autenticazione per il sistema ricevente.
Passaggio 4. Mappa il payload
Personalizza il payload di dati che desideri inviare con il webhook. Omnisend ti consente di passare i dettagli del Cliente, le informazioni sull'Ordine o altri dati pertinenti.
Passaggio 5. Testa il webhook
Dopo averlo configurato, testa il webhook per assicurarti che il sistema esterno invii e riceva i dati correttamente.
Verifica:
Il sistema esterno riceve i dati.
Il codice di risposta è
200 OK.Nessun errore compare in Omnisend o nei log esterni.
Whitelist degli IP statici del webhook
Per migliorare la sicurezza delle tue integrazioni webhook, Omnisend utilizza un set dedicato di indirizzi IP statici per tutte le richieste webhook in uscita. Puoi inserire questi IP nella whitelist del tuo firewall, gateway API o configurazione dell'endpoint per assicurarti che vengano accettate solo le richieste da Omnisend.
Perché inserire nella whitelist gli IP dei webhook?
L'inserimento nella whitelist degli IP statici di Omnisend fornisce un ulteriore livello di sicurezza tramite:
Prevenzione di richieste non autorizzate – Solo il traffico dagli IP di Omnisend può raggiungere il tuo endpoint webhook.
Riduzione dei rischi di spoofing – Blocca gli attori malevoli che tentano di imitare le chiamate webhook di Omnisend.
Soddisfacimento dei requisiti di conformità – Supporta le politiche di sicurezza aziendali che richiedono il controllo degli accessi basato su IP.
Omnisend Webhook Static IP Lista
Aggiungi i seguenti IP alla tua configurazione di whitelist:
34.170.162.11
34.56.62.59
34.56.108.215
34.133.59.36
34.58.66.146
35.184.130.5
35.232.14.89
Importante ⚠️ Questi IP sono utilizzati esclusivamente da Omnisend per le richieste webhook inviate dai Flussi automatizzati. Assicurati che il tuo firewall o la configurazione API consentano il traffico in entrata da questi indirizzi.
Nota: Se non sei sicuro di come configurare la whitelisting IP, consulta il tuo team di sviluppo o l'amministratore di sistema.
Invio di un messaggio tramite Slack utilizzando i webhook
Slack può essere integrato con Omnisend per inviare notifiche a canali specifici quando si verifica un evento di flusso automatizzato.
Passaggio 1. Crea un webhook in entrata in Slack.
Vai a Slack API e configura un webhook in entrata.
Scegli un canale in cui verranno inviati i messaggi.
Copia l'URL del webhook fornito da Slack.
Passaggio 2. Aggiungi il Webhook al Flusso automatizzato di Omnisend.
Nel tuo Flusso Omnisend, inserisci il blocco webhook nel punto desiderato nel tuo flusso automatizzato.
Inserisci l'URL del webhook di Slack.
Personalizza il Payload. Definisci il formato del messaggio che desideri inviare. Per Slack, il payload potrebbe apparire così:
{ "text": "A new subscriber has joined! 🎉", "attachments": [ { "title": "Subscriber Details", "text": "Name: [[contact.first_name]] \n Email: [[contact.email]]" } ] }Verifica l'Integrazione. Abilita il Flusso automatizzato e controlla il canale Slack per confermare che il messaggio sia stato inviato correttamente.
Invio di contatti a Postscript da Omnisend tramite i Webhook di flusso automatizzato
Passaggio 1. Ottenere la tua Chiave API di Postscript
Vai al tuo Account Postscript.
Clicca sul tuo nome nell'angolo in alto a destra e scegli API.
Se non hai ancora creato una coppia di Chiavi API, clicca su Crea coppia di chiavi di sicurezza per generarne una.
Copia la Private Key e salvala in un luogo sicuro, poiché ti servirà in seguito.
Passaggio 2. Creazione di una parola chiave in Postscript
In Postscript, clicca su Keywords sul lato sinistro.
Clicca su Crea parola chiave nell'angolo in alto a destra.
Dai un nome alla tua parola chiave e decidi se includere un coupon nella risposta.
Per modificare la risposta:
Fai clic sulla casella viola Rispondi o crea una risposta automatica facendo clic su Aggiungi azione, quindi personalizza il messaggio di risposta.
Questa risposta tramite parola chiave verrà inviata immediatamente quando un utente si iscrive tramite la tua parola chiave.
Passaggio 3. Ottenere l'ID parola chiave
Visita la documentazione API di Postscript: Postscript Get Keywords.
Inserisci la tua Private Key nell'intestazione e clicca su Try it per trovare il Keyword ID che desideri utilizzare per i contatti provenienti da Omnisend.
Passaggio 4. Configurazione del Flusso automatizzato in Omnisend
Trigger del Flusso automatizzato. Utilizza il trigger "Contact Enters Segment" per inviare i contatti a Postscript.
Blocco Webhook.
Aggiungi un blocco Webhook al tuo flusso automatizzato.
Per URL, usa:
https://api.postscript.io/api/v2/subscribers.Per le Intestazioni, aggiungi:
Authorization: Beareraccept: application/json
Corpo. Passare le seguenti informazioni nel corpo della richiesta:
{ "origin": "other", "properties": { "VIP": true }, "phone_number": "[[contact.phone_number]]", "email": "[[contact.email]]", "keyword_id": "<keywordID obtained previously>", "tags": [ "source:omnisend" ] }Sostituisci con il tuo ID parola chiave effettivo.
Puoi usare
"origin": "website","social", oppure"other".
Passaggio 5. Abilitazione del Flusso automatizzato
Abilita il flusso automatizzato e testalo aggiungendo un contatto di prova con un numero di telefono al tuo segmento.
Verifica se i contatti nel flusso vengono passati con successo a Postscript.
Seguendo questi passaggi, potrai inviare contatti da Omnisend a Postscript tramite i webhook di flusso automatizzato.
Invio di messaggi WhatsApp tramite Webhook
L'integrazione WhatsApp richiede l'utilizzo dell'API di WhatsApp Business o di un servizio di terze parti. Di seguito sono riportati i passaggi per integrare la messaggistica WhatsApp tramite webhook.
Passaggio 1. Configura l'API di WhatsApp Business.
Registrati per l'API di WhatsApp Business tramite Facebook.
Segui il processo di configurazione, che include l'hosting dell'API sul tuo server o l'utilizzo di un servizio di terze parti.
Ottieni le credenziali API richieste.
Passaggio 2. Configura i Webhook in Omnisend.
Aggiungi un blocco webhook nel tuo flusso automatizzato Omnisend.
Inserisci l'URL dell'endpoint dell'API di WhatsApp Business come webhook.
Costruisci la richiesta HTTP.Per inviare messaggi tramite WhatsApp, costruisci una richiesta HTTP POST con il payload necessario. Esempio con cURL:
curl -X POST https://graph.facebook.com/v14.0/YOUR_PHONE_NUMBER_ID/messages \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "messaging_product": "whatsapp", "to": "RECIPIENT_PHONE_NUMBER", "type": "text", "text": { "body": "Hello, this is a test message from the WhatsApp Business API." } }'Passaggio 3. Testa l'Integrazione. Esegui il tuo flusso automatizzato per assicurarti che il messaggio WhatsApp venga inviato correttamente.
Invio di Dati a un Endpoint API Personalizzato
In alcuni casi, potresti voler inviare i dati degli eventi a un endpoint API personalizzato, come il tuo sistema CRM o la piattaforma di gestione degli ordini.
Passaggio 1. Crea un Endpoint API Personalizzato. Collabora con il tuo team di sviluppo per creare un endpoint API in grado di ricevere i dati dei webhook di Omnisend.
Passaggio 2. Aggiungi il Webhook in Omnisend. Inserisci il blocco webhook nel flusso automatizzato desiderato e inserisci l'URL dell'endpoint API personalizzato.
Personalizza il Payload. Il payload può includere qualsiasi dato disponibile dal flusso automatizzato, come i dettagli del Cliente, le informazioni sull'Ordine o i dati della Campagna. Esempio:
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Passaggio 3. Testa e Attiva. Testa il webhook per assicurarti che i dati vengano inviati correttamente al tuo endpoint API personalizzato.
Utilizzo di Webhooks per le Notifiche di Azione
Queste istruzioni ti aiuteranno a configurare i webhook per ricevere notifiche per diverse azioni, come quando un cliente acquista un prodotto specifico, richiede un rimborso o clicca su un link particolare in un'email. I Webhook possono permetterti di creare eventi personalizzati basati sulle azioni intraprese dai tuoi contatti. Ecco come funziona di solito:
Contatto compie un'azione: Un contatto attiva un evento, ad esempio, cliccando su un link in un'email.
Ingresso nel Flusso automatizzato: Il contatto entra in un flusso automatizzato. Questo può iniziare quando entra in un segmento specifico.
Webhook invia evento personalizzato: Un webhook invia un evento personalizzato relativo all'azione eseguita dal primo contatto a un indirizzo email interno specificato.
Secondo Flusso Automatizzato Attivato: Il contatto specificato entra in un secondo flusso automatizzato, nel quale ricevi notifiche sull'azione intrapresa dal primo contatto.
Esempio
Nel nostro esempio, ci invieremo una notifica email ogni volta che qualcuno cliccherà su un link specifico all'interno di un'email.
Passaggio 1. Configurazione del primo Flusso automatizzato
Definisci l'azione:
Configura il tuo trigger per l'automazione. Questo può includere qualsiasi azione, come l'ingresso in un segmento o il clic su un pulsante promozionale.
Per il nostro esempio, vogliamo sapere quando qualcuno clicca un pulsante specifico in un'attività di marketing.
Aggiungi un Blocco Webhook:
Nel tuo flusso automatizzato, aggiungi un blocco Webhook per inviare un evento personalizzato al contatto specificato.
Configurazione Webhook
Intestazioni:
Chiave:
x-api-keyValore: (sostituisci con la tua Chiave API effettiva)
Corpo:
{
"eventName": "Click notification",
"origin": "api",
"contact": {
"email": "[email protected]"
},
"properties": {
"clicker_email":"[[contact.email]]",
"clicker_fname":"[[contact.first_name]]",
"clicker_lname":"[[contact.last_name]]"
}}Nota Importante sulla Configurazione del Corpo:
eventName: Puoi dare a questo evento il nome che preferisci. Verrà utilizzato per attivare la seconda automazione.
origine: Deve essere impostato su
"api".Contatto →Email: Questo specifica il contatto che riceverà l'evento personalizzato e la notifica sull'azione eseguita dal primo contatto.
properties: Questa è una lista opzionale di dettagli che può includere sul primo contatto. In questo caso, stiamo raccogliendo il loro indirizzo email, nome e cognome.
Passaggio 2. Configurazione del secondo Flusso automatizzato
Seleziona il Trigger:
Scegli il
eventNamedal passaggio precedente come trigger dell'automazione.
Aggiungi Dettagli Notifica:
In questo flusso automatizzato, puoi impostare una notifica Email o SMS utilizzando i dettagli raccolti dal primo flusso automatizzato, come l'Email e il nome del contatto.
Questa configurazione webhook ti consente di notificare un singolo Contatto riguardo ad azioni specifiche intraprese da qualsiasi altro Contatto all'interno di Omnisend. Se ha ulteriori domande o necessita assistenza, non esiti a contattare il nostro team di supporto.
I Webhook offrono flessibilità per estendere le tue automazioni Omnisend, consentendo la comunicazione con piattaforme esterne in tempo reale. Sia che tu stia inviando messaggi tramite Slack, WhatsApp o piattaforme SMS come Postscript, il processo è simile: impostare un URL webhook, definire un payload e testare l'integrazione. Tuttavia, tieni presente che l'integrazione dei webhook spesso richiede risorse di sviluppo, specialmente per le configurazioni API personalizzate.
Tieni presente 💡 L'integrazione dei webhook spesso richiede risorse di sviluppo, specialmente per le configurazioni API personalizzate, quindi assicurati di avere il supporto necessario.
Domande frequenti
Quando dovrei usare i webhook rispetto alle integrazioni native?
Usa i webhook per piattaforme senza un'integrazione diretta con Omnisend o quando hai bisogno di una mappatura dati personalizzata.
Posso testare i webhook prima di abilitare il flusso automatizzato?
Sì – Testa il Webhooko strumenti come Postman per inviare richieste di test.
Ci sono limiti di frequenza?
I limiti dipendono dal servizio esterno – consulta la loro documentazione API.
Posso mettere in whitelist gli indirizzi IP degli webhook di Omnisend per sicurezza?
Sì. Omnisend utilizza un set dedicato di indirizzi IP statici per tutte le richieste webhook inviate dai flussi automatizzati. L'inserimento nella whitelist di questi IP aggiunge un ulteriore livello di sicurezza garantendo che solo Omnisend possa raggiungere il tuo endpoint. Vedi la lista completa degli IP
Quali dati posso utilizzare nei payload dei webhook?
Puoi utilizzare qualsiasi attributo del contatto o dati da un evento che attiva il flusso automatizzato. Per maggiori informazioni, consulta qui
Quale Piano mi serve per utilizzare i webhook nelle Automazioni?
I webhook sono disponibili su tutti i piani a pagamento. Se utilizzi il Piano gratuito e desideri utilizzare i Webhook, devi effettuare l'upgrade prima. Vai a Impostazioni Negozio → Fatturazione per gestire il tuo piano.
Se hai bisogno di assistenza per la configurazione dei tuoi webhook, non esitare a contattare il nostro pluripremiato team di Supporto Clienti. Ci puoi trovare tramite la chat in-app o all'indirizzo [email protected].