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 pagine 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 comunicazioni sicure, assicurati che l'URL inizi conhttps:// 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.
4a1 0Consiglio: 0Valida sempre che le intestazioni necessarie siano impostate 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.Trova maggiori dettagli sui dati disponibili
⚠️ Importante: Assicurati che la struttura del corpo corrisponda a ciò che l'endpoint ricevente si aspetta. Questo include il formato corretto (JSON, XML, ecc.) e i nomi dei campi.
Testare il 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 come previsto e che non ci siano errori nella trasmissione.
Come impostare i Webhook nelle automazioni di Omnisend
Passo 1. Crea un Flusso automatizzato
Inizia creando un nuovo flusso automatizzato o modificando uno esistente all'interno di Omnisend.
Passo 2. Aggiungi un'azione Webhook
Nel tuo flusso automatizzato, trascina e rilascia un blocco 'Webhook' nel punto in cui desideri che l'evento esterno attivi il trigger.
Passo 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 del webhook o servono come autenticazione per il sistema ricevente.
Passo 4. Mappa il Payload
Personalizza il payload di dati che desideri inviare con il webhook. Omnisend ti consente di trasmettere i dettagli del cliente, le informazioni sull'ordine o altri dati pertinenti.
Passo 5. Testa il Webhook
Dopo averlo impostato, testa il webhook per assicurarti che il sistema esterno stia inviando e ricevendo 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 aggiungere queste IP alla whitelist nel tuo firewall, API gateway o configurazione dell'endpoint per garantire che vengano accettate solo le richieste da Omnisend.
Perché aggiungere gli IP dei Webhook alla whitelist?
L'inserimento nella whitelist degli IP statici di Omnisend fornisce un ulteriore livello di sicurezza:
Prevenendo richieste non autorizzate – Solo il traffico dagli IP di Omnisend può raggiungere il tuo endpoint webhook.
Riducendo i rischi di spoofing – Blocca attori malevoli che tentano di imitare le chiamate webhook di Omnisend.
Rispettando i requisiti di conformità – Supporta le politiche di sicurezza aziendale che richiedono il controllo degli accessi basato su IP.
Lista degli IP statici del Webhook di Omnisend
Aggiungi i seguenti IP alla tua configurazione della 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
6a8 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 whitelist degli IP, consulta il tuo team di sviluppo o l'amministratore di sistema.
Inviare 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.
Passo 1. Crea un Webhook in entrata in Slack.
Vai a Slack API e imposta un webhook in ingresso.
Scegli un canale dove verranno inviati i messaggi.
Copia l'URL del webhook fornito da Slack.
Passo 2. Aggiungi il Webhook al Flusso automatizzato di Omnisend.
Nel tuo flusso Omnisend, inserisci il blocco webhook nel punto desiderato della tua automazione.
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]]" } ] }Testa l'Integrazione. Abilita il flusso automatizzato e controlla il canale Slack per confermare che il messaggio sia stato inviato con successo.
Inviare contatti a Postscript da Omnisend tramite Webhook di flussi automatizzati.
Passo 1. Ottenere la tua Chiave API Postscript
Naviga 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, fai clic su Crea coppia di chiavi di sicurezza per generarne una.
Copia la Chiave Privata e salvala in un luogo sicuro, poiché ne avrai bisogno in seguito.
Passo 2. Creare una Parola Chiave in Postscript
In Postscript, fai clic su Parole Chiave sul lato sinistro.
Fai clic su Crea Parola Chiave nell'angolo in alto a destra.
Assegna un nome alla tua parola chiave e decidi se includere un coupon nella risposta.
Per modificare la risposta:
Fai clic sulla casella Risposta viola o crea una risposta automatica facendo clic su Aggiungi Azione, quindi personalizza il messaggio di risposta.
Questa Risposta alla Parola Chiave verrà inviata immediatamente quando un utente si iscrive tramite la tua parola chiave.
Passo 3. Ottenere l'ID della Parola Chiave
Visita la documentazione API di Postscript: Postscript Get Keywords.
Inserisci la tua Chiave Privata nell'intestazione e fai clic su Prova per trovare il ID Parola Chiave che desideri utilizzare per i contatti provenienti da Omnisend.
Passo 4. Impostare il Flusso automatizzato in Omnisend.
Trigger del Flusso automatizzato. Utilizza il trigger "Contact Enters Segment" per inviare i contatti a Postscript.
Webhook Block.
Aggiungi un blocco Webhook al tuo flusso automatizzato.
Per URL, usa:
https://api.postscript.io/api/v2/subscribers.Per Intestazioni, aggiungi:
Authorization: Beareraccept: application/json
Corpo. Passa 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 effettivo ID della parola chiave.
Puoi usare
"origin": "website","social", o"other".
Passo 5. Abilitare il Flusso automatizzato.
Abilita il flusso automatizzato e testalo aggiungendo un contatto di prova con un numero di telefono al tuo segmento.
Controlla se i contatti nel flusso vengono trasferiti correttamente a Postscript.
Seguendo questi passaggi, sarai in grado di inviare contatti da Omnisend a Postscript tramite webhook di flussi automatizzati.
Invio di messaggi WhatsApp utilizzando i 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 utilizzando i webhook.
Passo 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.
Passo 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." } }'Passo 3. Testa l'Integrazione. Esegui il tuo flusso automatizzato per assicurarti che il messaggio WhatsApp venga inviato con successo.
Invio dati a un endpoint API personalizzato
In alcuni casi, potresti voler inviare dati sugli eventi a un endpoint API personalizzato, come il tuo sistema CRM o la tua piattaforma di gestione degli ordini.
Passo 1. Crea un Endpoint API Personalizzato. Collabora con il tuo team di sviluppo per creare un endpoint API che possa ricevere i dati del webhook di Omnisend.
Passo 2. Aggiungi il Webhook in Omnisend. Inserisci il blocco webhook nell'automazione desiderata e inserisci l'URL dell'endpoint API personalizzato.
Personalizza il Payload.Il payload può includere qualsiasi dato disponibile dal flusso automatizzato, come dettagli del cliente, informazioni sull'ordine o dati della campagna. Esempio:
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Passo 3. Testa e Attiva. Testa il webhook per garantire che i dati vengano inviati correttamente al tuo endpoint API personalizzato.
Utilizzare i Webhook 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 tipicamente:
Contatto Esegue un'Azione: Un contatto attiva un evento cliccando, ad esempio, un link in un'Email.
Entrare 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 riguardante l'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 riguardo all'azione intrapresa dal primo contatto.
Esempio
Nel nostro esempio, ci invieremo una notifica via email ogni volta che qualcuno clicca su un link specifico all'interno di un'email.
Passaggio 1. Impostare il Primo Flusso automatizzato.
Definisci l'Azione:
Configura il tuo trigger per l'automazione. Questo può includere qualsiasi azione, come entrare in un segmento o fare clic su un pulsante promozionale.
Per il nostro esempio, vogliamo sapere quando qualcuno clicca su 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 del Webhook
Intestazioni:
Chiave:
x-api-keyValore: (sostituisci con la tua reale chiave API)
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 nominare questo evento come preferisci. Sarà utilizzato per attivare il secondo flusso automatizzato.
origine: Deve essere impostato su
"api".contatto email: Questo specifica il contatto che riceverà l'evento personalizzato e la notifica riguardo l'azione eseguita dal primo contatto.
proprietà: Questa è un elenco facoltativo di dettagli che puoi includere sul primo contatto. In questo caso, stiamo raccogliendo il loro indirizzo Email, nome e cognome.
Passo 2. Impostare il Secondo Flusso automatizzato.
Seleziona il Trigger:
Scegli il
eventNamedal passaggio precedente come trigger del flusso automatizzato.
Aggiungi Dettagli sulla Notifica:
In questo flusso automatizzato, puoi impostare una notifica via 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 richiede spesso risorse di sviluppo, specialmente per configurazioni API personalizzate.
4a1 Tieni a Mente: L'integrazione dei webhook richiede spesso risorse di sviluppo, specialmente per configurazioni API personalizzate, quindi assicurati di avere il supporto necessario.
Domande frequenti
Quando dovrei usare i webhook rispetto alle integrazioni native?
Utilizza i webhook per le piattaforme senza un'integrazione diretta con Omnisend o quando hai bisogno di una mappatura dei dati personalizzata.
Posso testare i webhook prima di abilitare il flusso automatizzato?
Yes – o strumenti come Postman per inviare richieste di test.
Ci sono limiti di frequenza?
I limiti dipendono dal servizio esterno – controlla la loro documentazione API.
Posso inserire nella whitelist gli IP del webhook di Omnisend per motivi di sicurezza?
Yes. Omnisend uses a dedicated set of static IP addresses for all webhook requests sent from Automation workflows. Whitelisting these IPs adds an extra security layer by ensuring only Omnisend can reach your endpoint.
Quali dati posso utilizzare nei payload dei webhook?
You can use any contact attributes or data from an event that triggers the automation. For more information, see
Quale piano devo utilizzare per 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. Puoi trovarci tramite chat in-app o su [email protected].