Vai al contenuto
RisveglIA
Tutti gli articoli

Funzioni8 min di lettura

Nodo n8n per WhatsApp: guida al nodo RisveglIA, con tre flussi di esempio

Guida pratica al nodo RisveglIA per n8n self-hosted: installazione, credenziale con il token personale, i due nodi, tre flussi di esempio da copiare e gli errori più comuni.

Hai n8n installato sul tuo server e lo usi per collegare CRM, fogli di calcolo ed email. Le chat WhatsApp sono l'unico pezzo che resta fuori: una richiesta arrivata in chat finisce nel CRM solo se qualcuno la ricopia.

Il nodo RisveglIA porta in n8n l'archivio delle tue chat: il flusso parte quando arriva un messaggio, legge la conversazione, aggiorna etichette e trattative e, se glielo permetti, risponde dal tuo numero. In questa guida lo installiamo e costruiamo tre flussi di esempio.

Cerchi l'elenco completo di operazioni ed eventi? È nella documentazione del nodo n8n, sempre allineata all'ultima versione.

Cosa serve

  • n8n self-hosted. Su n8n Cloud i nodi della community si installano solo dopo la verifica di n8n, che per questo nodo non c'è ancora.
  • Un indirizzo https raggiungibile da internet, se vuoi usare il trigger: RisveglIA deve poter consegnare gli eventi al tuo n8n.
  • Un account RisveglIA con il numero collegato.
  • Un token personale, che crei tra un attimo.

Non serve una chiave AI in RisveglIA. Se nel flusso usi un modello AI, è quello che configuri in n8n.

1. Installa il nodo

  1. In n8n apri Impostazioni › Community nodes e premi Install.
  2. Scrivi @ivanlaomarketing/n8n-nodes-risveglia e conferma.
  3. Attendi la fine dell'installazione: nell'elenco dei nodi compaiono RisveglIA e RisveglIA Trigger.

Il pacchetto è pubblico su npm e il codice su GitHub.

Come aggiornare il nodo

Su n8n il nodo non si aggiorna da solo. Quando esce una versione nuova RisveglIA te lo dice in Impostazioni › «Integrazioni» e per email, con cosa cambia e cosa fare. Per aggiornarlo apri Impostazioni › Community nodes, premi Update accanto al pacchetto e ricarica l'editor: i flussi salvati continuano a funzionare. Le note di ogni versione sono nella sezione Aggiornamenti.

2. Crea il token e la credenziale

  1. Nel portale di RisveglIA apri Impostazioni › «Integrazioni» e premi Crea un token personale.
  2. Dagli un nome che riconosci, per esempio «n8n ufficio».
  3. Scegli cosa può leggere e, in «Cosa può fare da n8n e Make», i permessi di scrittura che servono al flusso.
  4. Scegli la scadenza e copia il token: inizia con rsv_pat_ e si vede una sola volta.
  5. In n8n crea una credenziale RisveglIA API e incolla il token. L'indirizzo proposto va lasciato com'è.
  6. Premi la prova della credenziale: ti dice subito se il token funziona.

Per i tre flussi di questa guida bastano i permessi di lettura, Contatti e trattative e Attivatori. Invio messaggi aggiungilo solo se il flusso deve scrivere ai contatti.

3. I due nodi

RisveglIA Trigger fa partire il flusso quando succede qualcosa. Scegli quali dei 17 tipi di evento ricevere (messaggio ricevuto, messaggio inviato, chiamata ricevuta, etichetta cambiata, ingresso in un gruppo e gli altri) e, se hai più numeri, un solo numero. Quando attivi il flusso il nodo crea da solo l'iscrizione in RisveglIA; quando lo spegni la toglie. Controlla la firma di ogni evento: una chiamata senza firma valida viene rifiutata.

