Integrazione con n8n

Invia messaggi WhatsApp dai tuoi flussi di lavoro n8n. Ad esempio, scrivi a un nuovo lead a partire da un webhook, conferma un ordine del tuo negozio o invia un avviso quando un controllo non va a buon fine.

Ci sono due modi per collegarsi:

• Il community node di Wbiztool (n8n-nodes-wbiztool): nodi pronti all'uso con campi per ogni opzione.
• Il nodo HTTP Request integrato: funziona su qualsiasi istanza n8n e ti dà accesso a tutti gli endpoint dell'API. Consulta Usare il nodo HTTP Request.

Prima di iniziare#

• Un account Wbiztool con un numero WhatsApp collegato nelle Impostazioni WhatsApp.
• Il tuo Client ID e la tua chiave API da Impostazioni → Chiavi API.
• Il WhatsApp Client ID del numero da cui inviare, visibile nelle Impostazioni WhatsApp.

Installare il community node#

1. Apri i community node

   In n8n, vai su Settings → Community Nodes (impostazioni → community node) e fai clic su Install (installa).

2. Inserisci il nome del pacchetto

   Inserisci n8n-nodes-wbiztool, conferma e installa. Riavvia n8n se i nodi non compaiono.

Su un'istanza self-hosted puoi anche installarlo con npm nella cartella dei nodi personalizzati di n8n:

npm install n8n-nodes-wbiztool

Creare la credenziale#

Aggiungi una nuova credenziale di tipo WbizTool API:

Quando salvi, n8n verifica la credenziale con Verifica credenziali.

Nodi#

Il pacchetto aggiunge questi nodi. Ognuno chiama un endpoint dell'API di Wbiztool e restituisce come output la risposta dell'API.

WbizTool Send Message#

Il nodo restituisce messageId (il msg_id dell'API). Salvalo se vuoi controllare lo stato del messaggio o annullarlo in seguito.

Flusso di lavoro di esempio#

1. Un nodo Webhook riceve un nuovo lead con phone e name.
2. WbizTool Send Message: imposta Phone Number su {{ $json.phone }} e Message Text su Hi {{ $json.name }}, thanks for signing up!.
3. Nodo IF: verifica che {{ $json.messageId }} non sia vuoto per proseguire con il passo successivo, ad esempio l'aggiornamento del tuo CRM.

Un WbizTool Send Message riuscito restituisce un elemento come questo:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

L'elemento include anche un oggetto input con i valori inviati dal nodo. Se l'API restituisce un errore, il nodo si ferma e mostra il message dell'API. Attiva Continue On Fail per ottenere invece un elemento con success: false e il testo dell'error.

Per WbizTool WhatsApp Client Status, usa il metodo di verifica General Status. Il metodo Status by ID restituisce un errore per ogni numero a causa di un bug in quell'endpoint dell'API. Con General Status, anche un numero non collegato ferma il nodo con un errore Disconnected, quindi attiva l'impostazione Continue On Fail del nodo se vuoi gestire il risultato con una diramazione.

Usare il nodo HTTP Request#

Aggiungi un nodo HTTP Request e configuralo così:

Poi incolla un corpo come questo e mappa i valori dai nodi precedenti con le espressioni:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Una chiamata riuscita restituisce {"status": 1, "message": "Created", "msg_id": 9817263}. Tutti i campi e i messaggi di errore sono descritti in Invia messaggio.

Per chiamare altri endpoint, cambia l'URL e il corpo. Ad esempio, per pianificare un messaggio usa https://wbiztool.com/api/v1/schedule_msg/ e aggiungi date nel formato DD/MM/YYYY, time nel formato HH:MM e timezone. Consulta Pianifica messaggio.

Per inviare lo stesso messaggio a più numeri o gruppi con una sola chiamata, usa https://wbiztool.com/api/v1/send_msg/multi/ e inserisci i destinatari in phone come un'unica stringa separata da virgole. Consulta Invia a più numeri.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Inserisci solo cifre in ogni numero. Tutto ciò che non è un numero intero, come 98765 43210, viene inviato come nome di gruppo.

Le espressioni n8n funzionano in qualsiasi campo di testo. Ad esempio, un saluto che dipende dall'ora del giorno o un testo che dipende dal totale dell'ordine:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now usa il fuso orario del workflow (Workflow settings → Timezone, impostazioni del workflow → fuso orario), quindi impostalo per decidere quando finisce il "morning".

Ricevere una notifica quando un messaggio viene inviato#

1. Crea un flusso di lavoro con webhook

   Aggiungi un nodo Webhook con metodo HTTP POST e copia il suo URL di produzione.

2. Passa l'URL quando invii

   Inserisci quell'URL nell'opzione Webhook URL del nodo, oppure nel campo webhook del corpo della tua richiesta HTTP.

3. Leggi il risultato

   Wbiztool chiama l'URL quando il messaggio viene inviato o non riesce. Il corpo è codificato come form e contiene solo msg_id e status, che vale SENT oppure FAILED.

Consulta Webhook per i tentativi ripetuti e i timeout.

Risoluzione dei problemi#