Integrazioni
Nodo RisveglIA per n8n
Collega l'archivio delle chat WhatsApp ai tuoi flussi di n8n: leggi le chat, aggiorni contatti e trattative, invii messaggi nelle chat in archivio o a un numero nuovo, con le sue regole, e fai partire un flusso quando arriva un'attività.
Pacchetto su npm (si apre in una nuova scheda)Codice su GitHub (si apre in una nuova scheda)Tutte le operazioniGuida passo passo
Installazione
- In n8n self-hosted apri Impostazioni › Community nodes e premi Install.
- Scrivi
@ivanlaomarketing/n8n-nodes-risveglia, conferma e attendi l'installazione. - Nel portale di RisveglIA apri Impostazioni › Integrazioni, premi Crea un token personale e scegli cosa può fare: leggere l'archivio e, se ti serve, inviare messaggi, aggiornare contatti e trattative, gestire gruppi e canali, agente AI, media e attivatori. «Seleziona tutto» spunta in un colpo i permessi che puoi dare.
- In n8n crea la credenziale RisveglIA e incolla il token (inizia con
rsv_pat_): la prova della credenziale ti dice subito se funziona. L'indirizzo proposto va lasciato com'è.
Il token si vede una sola volta. Lo revochi dalla stessa scheda del portale quando vuoi. Per crearlo serve il permesso «Collegamenti personali», che ha già chi amministra lo spazio.
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. La aggiorni dalla stessa pagina Community nodes, come spiegato in Aggiornamenti.
Cosa trovi
RisveglIA
Tutte le operazioni divise per risorsa: messaggi, contatti e trattative, telefonate, gruppi e canali, agente AI, media, campagne e automazioni, attivatori, account. In più la risorsa «Letture dall'archivio»: cerca messaggi, elenca chat e contatti, leggi promemoria, opportunità e telefonate. Immagini, vocali, video e documenti arrivano come dati binari.RisveglIA Trigger
Fa partire il flusso quando arriva un'attività: messaggi ricevuti e inviati, stati, reazioni, modifiche, chiamate, etichette, numeri collegati o scollegati, ingressi e uscite dai gruppi. Si iscrive da solo quando attivi il flusso, si toglie quando lo spegni e controlla la firma di ogni evento.Strumento per l'agente AI
Lo stesso nodo si usa come strumento dell'agente AI di n8n, così l'agente può cercare nelle chat o creare un promemoria dentro i permessi del token.
Tutte le operazioni (67)
Nel nodo scegli prima la risorsa, poi l'operazione. Accanto a ognuna trovi il permesso che deve avere il token.
Messaggi15 operazioni
| Operazione | Permesso del token |
|---|---|
Invia in una chat: testo, file della libreria (foto, video, documento, vocale), sondaggio, posizione, contatto, evento, reazione, modifica o eliminazione · con chiave di idempotenzainvii.creaPer scrivere in una chat già in archivio: testo, file della libreria, sondaggio, posizione, contatto, evento, reazione, modifica o eliminazione. Il tipo si sceglie con kind. Esempio e limitiCorpo (JSON) {
"kind": "testo",
"conversationId": "00000000-0000-4000-8000-000000000001",
"text": "Ciao, ti confermo l'appuntamento di domani.",
"scheduledAt": "2026-12-01T09:00:00.000Z"
}
| Invio messaggi |
Invii recenti di una chat e il loro statoinvii.elencaPer controllare se un invio è partito o è fallito, prima che compaia nell'archivio. Esempio e limitiParametri (JSON) {
"conversationId": "00000000-0000-4000-8000-000000000001"
}
| Invio messaggi |
Annulla un invio ancora in attesainvii.annullaPer fermare un invio ancora in attesa, anche un messaggio programmato prima della sua ora. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Invio messaggi |
Segna una chat come letta fino a un messaggio (spunte blu se accese sul numero)chat.lettaPer segnare una chat come letta fino a un messaggio, per esempio dopo che un flusso ha gestito la richiesta. Esempio e limitiID 00000000-0000-4000-8000-000000000001 Corpo (JSON) {
"upTo": "00000000-0000-4000-8000-000000000002"
}
| Invio messaggi |
Tetti e fasce orarie degli inviiinvii.impostazioniPer sapere se «Rispondi da RisveglIA» è acceso e quali tetti valgono, prima di mandare messaggi. Esempio e limiti
| Invio messaggi |
Eventi mandati in una chat con le risposte (Ci sarò, Non ci sarò, Forse)eventi.elencaPer leggere gli eventi WhatsApp mandati e le risposte Ci sarò, Non ci sarò, Forse. Esempio e limitiParametri (JSON) {
"conversationId": "00000000-0000-4000-8000-000000000001",
"limit": 20
}
| Chat e messaggi |
Numeri mittenti con i canali collegati (QR, API) e modelli approvatinumero.canaliPer sapere da quale numero e su quale canale (QR o API) si può scrivere, e con quali template approvati. Esempio e limiti
| Invio messaggi |
Invia a un numero, anche nuovo (testo, file, sondaggio, posizione, contatto, pulsanti, lista, link o modello; QR o API) · con chiave di idempotenzanumero.inviaPer scrivere a un numero di telefono, anche senza una chat in archivio: testo, file, contenuto o template approvato. Esempio e limitiCorpo (JSON) {
"numberId": "00000000-0000-4000-8000-000000000003",
"phone": "+39 333 123 4567",
"channel": "automatico",
"text": "Ciao, grazie per averci contattato dal sito.",
"consent": {
"source": "Modulo contatti del sito",
"date": "2026-11-20",
"purpose": "utilita"
}
}
| Invio messaggi |
Il numero è su WhatsApp? (solo controllo, non scrive nulla)numero.verificaPer sapere se un numero ha WhatsApp prima di scrivergli, senza aprire chat né mandare nulla. Esempio e limitiParametri (JSON) {
"phone": "+39 333 123 4567",
"numberId": "00000000-0000-4000-8000-000000000003"
}
| Invio messaggi |
Stato di un invio a un numeronumero.dettaglioPer sapere com'è andato un invio a un numero: canale usato, chat creata ed eventuale errore. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Invio messaggi |
Allegati di un messaggio o di una chat (immagini, vocali, video, documenti)allegati.elencaPer trovare gli allegati di un messaggio o gli ultimi di una chat, con la trascrizione dei vocali. Esempio e limitiParametri (JSON) {
"conversationId": "00000000-0000-4000-8000-000000000001",
"kind": "document",
"limit": 20
}
| Chat e messaggi |
Dati di un allegato, con il file in base64 (contenuto=base64)allegati.dettaglioPer i dati di un allegato e, con contenuto=base64, il file dentro il JSON. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Parametri (JSON) {
"contenuto": "base64"
}
| Chat e messaggi |
Testo leggibile di un allegato (PDF, Word, Excel, PowerPoint, TXT, MD, CSV, vocali trascritti)allegati.testoPer avere il testo di un documento (PDF, Word, Excel, PowerPoint, TXT, MD, CSV, JSON) o la trascrizione di un vocale. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Chat e messaggi |
Scarica il file di un allegato · restituisce un fileallegati.filePer scaricare il file così com'è: in n8n arriva in un campo binario. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Chat e messaggi |
Trascrive un vocale con la chiave AI dell'accountvocali.trascriviPer trascrivere un vocale che non ha ancora la trascrizione. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Chat e messaggi |
Contatti e trattative14 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca le etichetteetichette.elencaPer avere gli id delle etichette di RisveglIA e di WhatsApp Business. Esempio e limiti
| Contatti |
Crea un'etichettaetichette.creaPer creare un tag di RisveglIA o, con numberId, un'etichetta WhatsApp Business sul telefono. Esempio e limitiCorpo (JSON) {
"name": "Cliente caldo",
"color": "#2E7D32"
}
| Contatti e trattative |
Imposta le etichette di una chatchat.etichettePer impostare le etichette di una chat: sostituisce quelle che ha. Esempio e limitiID 00000000-0000-4000-8000-000000000001 Corpo (JSON) {
"labelIds": [
"00000000-0000-4000-8000-000000000005"
]
}
| Contatti e trattative |
Crea un promemoria · con chiave di idempotenzapromemoria.creaPer creare un promemoria, legato o no a una chat. Esempio e limitiCorpo (JSON) {
"title": "Richiamare per il preventivo",
"chatId": "00000000-0000-4000-8000-000000000001",
"dueAt": "2026-12-02T08:30:00.000Z",
"timezone": "Europe/Rome"
}
| Contatti e trattative |
Aggiorna o chiude un promemoriapromemoria.aggiornaPer cambiare titolo, scadenza o stato (todo o done) di un promemoria. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Corpo (JSON) {
"status": "done",
"version": 1
}
| Contatti e trattative |
Elimina un promemoriapromemoria.eliminaPer eliminare un promemoria. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Parametri (JSON) {
"version": 1
}
| Contatti e trattative |
Pipeline, fasi e card delle trattativetrattative.boardPer leggere pipeline, colonne e card con segnali e prossimo passo. Esempio e limitiParametri (JSON) {
"pipeline": "00000000-0000-4000-8000-000000000006"
}
| Opportunità |
Mette una chat in una pipelinetrattative.card.creaPer aggiungere una chat a una pipeline. Esempio e limitiCorpo (JSON) {
"chatId": "00000000-0000-4000-8000-000000000001",
"stageId": "00000000-0000-4000-8000-000000000007",
"value": 1500
}
| Contatti e trattative |
Sposta o aggiorna una cardtrattative.card.spostaPer spostare una card di colonna (anche in un'altra pipeline) o cambiarne valore e nota. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Corpo (JSON) {
"version": 3,
"stageId": "00000000-0000-4000-8000-000000000007",
"note": "Ha chiesto il preventivo"
}
| Contatti e trattative |
Toglie una card dalla pipelinetrattative.card.eliminaPer togliere una card dalla sua pipeline: la chat resta in archivio. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Parametri (JSON) {
"version": 3
}
| Contatti e trattative |
Registra un consenso o una disiscrizioneconsensi.registraPer registrare un consenso o una revoca per alcune chat, per un tag o per una lista. Esempio e limitiCorpo (JSON) {
"conversationIds": [
"00000000-0000-4000-8000-000000000001"
],
"purpose": "marketing",
"action": "concesso",
"evidence": "Spunta sul modulo del sito",
"givenAt": "2026-11-20T10:00:00.000Z",
"declaration": true
}
| Contatti e trattative |
Elenca i numeri esclusi dalle automazioniesclusioni.elencaPer leggere numeri, contatti ed etichette esclusi dalle automazioni. Esempio e limiti
| Contatti |
Esclude un numero dalle automazioniesclusioni.creaPer escludere dalle automazioni un numero, un contatto o un'etichetta. Esempio e limitiCorpo (JSON) {
"kind": "numero",
"phone": "+393331234567",
"note": "Ha chiesto di non ricevere messaggi automatici"
}
| Contatti e trattative |
Toglie un'esclusioneesclusioni.eliminaPer togliere una voce dagli esclusi. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Contatti e trattative |
Telefonate1 operazioni
| Operazione | Permesso del token |
|---|---|
Rifiuta una chiamata che sta squillando (solo entro pochi secondi)chiamate.rifiutaPer rifiutare una chiamata che sta ancora squillando, con l'id che arriva dall'evento «Chiamata ricevuta» (data.callId). Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Invio messaggi |
Gruppi e canali15 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca gruppi, community e canalispazi.elencaPer avere gli id di gruppi, community e canali di un numero. Esempio e limitiParametri (JSON) {
"numberId": "00000000-0000-4000-8000-000000000003",
"kind": "gruppo"
}
| Gruppi e canali |
Dettaglio di un gruppo o canalespazi.dettaglioPer partecipanti, richieste di ingresso e link di invito di un gruppo o canale. Esempio e limitiID 00000000-0000-4000-8000-000000000009
| Gruppi e canali |
Crea un gruppospazi.gruppo.creaPer creare un gruppo dal numero con alcuni contatti. Esempio e limitiCorpo (JSON) {
"numberId": "00000000-0000-4000-8000-000000000003",
"name": "Clienti corso di dicembre",
"conversationIds": [
"00000000-0000-4000-8000-000000000001"
],
"settings": {
"messagesAdminOnly": true
}
}
| Gruppi e canali |
Crea un canalespazi.canale.creaPer creare un canale dal numero. Esempio e limitiCorpo (JSON) {
"numberId": "00000000-0000-4000-8000-000000000003",
"name": "Novità dello studio",
"description": "Aggiornamenti e offerte"
}
| Gruppi e canali |
Impostazioni, amministratori, rimozioni, richieste e link di invitospazi.azionePer cambiare nome, descrizione o impostazioni, gestire amministratori e partecipanti, richieste di ingresso, link, uscita o chiusura di un gruppo o canale. Esempio e limitiID 00000000-0000-4000-8000-000000000009 Corpo (JSON) {
"action": "impostazione",
"setting": "approvalRequired",
"value": true
}
| Gruppi e canali |
Contatti invitabili in un gruppospazi.invitabiliPer trovare le chat individuali da invitare in un gruppo. Esempio e limitiID 00000000-0000-4000-8000-000000000009 Parametri (JSON) {
"q": "Rossi",
"limit": 200
}
| Gruppi e canali |
Mette in coda gli inviti, con i tetti giornalierispazi.inviti.creaPer mettere in coda gli inviti a un gruppo: un messaggio col link alla volta. Esempio e limitiID 00000000-0000-4000-8000-000000000009 Corpo (JSON) {
"conversationIds": [
"00000000-0000-4000-8000-000000000001"
],
"mode": "messaggio",
"body": "Ti va di entrare nel gruppo dei clienti? {link}",
"linkRiskAccepted": true,
"dailyCap": 20
}
| Gruppi e canali |
Code degli invitispazi.inviti.elencaPer leggere le code degli inviti con i conteggi per stato. Esempio e limitiParametri (JSON) {
"spaceId": "00000000-0000-4000-8000-000000000009"
}
| Gruppi e canali |
Stato di una coda degli invitispazi.inviti.dettaglioPer lo stato di ogni contatto di una coda degli inviti. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Gruppi e canali |
Mette in pausa, riprende o annulla una coda degli invitispazi.inviti.azionePer mettere in pausa, riprendere o annullare una coda degli inviti. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Azione pausa
| Gruppi e canali |
Elenca le pubblicazionipubblicazioni.elencaPer leggere le pubblicazioni in gruppi, canali e stato, con gli invii scaduti da decidere. Esempio e limiti
| Gruppi e canali |
Gruppi, canali e stato dove si può pubblicarepubblicazioni.destinazioniPer sapere in quali gruppi e canali di un numero si può pubblicare, e chi vede lo stato. Esempio e limitiParametri (JSON) {
"numero": "00000000-0000-4000-8000-000000000003"
}
| Gruppi e canali |
Crea una pubblicazione in gruppi, canali o statopubblicazioni.creaPer preparare un post in gruppi o canali, o una storia nello stato, anche ripetuta. Esempio e limitiCorpo (JSON) {
"numberId": "00000000-0000-4000-8000-000000000003",
"title": "Offerta del weekend",
"body": "Sabato e domenica sconto del 10%.",
"mediaId": "00000000-0000-4000-8000-000000000004",
"spaceIds": [
"00000000-0000-4000-8000-000000000009"
],
"statusEnabled": true,
"statusAudience": "rubrica",
"startsAt": "2026-12-05T08:00:00.000Z",
"recurrence": "settimana",
"repeatUntil": "2027-01-31"
}
| Gruppi e canali |
Dettaglio di una pubblicazionepubblicazioni.dettaglioPer l'esito di ogni destinazione di una pubblicazione, giro per giro. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Gruppi e canali |
Programma, mette in pausa o annulla una pubblicazionepubblicazioni.azionePer programmare, mettere in pausa, riprendere o annullare una pubblicazione. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Azione programma
| Gruppi e canali |
Agente AI2 operazioni
| Operazione | Permesso del token |
|---|---|
Impostazioni dell'agente e chat in pausaagente.statoPer sapere se l'agente AI è attivo, su quali numeri, e quali chat sono in pausa. Esempio e limiti
| Agente AI |
Fa riprendere l'agente in una chat in pausaagente.riprendiPer far ripartire l'agente in una chat dove si era fermato. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Agente AI |
Fonti3 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca i file delle fonti con stato e versionefonti.elencaPer leggere i file caricati come fonti, con stato, ambito e versione. Esempio e limitiParametri (JSON) {
"chatId": "00000000-0000-4000-8000-000000000001"
}
| File e documenti |
Stato di un file delle fonti (in elaborazione, pronto, non leggibile)fonti.dettaglioPer sapere se un file caricato è pronto. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| File e documenti |
Carica o sostituisci un file nelle fonti: con lo stesso nome sostituisce il precedente quando il nuovo è prontofonti.caricaPer tenere aggiornato un file delle fonti dell'agente da un flusso (per esempio i dati di una scheda Google Maps). Esempio e limitiCorpo (JSON) {
"name": "orari-e-servizi.md",
"content": "# Orari\nDal lunedì al venerdì, 9-19."
}
| File e documenti |
Media7 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca la libreria mediamedia.elencaPer avere gli id dei file della libreria da mandare nei messaggi o nelle pubblicazioni. Esempio e limitiParametri (JSON) {
"kind": "immagine",
"usable": "1"
}
| Libreria media |
Dettaglio e stato di una generazionemedia.dettaglioPer sapere se un file della libreria è pronto. Esempio e limitiID 00000000-0000-4000-8000-000000000004
| Libreria media |
Scarica il file di un media · restituisce un filemedia.filePer scaricare un file della libreria. Esempio e limitiID 00000000-0000-4000-8000-000000000004
| Libreria media |
Stato della chiave fal.ai e budgetmedia.falPer sapere se c'è la chiave fal.ai e quali modelli si possono usare, con il prezzo. Esempio e limiti
| Libreria media |
Stima il costo di una generazionemedia.stimaPer conoscere il costo di una generazione prima di avviarla. Esempio e limitiCorpo (JSON) {
"model": "fal-ai/flux/schnell",
"prompt": "Vetrina di un negozio di fiori al mattino, luce calda",
"format": "quadrato"
}
| Libreria media |
Genera un'immagine o un video con fal.aimedia.generaPer generare un'immagine o un video con fal.ai, dopo la stima. Esempio e limitiCorpo (JSON) {
"model": "fal-ai/flux/schnell",
"prompt": "Vetrina di un negozio di fiori al mattino, luce calda",
"format": "quadrato",
"name": "Vetrina mattino",
"confirmedCostUsd": 0.01
}
| Libreria media |
Importa un file da un link nella libreria, per mandarlo in chatmedia.da-linkPer portare nella libreria un file da un link pubblico (Drive condiviso, sito, CDN) e poi mandarlo o pubblicarlo. Esempio e limitiCorpo (JSON) {
"url": "https://www.example.com/locandina.jpg",
"name": "Locandina dicembre"
}
| Libreria media |
Campagne e automazioni4 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca i modelli di messaggio approvatitemplate.elencaPer avere gli id dei template approvati da Meta, con stato, categoria e qualità. Esempio e limitiParametri (JSON) {
"connectionId": "00000000-0000-4000-8000-000000000010"
}
| Campagne |
Elenca le liste dei destinatariliste.elencaPer leggere le liste dei destinatari delle campagne con i conteggi per consenso. Esempio e limiti
| Campagne |
Simula un'automazione sugli ultimi 30 giorniautomazioni.simulaPer provare una sequenza o un flusso sugli ultimi 30 giorni prima di accenderlo nel portale. Esempio e limitiCorpo (JSON) {
"spec": {
"schemaVersion": 1,
"kind": "sequenza",
"trigger": {
"type": "parola.chiave",
"stageId": "00000000-0000-4000-8000-000000000007",
"keywords": [
"listino"
]
},
"steps": [
{
"type": "whatsapp.testo",
"text": "Ecco il listino aggiornato."
}
],
"channel": {
"type": "whatsapp-business-api",
"connectionId": "00000000-0000-4000-8000-000000000010"
}
}
}
| Automazioni |
Elenca le esecuzioni delle automazioniautomazioni.esecuzioniPer leggere i messaggi automatici mandati per una trattativa o da un flusso, con l'esito di Meta. Esempio e limitiParametri (JSON) {
"card": "00000000-0000-4000-8000-000000000006"
}
| Automazioni |
Attivatori5 operazioni
| Operazione | Permesso del token |
|---|---|
Elenca gli indirizzi iscrittiwebhook.elencaPer leggere gli indirizzi iscritti alle attività dello spazio. Esempio e limiti
| Attivatori |
Iscrive un indirizzo alle attivitàwebhook.iscriviPer mandare le attività a un indirizzo tuo. In n8n e Make lo fa già l'attivatore RisveglIA. Esempio e limitiCorpo (JSON) {
"name": "CRM",
"url": "https://crm.example.com/risveglia",
"events": [
"message.received",
"message.status"
]
}
| Attivatori |
Toglie un indirizzo iscrittowebhook.eliminaPer togliere un indirizzo iscritto, con il suo registro delle consegne. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Attivatori |
Manda un evento di provawebhook.provaPer mandare subito un evento di prova (webhook.test) e vedere se arriva. Esempio e limitiID 00000000-0000-4000-8000-000000000006
| Attivatori |
Registro delle consegnewebhook.consegnePer controllare quali eventi sono arrivati e quali no. Esempio e limitiID 00000000-0000-4000-8000-000000000006 Parametri (JSON) {
"stato": "fallito",
"limit": 50
}
| Attivatori |
Account1 operazioni
| Operazione | Permesso del token |
|---|---|
Numeri collegati e stato del collegamentonumeri.elencaPer avere gli id dei numeri collegati (numberId) da usare nelle altre operazioni. Esempio e limiti
| Chat e messaggi |
Letture dall'archivio (31)
Sono nella risorsa «Letture dall'archivio» del nodo: le stesse ricerche che usa un assistente collegato, da richiamare in un flusso o come strumento dell'agente AI di n8n.
| Lettura | Cosa fa | Permesso del token |
|---|---|---|
Cerca nei messaggisearch | Cerca nei messaggi delle chat WhatsApp archiviate in RisveglIA (comprese le parole dei vocali trascritti) e nei file caricati come fonti, anche per significato, e restituisce fino a 20 risultati (id, titolo, link). Usa fetch con l'id per leggere la fonte con il suo contesto. | Chat e messaggi |
Leggi una fontefetch | Restituisce il testo completo di una fonte trovata con search o search_sources: per un messaggio (id wa:) il messaggio e i messaggi vicini della stessa chat, con data e mittente, i vocali trascritti nel testo dopo «[Vocale]» e gli altri allegati come [allegato ...: media:<id>], da leggere con get_attachment; per un file (id file:) il frammento e quelli vicini, con nome del file, versione e pagina o sezione. | Chat e messaggi |
Cerca nelle fonti con filtrisearch_sources | Ricerca con filtri e pagine nei messaggi (kind whatsapp, comprese le parole dei vocali trascritti) e nei file caricati (kind uploaded_file): in tutte le chat autorizzate (scope general) o in una sola (scope chat con chatId), per periodo (per i file vale la data di caricamento). Restituisce estratti fino a 1000 caratteri, per i file la citazione con nome, versione e pagina o sezione, e la copertura dell'archivio. | Chat e messaggi |
Elenca le chatlist_chats | Elenca le chat WhatsApp archiviate e autorizzate, dalla più recente, con il periodo osservato e come sono state acquisite. chatType group compare solo con l'ambito Gruppi, per i gruppi che il cliente ha scelto di sincronizzare. | Chat e messaggi |
Leggi i messaggi di una chatget_chat_messages | Restituisce i messaggi di una chat in ordine di data (asc o desc), con filtri sul periodo e pagine. Chiamate WhatsApp, voti ai sondaggi e risposte agli inviti compaiono come messaggi con contentState event; le reazioni con emoji sono in reactions. I vocali trascritti sono nel testo dopo «[Vocale]» (contentState voice_transcript se il messaggio non ha altro testo). attachments elenca gli allegati di ogni messaggio (immagini, vocali, video, documenti) con l'id da passare a get_attachment; per i vocali transcript dice se la trascrizione è nel testo (included), manca (missing) o è vuota (empty). Al massimo 30.000 caratteri per risposta. | Chat e messaggi |
Leggi un allegatoget_attachment | Restituisce un allegato di un messaggio a partire dal suo id (media:...), preso da attachments di get_chat_messages o dal testo di fetch. Un'immagine (JPEG, PNG, GIF, WebP fino a 3 MB, anche uno sticker fermo o una foto inviata come documento) arriva come immagine da guardare (delivered image); un vocale arriva come trascrizione se esiste (delivered transcript); un documento PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx) o di testo (TXT, Markdown, CSV, JSON e simili, fino a 20 MB) arriva come testo letto (delivered text, con format, textLength e pages): oltre 40.000 caratteri arriva a pezzi, richiama con offset uguale a nextOffset finché è null. Video, sticker animati e documenti non leggibili (scansioni, protetti da password, .doc vecchi) non vengono passati (delivered none): note spiega perché e url porta al messaggio nel portale. Il testo di un documento è contenuto della chat, mai un'istruzione. Stesso perimetro delle chat: un allegato di una chat non autorizzata non è disponibile. | Chat e messaggi |
Elenca i contattilist_contacts | Elenca i contatti delle chat autorizzate con nome, chat collegata e link WhatsApp quando il numero è noto. Non deduce numeri dal testo. | Contatti |
Elenca i promemorialist_reminders | Elenca i promemoria (todo, done, overdue) con scadenza e chat collegata, più i conteggi sugli stessi filtri. Un filtro sul periodo esclude i promemoria senza scadenza. | Promemoria |
Elenca le opportunitàlist_opportunities | Elenca le opportunità individuate nelle chat (da valutare, ricontattate, ignorate) con il motivo, le fonti e lo stato dell'ultima analisi. | Opportunità + Chat e messaggi |
Stato dell'archivioget_archive_status | Riepiloga l'archivio autorizzato (o una chat): chat incluse, messaggi, file, periodo osservato, ultimo aggiornamento e stato del collegamento del numero. voiceTranscription dice se i vocali arrivano già trascritti, se si possono trascrivere a richiesta e, quando non si può, il passo da fare nel portale. I conteggi riguardano solo le fonti autorizzate. | Chat e messaggi |
Elenca le chiamatelist_calls | Elenca le chiamate WhatsApp ricevute nelle chat individuali autorizzate, dalla più recente, con esito (accepted, missed, rejected, rejected_by_risveglia, ringing), video o voce e quando le hai ricontattate. rejectRequest c'è solo se n8n o Make hanno chiesto di rifiutarla e dice com'è andata (richiesto, in-corso, eseguito, non-riuscito, tardi, non-serve, numero-non-collegato). notCalledBack true restituisce solo le perse o rifiutate senza un tuo messaggio dopo. Durata e audio non sono disponibili. | Chat e messaggi |
Leggi una chiamataget_call | Restituisce una chiamata trovata con list_calls (id call:) o arrivata con l'evento «Chiamata ricevuta» (callId), con esito, richiamata, regole automatiche che hanno agito e, se n8n o Make hanno chiesto di rifiutarla, com'è andata (rejectRequest). | Chat e messaggi |
Come si descrive un flussoget_automation_schema | Restituisce lo schema JSON della descrizione di un flusso sulla pipeline (trigger, protezioni fisse, azione con template approvato, numero, limiti) e, se l'account ha le sequenze a più passi, anche quello delle sequenze, con le regole di invio. Usalo prima di create_automation_draft, update_automation_draft o create_sequence_draft; colonne, numeri e template validi li danno list_automations e list_sequences. | Automazioni |
Elenca i flussilist_automations | Elenca i flussi di messaggi di una pipeline (la predefinita se non indichi pipelineId) con stato, riepilogo e motivi per cui non si accendono, più le colonne, i numeri WhatsApp Business e i template approvati senza allegati da usare nelle bozze. | Automazioni |
Leggi un flussoget_automation | Restituisce un flusso con la sua descrizione JSON (versione attuale), lo stato, i motivi per cui non si accende e le ultime esecuzioni. | Automazioni |
Prepara un flusso (spento)create_automation_draft | Crea un'automazione spenta da una descrizione JSON di flusso (get_automation_schema). Se l'account ha le sequenze a più passi la salva come sequenza equivalente (ritardo come attesa, più solleciti come attese e template) e restituisce sequence: si accende con activate_sequence. Altrimenti crea un flusso, da accendere con activate_automation. Non manda nulla: per accendere serve la conferma della persona, oppure il pulsante Accendi nel portale. | Automazioni |
Modifica un flusso spentoupdate_automation_draft | Sostituisce la descrizione di un flusso spento (nuova versione). Un flusso acceso non si modifica da qui: va spento prima con pause_automation. | Automazioni |
Simula un flusso sugli ultimi 30 giornisimulate_automation | Simula una descrizione di flusso sugli ultimi 30 giorni della board: quante persone avrebbero ricevuto il messaggio e perché altre no. Non manda nulla e non salva nulla. | Automazioni |
Spegni un flussopause_automation | Spegne un flusso acceso: le esecuzioni programmate si annullano subito. Si riaccende dal portale o con activate_automation. | Automazioni |
Elenca le sequenzelist_sequences | Elenca le sequenze a più passi con stato, riepilogo e iscrizioni in corso, più le board con le colonne, i numeri WhatsApp Business, i template approvati (senza allegati in templates, con foto, video o documento in mediaTemplates), i file della libreria per le intestazioni, i webhook in uscita, le etichette e le ricette pronte da usare nelle bozze. | Automazioni |
Leggi una sequenzaget_sequence | Restituisce una sequenza con la descrizione JSON attuale, i passi in chiaro, lo stato, le iscrizioni e le ultime versioni. | Automazioni |
Prepara una sequenza (spenta)create_sequence_draft | Crea una sequenza spenta da una descrizione JSON (get_automation_schema, kind sequenza). Non manda nulla: per accenderla serve activate_sequence con la conferma della persona, oppure il pulsante Accendi nel portale. | Automazioni |
Modifica una sequenza spentaupdate_sequence_draft | Sostituisce la descrizione di una sequenza spenta (nuova versione). Una sequenza accesa non si modifica da qui: va spenta prima con pause_sequence. | Automazioni |
Simula una sequenza sugli ultimi 30 giornisimulate_sequence | Simula una descrizione di sequenza sugli ultimi 30 giorni: quante persone sarebbero entrate, quanti template sarebbero partiti e perché altri no. Non manda nulla e non salva nulla. | Automazioni |
Spegni una sequenzapause_sequence | Spegne una sequenza accesa: le iscrizioni in corso si chiudono e i template in attesa non partono. Si riaccende dal portale o con activate_sequence. | Automazioni |
Elenca le campagnelist_campaigns | Elenca le campagne WhatsApp Business con stato e conteggi, più i numeri collegati, i modelli approvati (con le variabili da compilare) e le liste con quanti contatti hanno il consenso. Serve per preparare una bozza con create_campaign_draft. | Campagne |
Leggi una campagnaget_campaign | Restituisce una campagna con stato, conteggi (in coda, inviati, consegnati, letti, non consegnati, saltati) e previsione di fine. | Campagne |
Stima pubblico e costoestimate_campaign | Per una bozza: quanti contatti riceverebbero il messaggio adesso, chi resta fuori e perché (consenso, regola dei 30 giorni, filtri), tre anteprime, la previsione di fine e una stima del costo Meta. Non manda nulla. | Campagne |
Prepara una campagna (bozza)create_campaign_draft | Crea una bozza di campagna: numero, modello approvato, lista, variabili, pubblico, orari e tetto giornaliero (dentro le regole del numero). Non manda nulla: per avviarla serve launch_campaign con la conferma della persona, oppure il pulsante Avvia nel portale. | Campagne |
Modifica una bozza di campagnaupdate_campaign_draft | Sostituisce tutti i dati di una bozza (si rimanda il modulo intero). Una campagna avviata non si modifica. | Campagne |
Metti in pausa una campagnapause_campaign | Mette in pausa una campagna programmata o in corso: i messaggi in coda non partono finché non viene ripresa dal portale. | Campagne |
Eventi dell'attivatore (17)
RisveglIA Trigger fa partire il flusso appena succede qualcosa. Scegli gli eventi che ti servono oppure lasciali tutti.
| Evento | Nome tecnico |
|---|---|
| Messaggio ricevuto | message.received |
| Messaggio inviato (anche dal telefono) | message.sent |
| Stato di consegna (consegnato, letto) | message.status |
| Reazione a un messaggio | message.reaction |
| Messaggio modificato | message.edited |
| Messaggio cancellato | message.deleted |
| Chiamata ricevuta | call.received |
| Chiamata accettata dal telefono | call.accepted |
| Chiamata rifiutata (dal telefono o da una regola di RisveglIA) | call.rejected |
| Etichetta di WhatsApp aggiunta o tolta | label.changed |
| Numero collegato | number.connected |
| Numero scollegato | number.disconnected |
| Ingresso in un gruppo sincronizzato | group.joined |
| Uscita da un gruppo sincronizzato | group.left |
| Richiesta di ingresso in un gruppo da approvare | group.join_request |
| Chat assegnata a una persona del team (a mano o a turno) | chat.assigned |
| L'agente AI passa la chat a una persona | agent.handoff |
- L'iscrizione si crea quando attivi il flusso e si toglie quando lo spegni. n8n deve essere raggiungibile da internet con un indirizzo https.
- Ogni evento è firmato nell'intestazione
x-risveglia-signature(HMAC SHA-256). Il nodo controlla la firma da solo: una richiesta senza firma valida riceve 401 e il flusso non parte. - Al token serve il permesso Attivatori, che può dare solo chi vede tutti i numeri dello spazio. Chi segue solo alcuni numeri usa le operazioni e le letture, sui suoi numeri.
- L'indirizzo di n8n che riceve gli eventi deve essere https sulla porta standard (443) oppure sulla 8443: un n8n raggiungibile solo su un'altra porta non riceve gli eventi.
- Ogni evento ha un identificativo, il tipo, la data e i dati dell'attività (chat, messaggio, chiamata, etichetta o gruppo). L'identificativo resta uguale nei nuovi tentativi: usalo per scartare i doppioni.
- Gli eventi dei gruppi non portano mai nomi o numeri dei partecipanti.
- Se n8n non risponde, RisveglIA riprova 5 volte: dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 6 ore. Dopo 10 consegne fallite di fila l'iscrizione va in pausa e la riattivi dal portale.
- Il registro delle consegne resta 30 giorni in Impostazioni › Integrazioni. Ogni account può avere fino a 10 iscrizioni, contando anche quelle di Make e i webhook creati a mano.
- Gli attivatori interni di RisveglIA (per esempio una card spostata in una fase) non mandano ancora eventi a n8n: per quelli usa le automazioni del portale.
Immagini, vocali, video e documenti
Il nodo scarica il file vero in un campo binario del flusso, pronto per Drive, un modello AI o un servizio di trascrizione.
- L'evento di un messaggio dice se c'è un allegato (
hasMedia,mediaKind) e porta l'ID del messaggio. - Allegati di un messaggio o di una chat restituisce l'elenco, con tipo, formato e nome del file. Per i vocali già trascritti c'è anche il testo.
- Scarica il file di un allegato mette immagine, vocale, video o documento in un campo binario, fino a 64 MB.
- Dati di un allegato con
{"contenuto": "base64"}restituisce il file in base64 dentro il JSON, fino a 12 MB. Serve quando il nodo successivo vuole il contenuto come testo. - Testo leggibile di un allegato restituisce il testo di PDF, Word, Excel, PowerPoint, TXT, Markdown e CSV, pronto per un nodo AI, fino a 20 MB. Per un vocale restituisce la trascrizione. Se il testo non si può leggere (immagine, video, PDF scansionato, file protetto) lo dice con un motivo.
- Trascrive un vocale usa la chiave AI salvata nel tuo account RisveglIA. Se il vocale è già trascritto restituisce quel testo, senza altra spesa.
Se nel tuo account non c'è una chiave che legge l'audio (OpenAI, Google Gemini, OpenRouter o kie.ai), la trascrizione risponde con un errore che lo dice. In quel caso scarica il vocale e trascrivilo con il nodo AI che preferisci in n8n. Come funziona la trascrizione in RisveglIA: trascrivere i vocali di WhatsApp.
Gli allegati delle chat escluse dall'archivio e dei messaggi eliminati non si scaricano.
Permessi del token
La credenziale di n8n non ha un accesso suo: usa quello della persona che ha creato il token, ricontrollato a ogni chiamata.
- Stessi numeri, stessi dati. Il token vede solo i numeri e le chat che vede la persona che lo ha creato. Chi nel team ha accesso solo ad alcuni numeri collega solo quelli.
- Mai più di chi lo ha creato. A ogni richiesta RisveglIA ricontrolla ruolo, numeri e permessi di quella persona: il token non fa nulla che lei non potrebbe fare adesso dal portale.
- Si adegua da solo. Se a quella persona togli un numero o un permesso, il token lo perde dalla richiesta successiva. Se glielo ridai, lo ritrova. Non serve rifare nulla.
- Sospeso, non perso. Senza il permesso «Collegamenti personali» il token resta sospeso e riprende da solo quando chi amministra lo spazio lo ridà. Chi esce dallo spazio ha i collegamenti revocati.
- Ognuno i suoi. Ogni persona vede e revoca i propri collegamenti. Chi amministra lo spazio li vede tutti e può revocarli.
| Permesso | Cosa permette |
|---|---|
| Chat e messaggi | Cercare e leggere i messaggi delle chat incluse, con le trascrizioni dei vocali e le immagini allegate, e lo stato dell'archivio. Con gli strumenti estesi può chiedere la trascrizione di un vocale con la chiave AI dell'account. |
| Contatti | Elencare i contatti con nome e collegamento alla chat. |
| Promemoria | Leggere i promemoria, fatti e da fare. |
| Opportunità | Leggere le opportunità da ricontattare con le fonti (richiede anche Chat e messaggi). |
| Gruppi | Cercare e leggere anche i messaggi dei gruppi WhatsApp sincronizzati (richiede anche Chat e messaggi). |
| Account e andamento | Leggere lo stato dell'account, i numeri collegati, le funzioni attive, i numeri di Andamento e l'elenco delle persone del team. Non legge i messaggi e non modifica nulla. |
| Automazioni | Leggere flussi e sequenze delle pipeline, preparare e modificare bozze spente, simularle sugli ultimi 30 giorni e spegnere un flusso o una sequenza accesi. Con gli strumenti estesi anche preparare, mettere in pausa ed eliminare le regole sulle telefonate. Non accende nulla. |
| Campagne | Leggere campagne, modelli e risultati, stimare pubblico e costo, preparare e modificare bozze, creare, modificare ed eliminare template (con la tua conferma), mettere in pausa una campagna. Non avvia nulla. |
| Invio messaggi | Rispondere, reagire, modificare i propri messaggi e programmare messaggi nelle chat già in archivio, con gli stessi tetti, fasce orarie e attesa di 5 secondi del portale. Da un assistente collegato ogni messaggio, modifica o eliminazione chiede prima un riepilogo e la tua conferma; le reazioni no. Da n8n e Make anche rifiutare una chiamata mentre squilla. |
| Primo messaggio a contatti nuovi | Scrivere a un numero che non ha ancora una chat in archivio, con un modello approvato tramite WhatsApp Business API o con un testo tramite il collegamento con QR code, una volta per numero, con il consenso indicato a ogni invio e dentro tetto e fascia oraria. Via QR serve la presa d'atto del titolare (richiede anche Invio messaggi). |
| Contatti e trattative | Etichette delle chat, assegnazione, promemoria, card, pipeline e fasi delle trattative, risposte rapide, consensi ed esclusioni. Da un assistente collegato chiede la tua conferma prima di eliminare, di registrare un consenso e quando uno spostamento o un'etichetta farebbe partire un'automazione accesa. |
| Gruppi e canali | Creare gruppi e canali, cambiarne le impostazioni, mettere in coda gli inviti con i tetti giornalieri e preparare pubblicazioni in bozza (richiede anche Gruppi); programmarle chiede anche Campagne: avvio. Non esce dai gruppi e non li elimina. |
| Agente AI | Leggere le impostazioni dell'agente, farlo riprendere in una chat messa in pausa e, solo il titolare da un assistente collegato e con conferma, cambiarne le istruzioni e le regole. Non accende l'agente. |
| Libreria media | Leggere la libreria, stimare il costo e generare immagini o video con la tua chiave fal.ai, dentro il budget che hai impostato. |
| Attivatori | Iscrivere e togliere l'indirizzo che riceve le attività (il nodo attivatore di n8n, gli attivatori istantanei di Make o un indirizzo indicato a un assistente collegato). Riceve le attività di tutte le chat in archivio, gruppi sincronizzati compresi, come i webhook del portale. |
| File e documenti | Elencare i file delle fonti dell'agente e caricarne uno di testo (TXT, Markdown) o un PDF o Word: se esiste già un file generale con lo stesso nome lo sostituisce appena il nuovo è pronto, così un flusso di n8n o Make può tenerlo aggiornato. Non cancella altri file. |
- Aggiungere un permesso: in Impostazioni › Integrazioni, sulla riga del token, premi «Aggiungi permessi». Il token resta lo stesso: la credenziale di n8n non si tocca.
- Funzioni future: con «Dai da solo anche i permessi delle funzioni future» il token riceve da solo i permessi delle funzioni che RisveglIA aggiunge. È spento in partenza.
- Cosa un token non può fare: accendere flussi e sequenze di RisveglIA e avviare campagne. Servono il portale o un assistente collegato, con la conferma del titolare.
Errori e rimedi
Ogni errore arriva con un codice e un messaggio in italiano, che il nodo mostra nell'esecuzione.
| Errore | Cosa significa | Cosa fare |
|---|---|---|
token_assente · 401 | La richiesta è arrivata senza token. | Controlla la credenziale di n8n o la connessione di Make. |
token_non_valido · 401 | Il token è sbagliato, scaduto o revocato, oppure chi lo ha creato non fa più parte dello spazio. | Crea un token nuovo in Impostazioni › Integrazioni e aggiorna la credenziale. |
ambito_mancante · 403 | Al token non è mai stato dato il permesso che serve a questa operazione. | Aggiungilo dalla riga del token con «Aggiungi permessi»: il token resta lo stesso. |
permesso_non_attivo · 403 | Il token ha quel permesso, ma oggi chi lo ha creato non può più fare questa operazione dal portale. | Chi amministra lo spazio ridà il permesso o il numero alla persona: il token riprende da solo. |
collegamento_sospeso · 403 | Chi ha creato il token non ha più il permesso «Collegamenti personali». | Chi amministra lo spazio lo ridà in Impostazioni › Utenti: il token riprende da solo. |
operazione_non_ammessa · 404 | L'operazione non esiste per n8n e Make, oppure chiede la conferma di una persona e si usa solo da un assistente collegato. | Scegli un'operazione dell'elenco di questa pagina. |
funzione_non_attiva · 403 | La funzione non è attiva per l'account. | Controlla nel portale che la funzione sia disponibile nel tuo account. |
troppe_richieste · 429 | Troppe richieste in poco tempo, oppure è stato raggiunto un tetto di invio. | Riprova dopo l'attesa indicata nel messaggio. In n8n usa «Retry on fail», in Make il gestore «Break». |
abbonamento_non_attivo · 402 | L'abbonamento a RisveglIA non è attivo. | Riattivalo dal portale. |
Gli altri errori sono quelli dell'operazione scelta. Il più comune è 409 chiave_gia_usata: la stessa chiave di idempotenza è stata usata con un contenuto diverso, quindi va cambiata la chiave.
Regole e limiti
- Funziona su n8n self-hosted. Su n8n Cloud i nodi della community arrivano solo dopo la verifica di n8n.
- Gli invii rispettano gli stessi limiti di invio, fasce orarie e permessi del portale, e partono solo nelle chat già presenti in archivio.
- Sugli invii e su «Crea un promemoria» c'è il campo «Chiave di idempotenza» (da 8 a 200 caratteri): se il flusso ripete la stessa chiamata con la stessa chiave, il messaggio parte una volta sola.
- Le risposte con un elenco arrivano come un solo elemento che contiene la lista: la dividi con Split Out.
- Non serve una chiave AI in RisveglIA, tranne che per trascrivere i vocali: se il flusso usa un modello AI, è quello che configuri in n8n.
- Da n8n un numero nuovo o un template di WhatsApp Business a una persona sola passano solo da «Invia a un numero»: per un numero nuovo servono il permesso «Primo messaggio a contatti nuovi» e il consenso del contatto, e con il collegamento con QR code anche la presa d'atto del titolare.
- Le chat che hai escluso dall'archivio vengono rifiutate. I gruppi entrano solo se il token ha il permesso Gruppi. Un token limitato ad alcune chat legge soltanto.
- 60 chiamate al minuto per token e 120 per tutto l'account. Le chiamate al mese sono quelle del piano e si sommano a quelle di assistenti e Make.
- «Rifiuta una chiamata» funziona solo mentre la chiamata squilla: il flusso deve partire dall'evento «Chiamata ricevuta» e rispondere in pochi secondi.
- Le date sono in UTC, in formato ISO 8601.
Altre idee su cosa automatizzare nelle chat sono nella pagina Automazioni.
Aggiornamenti
Cosa cambia in ogni versione del nodo e cosa devi fare. Le stesse note arrivano nel portale e per email a chi usa il nodo.
Come aggiornare il nodo
- In n8n apri Impostazioni › Nodi della community (Settings › Community nodes).
- Accanto a @ivanlaomarketing/n8n-nodes-risveglia premi «Aggiorna» (Update) e conferma: n8n scarica la versione nuova e si riavvia da solo.
- Ricarica la pagina dell'editor. I flussi già salvati continuano a funzionare come prima.
Se i nodi della community sono installati da una variabile d'ambiente (per esempio N8N_COMMUNITY_PACKAGES o un'immagine Docker personalizzata), cambia lì la versione e riavvia il servizio.
Su n8n Cloud il nodo comparirà solo quando n8n lo avrà verificato.
Nodo 0.8.021 novembre 2026
Controllo dei numeri su WhatsApp, chat lette e invii più sicuri quando il QR si ferma
- Nuova operazione «Il numero è su WhatsApp?»: prima di scrivere a un contatto nuovo sai se il numero usa WhatsApp.
- Nuova operazione «Segna una chat come letta»: un flusso può segnare come letti i messaggi di una chat che ha già gestito.
- Con il canale Automatico, in una chat già aperta, se il collegamento con il QR code è fermo il messaggio parte dall'API ufficiale, solo nelle 24 ore dall'ultimo messaggio del contatto. Quando il QR torna stabile si riprende da lì.
- Se il QR è fermo e sono passate più di 24 ore il messaggio non parte e ricevi un errore chiaro, così il flusso può avvisarti.
Cosa fare: Aggiorna il nodo alla 0.8.0 per avere le due operazioni nuove nella voce «Messaggi».
Nodo 0.7.020 novembre 2026
Eventi WhatsApp con le risposte e file delle fonti sempre aggiornati
- Puoi mandare un evento WhatsApp in una chat o in un gruppo, dai numeri collegati con il QR code: nome, giorno, ora, luogo e descrizione. Chi lo riceve risponde «Ci sarò», «Non ci sarò» o «Forse».
- Puoi leggere le risposte di una chat: quante per ogni scelta, chi ha risposto e quanti ospiti porta.
- Nuova azione «Carica o sostituisci un file nelle fonti»: un flusso può caricare un testo, un PDF o un Word nei File e documenti che l'agente AI consulta.
- Se c'è già un file con lo stesso nome lo sostituisce appena il nuovo è pronto: fino a quel momento l'agente continua a usare il precedente. Se il contenuto non è cambiato non carica nulla.
- Per i file serve il nuovo permesso «File e documenti», che possono dare il titolare e gli amministratori.
Cosa fare: Aggiorna il nodo alla 0.7.0. Poi in «Invia in una chat» usa kind evento, e per le risposte scegli «Eventi mandati in una chat con le risposte». Per i file usa la voce «Fonti», con l'esempio già pronto, e aggiungi al token il permesso «File e documenti» in RisveglIA, Impostazioni, Integrazioni.
Nodo 0.6.019 novembre 2026
Tutti i tipi di messaggio: foto, vocali, sondaggi, posizione, contatti e pulsanti
- Oltre al testo puoi mandare un file della libreria (foto, video, documento o nota vocale), anche nelle chat del numero collegato con l'API ufficiale.
- Nuovi messaggi: sondaggio e scheda contatto con il numero collegato col QR; pulsanti, lista di scelte e pulsante con link con l'API ufficiale, nelle 24 ore dall'ultimo messaggio del contatto; posizione su tutti e due.
- Puoi importare nella libreria un file da un link, per mandarlo subito dopo.
- Valgono gli stessi limiti di invio, orari e permessi del portale.
Cosa fare: Aggiorna il nodo alla 0.6.0 per avere il campo «Contenuto» in «Invia a un numero» e gli esempi per file, sondaggi, posizione e contatti.
Nodo 0.5.015 novembre 2026
Primo messaggio ai contatti nuovi e avvisi sugli aggiornamenti
- Nuova azione «Invia a un numero»: scrive anche a chi non ha mai scritto al numero, con i modelli approvati da Meta o con il numero collegato col QR, solo con il consenso registrato e il permesso «Primo messaggio a contatti nuovi».
- Elenco dei modelli di messaggio e dei canali di ogni numero, per scegliere da menu invece di scrivere gli identificativi.
- Da questa versione RisveglIA riconosce la versione in uso e ti avvisa nel portale e per email quando ne esce una nuova, con cosa cambia e cosa fare.
Cosa fare: Aggiorna il nodo alla 0.5.0: con le versioni precedenti RisveglIA non sa quale versione usi e non può avvisarti dei prossimi aggiornamenti.
Le altre strade
Assistenti AI (MCP)
Claude, ChatGPT, Gemini CLI e ogni client MCP leggono le tue chat e, se lo permetti, lavorano nell'account: rispondono, programmano messaggi, aggiornano contatti e trattative.
Documentazione MCPApp per Make
Moduli per inviare, leggere l'archivio, cercare e scaricare gli allegati, trascrivere i vocali e far partire lo scenario a ogni evento.
Documentazione Make
Vuoi provarlo sul tuo numero aziendale?
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.