RisveglIA è il nodo delle azioni. Scegli la risorsa, poi l'operazione, e compili i suoi dati in formato JSON: per le operazioni più usate il nodo propone già un esempio da completare.

  • Messaggi: inviare una risposta, una reazione, una modifica o un'eliminazione, vedere gli invii recenti, annullare un invio in attesa;
  • Contatti e trattative: etichette, promemoria, card delle pipeline, consensi ed esclusioni;
  • Telefonate: rifiutare una chiamata che sta squillando;
  • Gruppi e canali: creare e gestire gruppi e canali, inviti in coda, pubblicazioni;
  • Agente AI, Media, Campagne e automazioni, Attivatori, Account;
  • Letture dall'archivio: cercare nei messaggi, elencare chat e contatti, leggere i messaggi di una chat, promemoria, opportunità e chiamate.

In tutto sono 67 operazioni. Nella lista compaiono solo quelle che il token può usare. Il nodo si usa anche come strumento dell'agente AI di n8n.

Flusso 1: richiesta di preventivo nel CRM

Obiettivo: quando un contatto scrive la parola «preventivo», la chat riceve un'etichetta e nasce un promemoria.

  1. RisveglIA Trigger, evento «Messaggio ricevuto».
  2. If: il testo del messaggio contiene «preventivo».
  3. RisveglIA › Contatti e trattative › «Imposta le etichette di una chat», con l'identificativo della chat che arriva dall'evento e quello dell'etichetta «Preventivo», che leggi una volta con «Elenca le etichette».
  4. RisveglIA › Contatti e trattative › «Crea un promemoria» per il giorno dopo, con la «Chiave di idempotenza» impostata sull'identificativo dell'evento.
  5. Il nodo del tuo CRM, per creare o aggiornare la scheda.

La chiave di idempotenza serve perché RisveglIA, se n8n non risponde, riconsegna lo stesso evento: con la stessa chiave il promemoria nasce una volta sola.

Flusso 2: richiamare chi ha telefonato

Obiettivo: non perdere le chiamate WhatsApp ricevute fuori orario.

  1. RisveglIA Trigger, evento «Chiamata ricevuta».
  2. If sull'orario: la chiamata è arrivata fuori dall'orario di apertura.
  3. RisveglIA › Contatti e trattative › «Crea un promemoria»: «Richiamare», per la mattina dopo.
  4. Facoltativo, con il permesso Invio messaggi: RisveglIA › Messaggi › invia una risposta nella chat di chi ha chiamato, con l'orario in cui richiami.

L'operazione «Rifiuta una chiamata» funziona solo mentre la chiamata squilla: va collegata subito dopo il trigger, e dopo una ventina di secondi la richiesta viene rifiutata. Se ti basta rifiutare e rispondere con un messaggio, lo fanno già le regole sulle telefonate del portale, senza n8n.

Flusso 3: dal modulo del sito alla pipeline

Obiettivo: quando una persona che ti ha già scritto su WhatsApp compila il modulo del sito, la sua chat entra nella pipeline giusta.

  1. Webhook o il nodo del tuo modulo, come trigger.
  2. RisveglIA › Letture dall'archivio › «Elenca i contatti», con il numero di telefono come ricerca, per trovare la chat collegata.
  3. If: la chat esiste.
  4. RisveglIA › Contatti e trattative › «Mette una chat in una pipeline», con l'identificativo della fase «Nuova richiesta», che leggi con «Pipeline, fasi e card delle trattative».

Se la chat non esiste il flusso si ferma lì. Per scrivere anche a chi non ti ha mai scritto c'è l'operazione Messaggi › Invia a un numero, con il consenso raccolto dal modulo: trovi le regole nella guida al primo messaggio.

Il nodo come strumento di un agente AI

Collega il nodo RisveglIA a un AI Agent di n8n come strumento, con la risorsa «Letture dall'archivio». L'agente può cercare nelle chat per rispondere a domande come «cosa ha chiesto questo cliente il mese scorso?» dentro un tuo flusso. Dagli un token di sola lettura: quello che può fare lo decide il token, non il prompt.

Se invece vuoi chiedere a parole senza costruire un flusso, è più semplice collegare Claude o ChatGPT con il connettore MCP.

