Superchat si collega a n8n tramite webhook, permettendoti di attivare flussi di lavoro automaticamente in base a eventi in Superchat — come la creazione di un nuovo contact o l'apertura di una conversazione. Questo articolo illustra i passaggi di configurazione, un esempio pratico e alcuni suggerimenti comuni per la risoluzione dei problemi.
Prima di iniziare
Assicurati di avere quanto segue prima di iniziare:
Un account Superchat attivo
Un'istanza n8n funzionante (cloud o self-hosted)
Una conoscenza di base della creazione di flussi di lavoro e dell'aggiunta di nodi in n8n
Collega Superchat a n8n
In n8n, crea un nuovo flusso di lavoro e aggiungi un nodo Webhook come trigger
Imposta il metodo HTTP su POST e copia l'URL del Webhook di test
In Superchat, vai su Impostazioni → Integrazioni → Webhook e crea un nuovo webhook
Incolla l'URL del webhook di n8n nel campo URL e seleziona l'evento (o gli eventi) che desideri utilizzare per attivare il flusso di lavoro
Torna in n8n e clicca su Ascolta l'evento di test
Attiva l'evento selezionato in Superchat (ad esempio, crea un nuovo contact) per inviare un payload di test a n8n
Una volta che n8n riceve il payload, vedrai i dati in arrivo nell'editor — la connessione funziona
URL di test vs URL di produzione
n8n genera due URL separati per ogni nodo Webhook: un URL di test e un URL di produzione.
L'URL di test riceve dati solo mentre hai cliccato su Ascolta l'evento di test nell'editor di n8n. È utilizzato solo per la creazione e il debug e scade dopo 120 secondi.
L'URL di produzione è quello che dovresti incollare in Superchat una volta che il tuo flusso di lavoro è pronto. Diventa attivo solo dopo aver salvato e attivato il flusso di lavoro utilizzando l'interruttore in alto a destra nella canvas di n8n. Se il tuo flusso di lavoro non è attivato, gli eventi da Superchat non attiveranno nulla.
Quali dati invia Superchat?
Quando viene attivato un evento webhook, Superchat invia un payload JSON a n8n contenente i dettagli dell'evento. Per un riferimento completo dei campi inclusi per ogni tipo di evento, consulta il Modello degli Oggetti Webhook di Superchat nella documentazione per sviluppatori.
Per ispezionare un payload in tempo reale durante lo sviluppo, utilizza l'URL di test, attiva un evento in Superchat e visualizza l'output grezzo direttamente nell'editor di n8n.
Esempio pratico: aggiungi un nuovo contatto di Superchat a Google Sheets
Questo esempio crea una nuova riga in un foglio Google ogni volta che viene creato un contact in Superchat.
Configura il nodo Webhook come descritto sopra e invia un evento di test da Superchat in modo che n8n abbia dati di esempio con cui lavorare
Aggiungi un nodo Google Sheets e collegalo al nodo Webhook
Imposta l'operazione su Aggiungi riga
Seleziona il foglio di lavoro e il foglio di destinazione
Mappa i campi dal payload di Superchat alle colonne pertinenti — consulta il Modello degli Oggetti Webhook per i nomi esatti dei campi
Clicca su Testa passaggio per verificare che una riga venga creata correttamente
Una volta confermato, passa il nodo Webhook all'URL di produzione, salva il flusso di lavoro e attivalo
Il tuo flusso di lavoro verrà ora eseguito automaticamente ogni volta che viene creato un nuovo contact in Superchat.
Risoluzione dei problemi
Il flusso di lavoro non si attiva
Verifica che il tuo flusso di lavoro sia attivato e che l'URL di produzione — non l'URL di test — sia salvato in Superchat.
I dati arrivano ma i campi sono vuoti
Apri il pannello Esecuzioni in n8n (barra laterale sinistra) per ispezionare il payload grezzo ricevuto. Questo mostra esattamente cosa ha inviato Superchat e aiuta a identificare eventuali problemi di mappatura.
L'evento di test non viene ricevuto
Assicurati di aver cliccato su Ascolta l'evento di test in n8n prima di attivare l'evento in Superchat. L'URL di test scade dopo 120 secondi — se è scaduto, cliccalo di nuovo prima di riprovare.