L’integrazione Custom Webhook collega Custom Webhook a MessageMind, così un agente IA può leggere il contesto in tempo reale e rispondere su tutti i canali che usano i tuoi clienti. Il trigger Custom Webhook avvia una campagna ogni volta che un altro strumento che usi invia i dati di un contatto a un URL che ti fornisce MessageMind. Non lo trovi nella pagina Integrations: lo scegli come trigger quando crei una campagna nella sezione Campaigns del Workspace.

Cos’è l’integrazione Custom Webhook con l’IA?

Il trigger Custom Webhook avvia una campagna ogni volta che un altro strumento che usi invia i dati di un contatto a un URL che ti fornisce MessageMind. Non lo trovi nella pagina Integrations: lo scegli come trigger quando crei una campagna nella sezione Campaigns del Workspace. A ogni richiesta, MessageMind cerca il contatto per numero di telefono o email (oppure lo crea) e avvia la campagna per quella persona. Un obiettivo Custom Webhook ha un suo URL e sposta chi è già nella campagna al passaggio che segue l’obiettivo.

Trovi tutte le integrazioni supportate nella pagina delle integrazioni di MessageMind, e i dettagli tecnici di questa nella documentazione di MessageMind su Custom Webhook. Se preferisci vederla prima in azione, prenota una demo e ti mostriamo dal vivo come funziona.

Cosa fa l’integrazione Custom Webhook

L’integrazione Custom Webhook con l’IA include già queste funzionalità:

  • Avvia una campagna da qualsiasi strumento capace di inviare una richiesta a un URL con un header a tua scelta, per esempio Zapier, Make o il tuo codice.
  • Cerca il contatto per numero di telefono o email, oppure crea un nuovo contatto se non trova corrispondenze.
  • Compila il campo azienda del contatto con companyName, se la sua scheda non ce l’ha ancora.
  • Salva i valori extra che invii come campi personalizzati del contatto. Li puoi usare come variabili, per esempio {{order_id}}, nei messaggi e nelle condizioni.
  • Sposta chi è già nella campagna direttamente al passaggio dopo un obiettivo Custom Webhook, quando il tuo strumento chiama l’URL di quell’obiettivo.
  • Riusa nei passaggi successivi i valori arrivati con la richiesta all’obiettivo, come un numero d’ordine.

Dati letti e scritti

L’integrazione Custom Webhook con l’IA usa solo un insieme limitato di campi. Ecco cosa passa esattamente tra i due sistemi:

DirezioneCosa comprende
Letturaname, phone, email e companyName di ogni richiesta inviata all’URL del trigger.
LetturaI valori dei campi personalizzati che il tuo strumento invia dentro customFields.
LetturaPer l’URL di un obiettivo, il telefono o l’email che identifica il contatto, più i campi che elenchi in «Variables from this webhook». Tutto il resto di una richiesta all’obiettivo viene ignorato.

Come configurare l’integrazione Custom Webhook con l’IA

La configurazione richiede pochi minuti, se il tuo account è già attivo. I passaggi:

  • Clicca Workspace nella barra in alto, poi Campaigns nella colonna a sinistra.
  • Clicca «Create campaign», scrivi un nome in «Campaign name», lascia selezionato «Create an Automation» e clicca Create. La nuova campagna si apre nell’editor.
  • Clicca «Add a Trigger». Nella finestra «Choose a trigger», clicca «Custom Webhook» sotto Webhook. Si apre la finestra «Configure trigger».
  • Clicca Copy accanto a «Webhook URL» e incolla l’URL nell’altro strumento come indirizzo a cui inviare i dati.
  • Imposta lo strumento perché invii una richiesta POST con content type application/json.
  • Torna in MessageMind e clicca Copy accanto a «Secret token».

Tutti i passaggi, con ogni pulsante e ogni campo, sono nella documentazione di MessageMind su Custom Webhook.

Limiti da conoscere

L’integrazione Custom Webhook ha, di proposito, un perimetro limitato. Ecco cosa devi sapere prima di farci affidamento:

  • L’URL accetta richieste solo quando la campagna è Published, quindi non puoi provarlo dal tuo strumento su una campagna in Draft. Per il primo test usa i tuoi dati di contatto.
  • Una richiesta viene rifiutata se non ha un nome, o se non ha né un numero di telefono né un indirizzo email. Alle richieste all’obiettivo basta il telefono o l’email.
  • I numeri di telefono devono essere validi. Inviali con il + e il prefisso internazionale, come nell’esempio. Un numero senza prefisso viene letto come un numero del paese del tuo account.
  • I dati vanno in una sola direzione. Il tuo strumento riceve una breve risposta che dice se la richiesta è stata accettata, e MessageMind non gli rimanda nient’altro.
  • L’URL di un obiettivo funziona solo nelle campagne che iniziano con il trigger Custom Webhook.

Prezzi e piani disponibili

L’integrazione Custom Webhook con l’IA è disponibile nei piani a pagamento di MessageMind. La pagina dei prezzi di MessageMind indica quale piano serve e cosa include ciascuno. Non paghi nulla in più per l’integrazione: il collegamento fa parte del tuo account.

Domande frequenti

Cos’è l’integrazione Custom Webhook con l’IA?

È il collegamento nativo tra Custom Webhook e MessageMind. Dopo il collegamento, l’agente IA può leggere il contesto di Custom Webhook in tempo reale durante una conversazione e usarlo (per esempio per rispondere a una domanda sulla disponibilità, prenotare un appuntamento o aggiornare un contatto) su WhatsApp, Instagram, SMS, email e chat sul sito.

Come collego Custom Webhook a MessageMind?

Apri la pagina dell’integrazione Custom Webhook nella dashboard di MessageMind e segui la procedura di collegamento. La guida completa passo passo, con il nome di ogni campo e gli screenshot, è nella documentazione di MessageMind su Custom Webhook.

Come funziona l’autenticazione dell’integrazione Custom Webhook?

A ogni richiesta, il tuo strumento invia il «Secret token» della campagna in un header chiamato X-Webhook-Token. Non serve alcun login e non c’è alcun collegamento tra l’account MessageMind e l’altro strumento. Le credenziali sono salvate cifrate e usate solo sul server, quindi non arrivano mai al browser né a terze parti.

MessageMind può davvero avviare una campagna da qualsiasi strumento capace di inviare una richiesta a un URL con un header a tua scelta?

Puoi avviare una campagna da qualsiasi strumento capace di inviare una richiesta a un URL con un header a tua scelta, per esempio Zapier, Make o il tuo codice.

Cosa fare se il tuo strumento riceve la risposta «Invalid webhook token.»?

Controlla che la campagna sia Published e salvata, che l’header si chiami X-Webhook-Token e che il suo valore sia il «Secret token» attuale. Dopo aver cliccato Regenerate, funziona solo il nuovo token. Per un URL obiettivo, la campagna deve anche iniziare con il trigger Custom Webhook.