Integrazione con Zapier

L'app WbizTool su Zapier collega il tuo numero WhatsApp alle altre app che usi. Avvia uno Zap quando arriva un messaggio WhatsApp, oppure invia un messaggio WhatsApp quando succede qualcosa in un'altra app.

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.
• Per il trigger dei messaggi in arrivo: il componente aggiuntivo Unibox nel tuo piano. Consulta Requisiti del trigger.

Collegare il tuo account#

1. Aggiungi WbizTool a uno Zap

   In Zapier, crea uno Zap e cerca WbizTool come app di trigger o di azione.

2. Accedi

   Quando Zapier ti chiede di collegare un account, inserisci il tuo Client ID e la tua chiave API da Impostazioni → Chiavi API.

La chiave API determina quale spazio di lavoro usa Zapier. Se fai parte di più spazi di lavoro, usa una chiave creata nello spazio di lavoro che vuoi collegare. Se il Client ID o la chiave API sono errati, Zapier mostra l'errore al momento del collegamento, ad esempio Auth Error: invalid api key.

Trigger per i messaggi WhatsApp in arrivo#

Questo trigger avvia il tuo Zap ogni volta che qualcuno invia un messaggio a uno dei tuoi numeri WhatsApp. Usalo per aggiungere le nuove chat a un CRM, pubblicare i messaggi in un canale del team o registrare le conversazioni in un foglio di calcolo.

1. Scegli il trigger

   Scegli WbizTool come app e Incoming WhatsApp Message (messaggio WhatsApp in arrivo) come evento di trigger.

2. Scegli un numero WhatsApp

   In WhatsApp Number (numero WhatsApp), scegli il numero collegato i cui messaggi in arrivo devono avviare lo Zap. L'elenco mostra i numeri di telefono collegati nel tuo spazio di lavoro.

3. Testa il trigger

   Fai clic su Test trigger (testa il trigger). Zapier carica gli ultimi messaggi ricevuti su quel numero, così puoi mappare campi reali nei passaggi successivi. Se il numero non ha ancora messaggi, Zapier mostra invece un messaggio di esempio.

4. Attiva lo Zap

   Pubblica lo Zap. WbizTool si collega a Zapier automaticamente. Non devi aggiungere un URL webhook da nessuna parte in WbizTool.

Requisiti del trigger#

• Componente aggiuntivo Unibox. Il trigger aggiunge il tuo numero all'inbox Unibox (un numero inbox). Senza il componente aggiuntivo, l'attivazione dello Zap non riesce con Unibox add-on subscription required. Acquistalo su Fatturazione e Piani: $20/mese o $200/anno per numero WhatsApp usato in Unibox.
• Un numero inbox libero. Se il numero non è ancora nell'inbox, occupa uno dei numeri inbox consentiti dal tuo componente aggiuntivo. Un numero che è già nell'inbox non ne occupa un altro.
• Ruolo Owner o Editor. La chiave API deve appartenere a un Owner (proprietario) o a un Editor dello spazio di lavoro.
• Un numero WhatsApp collegato. Il numero deve restare collegato perché i nuovi messaggi vengano rilevati.

Come funziona il trigger con i tuoi numeri inbox#

• Solo i messaggi in arrivo avviano lo Zap. I messaggi inviati dal tuo numero no.
• Vengono inviati solo i messaggi ricevuti dopo che hai attivato lo Zap. I messaggi precedenti non vengono reinviati.
• Se il numero è già nell'inbox con un tuo URL webhook, il webhook di Zapier ne prende il posto finché lo Zap è attivo. Quando disattivi lo Zap, il tuo URL webhook, il secret e le impostazioni degli eventi vengono ripristinati.
• Se elimini uno Zap senza prima disattivarlo, WbizTool smette di inviargli messaggi non appena Zapier segnala che lo Zap non esiste più.
• In Numeri inbox, il webhook del numero mostra un badge Zapier. Se usi Ferma o Rimuovi sul numero lì, lo Zap resta attivo in Zapier ma non riceve messaggi, e la pagina ti avvisa prima. Per fermare lo Zap, disattivalo invece in Zapier. Per far arrivare di nuovo i messaggi dopo aver eliminato il listener, disattiva e riattiva lo Zap in Zapier.

Consulta Webhook dei messaggi in arrivo per sapere come funzionano i numeri inbox e i webhook.

Dati del trigger#

Ogni esecuzione dello Zap riceve un messaggio, come questo:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Alcuni messaggi includono campi aggiuntivi: message.media (nome, tipo, dimensione del file e url, un link di download valido per 7 giorni) per i contenuti multimediali, message.quoted_message_id per le risposte e group per i messaggi di gruppo. Per conservare un file, copialo entro quei 7 giorni (ad esempio con un passaggio di caricamento su Google Drive o Dropbox).

Esempio: registrare i messaggi in arrivo in Google Sheets#

1. Trigger: WbizTool, Incoming WhatsApp Message.
2. Azione: Google Sheets, Create Spreadsheet Row (crea riga del foglio di calcolo). Mappa Contact Phone (telefono del contatto) su una colonna Phone, Contact Name (nome del contatto) su una colonna Name e Message Content (contenuto del messaggio) su una colonna Message.

Inviare messaggi WhatsApp da uno Zap#

Aggiungi WbizTool come azione e scegli uno di questi eventi di azione:

In ogni azione, scegli il numero mittente in WhatsApp Number. Inserisci il numero di telefono del destinatario con il prefisso internazionale, ad esempio 919876543210, oppure metti il prefisso nel campo facoltativo Country Code (prefisso internazionale), ad esempio 91. Send WhatsApp Message on Group non ha telefono né prefisso: richiede invece il Group Name (nome del gruppo).

Quando WbizTool non può accettare un messaggio, il passaggio non riesce e Zapier mostra il motivo, ad esempio WbizTool: Invalid phone number o WbizTool: Not enough credits. Un passaggio riuscito significa che il messaggio è stato messo in coda. WbizTool lo invia poi dal tuo numero collegato.

Puoi anche chiamare direttamente l'API con Webhooks by Zapier:

Consulta Inviare messaggi WhatsApp da qualsiasi strumento di automazione per il significato di ogni campo, e Invia messaggio per tutte le opzioni.

Risoluzione dei problemi#