Cose da sapere prima di andare in produzione

  • Gli invii partono senza una conferma per volta, perché il flusso lo hai costruito tu. Valgono limiti di invio, fasce orarie e ruoli del portale.
  • Numeri nuovi solo con «Invia a un numero». Le altre operazioni di invio scrivono nelle chat già in archivio. Per un numero nuovo serve il permesso «Primo messaggio a contatti nuovi» e il consenso del contatto; RisveglIA scrive una volta per numero, entro un tetto giornaliero e dalle 8 alle 21.
  • Elenchi. Una risposta con un elenco arriva come un solo elemento che contiene la lista: dividila con Split Out.
  • Eventi ripetuti. Se n8n non risponde, RisveglIA riprova cinque volte in sei ore. L'identificativo dell'evento resta uguale: usalo per scartare i doppioni.
  • Iscrizione in pausa. Dopo 10 consegne fallite di fila l'iscrizione va in pausa e la riattivi dal portale.
  • Gruppi. Gli eventi dei gruppi non portano nomi o numeri dei partecipanti, e i gruppi si leggono solo se il token ha il permesso Gruppi.
  • Niente accensioni. Da un token si preparano bozze di automazioni e campagne, ma non si accendono e non si avviano.
  • Limiti. 60 chiamate al minuto per token e 120 per tutto l'account; le chiamate al mese sono quelle del piano.

Gli errori più comuni

  • 401: token non valido, scaduto o revocato. Creane uno nuovo e aggiorna la credenziale.
  • 403 ambito_mancante: al token manca il permesso che l'operazione chiede. Lo aggiungi dalla riga del token con «Aggiungi permessi»: il token resta lo stesso.
  • 404 operazione_non_ammessa: di solito il nodo non è aggiornato all'ultima versione: aggiornalo da Community nodes.
  • 409 chiave_gia_usata: la stessa chiave di idempotenza è stata usata con un contenuto diverso.
  • 429 troppe_richieste: hai superato le chiamate al minuto o del mese. Aspetta 60 secondi.
  • Il trigger non parte: controlla che n8n sia raggiungibile in https e, nel portale, il registro delle consegne in Impostazioni › «Integrazioni».

Domande frequenti

Funziona su n8n Cloud?

Non ancora. Su n8n Cloud i nodi della community arrivano solo dopo la verifica di n8n. Con n8n self-hosted funziona già.

Posso usare il nodo HTTP Request al posto del nodo RisveglIA?

Puoi, ma perdi l'elenco delle operazioni con gli esempi già impostati, l'iscrizione automatica del trigger e il controllo della firma. Il nodo esiste per non doverli rifare a mano.

Usi Make?

Le stesse operazioni sono nell'app RisveglIA per Make. La panoramica su entrambi è nella guida WhatsApp in n8n e Make.

In breve

  1. Installi @ivanlaomarketing/n8n-nodes-risveglia da Community nodes, su n8n self-hosted.
  2. Crei un token personale in RisveglIA e la credenziale RisveglIA API in n8n.
  3. RisveglIA Trigger fa partire il flusso, RisveglIA esegue letture e operazioni.
  4. Chiave di idempotenza su invii e promemoria, Split Out sugli elenchi.
  5. Limiti e permessi sono quelli del portale; il token lo revochi quando vuoi.

L'elenco completo di operazioni, letture ed eventi è nella documentazione del nodo.

Leggi anche

Vuoi che le tue chat si rileggano da sole?

Crei l'account e colleghi il numero in pochi minuti. I primi 14 giorni sono gratuiti e non serve la carta. Poi il piano Solo costa 29 € al mese o 290 € all'anno, IVA non dovuta.

Prova gratis 14 giorni
Scrivici su WhatsApp(si apre in una nuova scheda)

Usiamo cookie tecnici e, con il tuo consenso, Google Analytics 4

Gli strumenti non essenziali restano disattivati finché non scegli. Puoi cambiare idea in qualsiasi momento dal link “Preferenze cookie” nel piede di pagina. Cookie policy