Vai al contenuto
Wbiztool

Integrazioni

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#

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 le credenziali richieste, cioè la tua chiave API e il Client ID, che trovi in 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.

Trigger per i nuovi messaggi WhatsApp#

Questo trigger avvia il tuo Zap ogni volta che il tuo numero WhatsApp riceve un messaggio. 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.

Requisiti del trigger#

  • Componente aggiuntivo Unibox. Senza di esso, 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 WhatsApp collegato. Il trigger è associato a uno dei tuoi numeri collegati.

Dati del trigger#

I messaggi reali hanno questo aspetto:

{
  "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",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

L'esempio che Zapier carica mentre configuri il trigger ha gli stessi campi message e contact (tranne message.forwarding_score), ma non webhook_id, whatsapp_client_id, whatsapp_phone né organisation. Questi campi compaiono per la mappatura solo dopo l'arrivo di un messaggio reale. L'esempio usa inoltre valori segnaposto: numeri di telefono con +, whatsapp_timestamp in millisecondi e status impostato su delivered.

CampoDescrizione
eventmessage_received per i messaggi in arrivo, message_sent per i messaggi inviati dal tuo numero.
message.typechat per il testo. I messaggi multimediali usano tipi come image, video, audio, ptt (nota vocale), document e sticker.
message.contentIl testo. Per i contenuti multimediali, un'etichetta breve come "📸 Image".
message.directionincoming oppure outgoing.
message.from / message.tofrom è sempre il contatto e to il tuo numero, anche per i messaggi in uscita. Usa message.direction per distinguerli.
contact.is_grouptrue quando il messaggio proviene da un gruppo. I messaggi di gruppo includono anche group.name.

Nei messaggi reali i numeri di telefono non hanno il +, message.whatsapp_timestamp è espresso in secondi e message.status di solito è pending. Alcuni messaggi includono campi aggiuntivi: message.media (nome, tipo e dimensione del file) per i contenuti multimediali, message.quoted_message_id per le risposte e group per i messaggi di gruppo. Consulta Listener webhook per altri esempi.

Esempio: registrare i messaggi in arrivo in Google Sheets#

  1. Trigger: Wbiztool, New WhatsApp Message.
  2. Filter by Zapier: prosegui solo se message.direction corrisponde esattamente a incoming.
  3. Azione: Google Sheets, Create Spreadsheet Row. Mappa contact.phone su una colonna Phone, contact.name su una colonna Name e message.content su una colonna Message.

Inviare messaggi WhatsApp da uno Zap#

Per inviare un messaggio, aggiungi Wbiztool come azione e scegli una delle azioni elencate nella pagina di Wbiztool su Zapier. Mappa il numero di telefono del destinatario e il testo del messaggio dai passaggi precedenti.

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

ImpostazioneValore
Action event (evento dell'azione)POST
URLhttps://wbiztool.com/api/v1/send_msg/
Payload type (tipo di payload)json oppure form
Data (dati)client_id, api_key, whatsapp_client, country_code, phone, msg

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#

ProblemaCosa controllare
Invalid API keyLa chiave è stata eliminata o digitata male. Creane una nuova in Impostazioni → Chiavi API e ricollega l'account.
Unibox add-on subscription requiredAcquista il componente aggiuntivo Unibox su Fatturazione e Piani, poi riattiva lo Zap.
No available WhatsApp clientsSul trigger non è stato impostato alcun numero, e tutti i numeri collegati hanno già un listener Unibox, oppure nessun numero è collegato. Questo include il listener che Wbiztool ha creato la prima volta che hai attivato questo Zap: disattivare uno Zap non lo elimina, quindi riattivarlo (ad esempio dopo aver modificato lo Zap) può non riuscire. Elimina un listener che non ti serve più, come quello, nei listener di Unibox, oppure collega un altro numero nelle Impostazioni WhatsApp.
Invalid WhatsApp clientIl numero impostato sul trigger al momento non è collegato. Ricollegalo nelle Impostazioni WhatsApp.
Lo Zap è attivo ma non si avviaIl tuo numero WhatsApp deve restare collegato perché i nuovi messaggi vengano rilevati. Controlla il listener nei listener di Unibox.
Zapier mostra un errore quando disattivi lo Zap, ad esempio Listener not found o un errore del serverÈ un problema noto. Controlla il listener nei listener di Unibox per vedere se il suo URL di webhook è stato rimosso.