n8n

Installa il nodo della community, crea la credenziale, costruisci un primo workflow e comprendi il limite del webhook unico prima di aggiungere un trigger.

WASync fornisce un nodo della community per n8n, pubblicato su npm come n8n-nodes-wasync. Utilizza la stessa REST API descritta in questa documentazione, quindi tutto ciò che fa il nodo lo potete fare anche con curl — e lo potete fare anche per ciò che il nodo non copre ancora.

Prima di iniziare: un account e un numero connesso

Il nodo comunica con il vostro account WASync. Se non ne avete ancora uno, createlo prima: richiede un minuto ed è gratuito.

Creare un account sviluppatore gratuito

Andate su developers.wasync.app/register — nome, email, password. Ogni nuovo account include un proprio workspace: il luogo in cui risiedono i vostri numeri WhatsApp e le vostre API key.

Portare un numero WhatsApp in quel workspace

Due situazioni:

Utilizzate già WASync all'interno di Bitrix24 — accedete con la stessa email che usate in Bitrix24. Il vostro portale compare come workspace e i numeri connessi sono pronti all'uso. L'invio tramite API richiede l'add-on API su quel numero (12 $ per numero al mese; senza di esso il passaggio di invio del nodo risponde addon_required).
Siete nuovi su WASync — collegate un numero al vostro workspace con una sola chiamata API che restituisce un codice QR (oppure un codice di abbinamento da inserire in WhatsApp). I passaggi esatti sono in Collegare un numero WhatsApp. Ogni numero parte con una prova gratuita di 7 giorni; i piani sono WAPP 19 $ oppure WABA 29 $ per numero al mese, in USD.

Creare una API key

Ci sono due modi:

Utilizzate già WASync all'interno di Bitrix24? Andate su Settings → API & Agents → API keys, assegnate un nome all'integrazione e fate clic su Create key. Serve una connessione con l'add-on API attivo e la chiave include gli scope necessari a questo workflow (whatsapp.read whatsapp.send) — saltate l'elenco degli scope qui sotto.
In caso contrario, accedete e aprite developers.wasync.app/keys. Scegliete il workspace, assegnate un nome alla chiave, selezionate gli scope indicati sotto e createla.

In entrambi i casi, copiate subito la chiave: viene mostrata una sola volta. È il valore richiesto dalla credenziale n8n.

Un account, molti numeri

L'operazione Connection → List del nodo mostra tutti i numeri raggiungibili con la chiave. Se l'elenco è vuoto, il workspace non ha ancora un numero connesso: tornate al passaggio 2.

1. Installare il nodo della community

Verificato da n8n (7 set 2026)

n8n-nodes-wasync è un nodo della community verificato: riporta il badge di verifica ovunque n8n ne mostri uno.

Ci sono due modi per installarlo, a seconda di dove eseguite n8n:

n8n Cloud o self-hosted — cercate nel pannello dei nodi. Aprite il pannello dei nodi, cercate "WASync" e aggiungetelo. I nodi verificati si installano direttamente da lì, senza ulteriori configurazioni.
Solo self-hosted — impostazioni Community Nodes. Andate su Settings → Community nodes → Install, inserite il nome del pacchetto e confermate:
```
n8n-nodes-wasync
```
Questa via funziona su qualsiasi istanza self-hosted, verificata o meno.

Dopo l'installazione, i nodi WASync e WASync Trigger compaiono nel pannello dei nodi.

Punti di partenza pronti all'uso: i template di workflow gratuiti coprono i flussi più comuni: importatene uno e adattate i campi invece di partire da una tela vuota.

2. Creare la credenziale

Aggiungete una credenziale di tipo WASync API. Richiede un solo campo: la vostra API key, che viene inviata come Authorization: Bearer ….

Incollate la chiave creata in precedenza (vedere Prima di iniziare): viene mostrata una sola volta. Assegnatele soltanto gli scope necessari al workflow:

elencare le connessioni e leggere i messaggi → whatsapp.read
inviare e segnare come letto → whatsapp.send
il trigger → whatsapp.events

Vedere Scope.

3. Il vostro primo workflow

Il workflow utile più semplice ha due nodi: un trigger manuale e un invio.

Trovare l'id della connessione. Aggiungete un nodo WASync, scegliete la risorsa Connection → operazione List ed eseguitelo. Copiate l'id del numero da cui volete inviare.

Inviare un messaggio. Aggiungete un secondo nodo WASync, risorsa Message → operazione Send. Compilate:

Campo	Valore
`connectionId`	l'id appena copiato
`to`	cifre internazionali, senza `+` — ad es. `40712345678`
`text`	il testo del messaggio

Eseguire. Il nodo restituisce l'id del messaggio che potrete usare in seguito per i collegamenti: vedere i due id.

Operazioni supportate dal nodo

Risorsa	Operazione	Parametri
Connection	List	—
Message	Send	`connectionId`, `to`, `text`
Message	Get Many	`connectionId`, `limit`
Message	Mark as Read	—

Solo invio di testo. L'invio di un modello WhatsApp e la verifica della presenza di un numero su WhatsApp non sono oggi disponibili tramite API, quindi il nodo non li offre: non costruite un workflow che ne presupponga l'esistenza.

4. Il trigger

WASync Trigger avvia un workflow quando accade qualcosa sul vostro account. Supporta quattro eventi:

message.received
message.status
connection.connected
connection.disconnected

I payload sono esattamente quelli della guida ai webhook: stessi campi, stessi id, stesso timestamp in millisecondi.

Un solo slot webhook per account: un trigger lo sposta

L'API prevede un solo URL webhook per account (PUT /webhook, POST /webhook/rotate, e nessuna eliminazione). Attivare un WASync Trigger punta quell'unico slot verso n8n.

Quindi: se il vostro backend riceveva già dei webhook, smette di riceverli nel momento in cui il trigger subentra. E due WASync Trigger non possono occupare entrambi lo slot: il secondo prevale. Se vi servono gli eventi in più di un posto, riceveteli una volta sola e ridistribuiteli voi: lasciate che n8n occupi lo slot e inoltri da un workflow, oppure lasciate che sia il vostro backend a occuparlo e a chiamare un nodo Webhook di n8n.

Gli URL del trigger di test e di produzione sono diversi, quindi il passaggio dall'uno all'altro sposta a sua volta lo slot.

Poiché le consegne vengono scartate dopo tre tentativi falliti, mantenete un percorso di riconciliazione anche in n8n: un workflow pianificato che chiami Message → Get Many ogni 30–60 secondi recupera tutto ciò che il trigger ha perso mentre l'istanza si riavviava.

Quando il nodo non basta

Il nodo copre il percorso più comune. Per invio di media, codici di abbinamento, provisioning delle connessioni, gestione di Idempotency-Key o qualsiasi altra funzione del riferimento API, usate il nodo HTTP Request di n8n con la stessa credenziale: URL di base https://developers.wasync.app/api/v1, header Authorization: Bearer <key>.

Questa pagina è stata utile?

On this page