Integrazioni
Pipedrive e WhatsApp
Collega Pipedrive al numero WhatsApp che hai collegato a WbizTool. Scrivi a una persona quando il suo deal passa a una fase, e registra come note in Pipedrive i messaggi WhatsApp che ti invia.
WbizTool non ha un'app Pipedrive. Colleghi i due servizi con uno strumento che forse usi già: le Automations di Pipedrive, Zapier, Make, n8n o Pabbly Connect. Questa pagina mostra ogni percorso passo dopo passo, con template pronti per Make e n8n.
Chi può farlo: chiunque abbia una chiave API di WbizTool può inviare messaggi. Per registrare i messaggi in arrivo servono il componente aggiuntivo Unibox ($20 al mese o $200 all'anno ai prezzi di listino USA per ogni numero inbox, su un piano a pagamento o a vita) e un Proprietario o un Editor che configuri il webhook. In Pipedrive, ti servono i permessi richiesti dal tuo percorso (vedi Scegli un percorso).
Cosa puoi fare#
| Direzione | Esempio | Cosa richiede in WbizTool |
|---|---|---|
| Pipedrive → WhatsApp | Un deal passa a Proposal sent: la persona riceve "Ciao Emma, la tua proposta è nella tua casella di posta." Viene aggiunta una nuova persona: riceve un messaggio di benvenuto. | Una chiave API e un numero WhatsApp collegato. |
| WhatsApp → Pipedrive | Un cliente scrive al tuo numero WhatsApp: il messaggio viene aggiunto come nota sulla persona con quel numero di telefono, e la persona viene creata se Pipedrive non ce l'ha. | Il componente aggiuntivo Unibox, e il numero aggiunto in Numeri inbox. |
I messaggi partono dal tuo numero WhatsApp, quindi valgono le regole di WhatsApp: scrivi a persone che si aspettano di sentirti, come i tuoi lead e clienti.
Prima di iniziare#
- Un numero WhatsApp collegato in Numeri WhatsApp, e il suo WhatsApp Client ID dalla stessa pagina.
- Il tuo Client ID e una chiave API da Impostazioni → Chiavi API. Crea una chiave solo per Pipedrive, così potrai eliminarla da sola in seguito. Vedi Chiavi API.
- Numeri di telefono con il prefisso internazionale in Pipedrive, come
+44 20 7946 0018. Vedi Numeri di telefono. - Per i messaggi in arrivo: il componente aggiuntivo Unibox con un numero inbox libero. Vedi Numeri inbox e webhook dei messaggi in arrivo.
Scegli un percorso#
| Percorso | Pipedrive → WhatsApp | WhatsApp → Pipedrive | Piano e permessi in Pipedrive |
|---|---|---|---|
| Pipedrive Automations | Sì, senza altri strumenti: l'azione webhook dell'automazione chiama l'API di WbizTool. | No | Le Automations e la loro azione webhook sono disponibili dal piano Growth in su. Solo gli admin globali creano l'automated webhook. |
| Zapier | Sì, con le azioni dell'app WbizTool. | Sì, con il trigger WbizTool Incoming WhatsApp Message. | Qualsiasi piano con accesso a Zapier. |
| Make | Sì, con il modulo HTTP di Make. Blueprint qui sotto. | Sì, con un webhook di Make. Blueprint qui sotto. | Qualsiasi piano. I blueprint usano i webhook di Pipedrive (tutti i piani) e un token API di Pipedrive. |
| n8n | Sì, con il Pipedrive Trigger e il nodo WbizTool. Workflow qui sotto. | Sì, con un nodo Webhook e il nodo Pipedrive. Workflow qui sotto. | Qualsiasi piano. n8n richiede un token API di Pipedrive. |
| Pabbly Connect | Sì, con la sua azione di richiesta API (Pabbly). | Sì, con il suo trigger webhook. | Qualsiasi piano. |
I Webhooks di Pipedrive (tutti i piani) inviano un corpo fisso che l'API di WbizTool non sa leggere, quindi non chiamano direttamente WbizTool. Avviano invece un workflow di Make, n8n o Pabbly, come nella ricetta per Make.
Numeri di telefono#
I due servizi scrivono i numeri in modo diverso. Tieni a mente queste regole quando mappi i campi:
- Per inviare, passa il telefono di Pipedrive così com'è. L'API Invia messaggio rimuove spazi, trattini, punti, parentesi e il
+. Un numero scritto con+, come+44 20 7946 0018, mantiene il suo prefisso internazionale. Un numero locale, come020 7946 0018, ha bisogno dicountry_code(qui44), altrimenti va al numero sbagliato o non viene inviato. - I messaggi in arrivo danno solo cifre. Nel webhook,
contact.phoneè il numero senza+, come442079460018. Cerca in Pipedrive con queste cifre, e aggiungi un+davanti quando crei una persona. - Pipedrive salva i telefoni come vengono scritti. La sua ricerca trova una persona in base alle cifre del suo numero, ma un numero salvato senza prefisso internazionale può sfuggire. Salva i numeri con il prefisso internazionale.
- Numeri nascosti e gruppi. A volte WhatsApp nasconde il numero del mittente: allora
contact.phoneè vuoto econtact.phone_hiddenètrue. Le chat di gruppo hannocontact.is_groupimpostato sutrue. Le ricette qui sotto li saltano entrambi.
Pipedrive Automations#
Le Automations di Pipedrive possono inviare una richiesta webhook come azione. Puntala all'API Invia messaggio di WbizTool e l'automazione invia da sola il messaggio WhatsApp, senza altri strumenti.
In Pipedrive: un piano Growth o superiore. Solo gli admin globali possono creare l'automated webhook; per creare l'automazione servono i permessi per usare le Automations.
Crea l'automated webhook
In Pipedrive, apri il menu dell'account e vai su Tools and apps → Webhooks. Fai clic su + Webhooks e scegli Automated webhook. Chiamalo "WbizTool" e inserisci
https://wbiztool.com/api/v1/come URL dell'endpoint. L'URL deve terminare con/, perché l'automazione aggiunge il percorso. Lascia vuota l'autenticazione: le credenziali di WbizTool vanno nel corpo.Crea l'automazione
Apri il menu dell'account in alto a destra, vai su Tools and apps → Automations e fai clic su + Automation. Seleziona Event trigger, scegli deal come elemento e imposta l'evento di trigger su Updated. Seleziona la fase del deal come campo da monitorare per le modifiche e fai clic su Apply trigger. Poi aggiungi una condizione con il nome della fase del deal, così l'automazione si esegue solo quando un deal passa a quella fase.
Per un messaggio di benvenuto, scegli invece person come elemento e l'evento Added.
Aggiungi l'azione webhook
Aggiungi l'azione webhook e scegli il webhook "WbizTool". Imposta il metodo su POST e aggiungi il percorso
send_msg/.Compila il corpo
Scegli il corpo Key-value e aggiungi i campi qui sotto. Usa il pulsante dei campi per inserire il telefono e il nome della persona.
Chiave Valore client_idIl tuo Client ID. api_keyLa tua chiave API. whatsapp_clientIl WhatsApp Client ID del numero da cui inviare. phoneIl telefono della persona di contatto, dal pulsante dei campi. country_codeSolo se i tuoi numeri in Pipedrive sono locali, senza prefisso internazionale: il prefisso, come 44.msgIl tuo messaggio, come Hi [person's first name], your proposal is in your inbox. Reply here if you have questions.Puoi anche scegliere Raw e scrivere gli stessi campi come JSON. Con Key-value non devi preoccuparti delle virgolette nei nomi.
Testalo
Salva l'automazione, attivala e sposta un deal di prova nella fase. Apri Automations → History e l'esecuzione: mostra il corpo inviato. WbizTool risponde
"status": 1quando il messaggio è in coda; un errore riceve come risposta HTTP400con unmessage, comeInvalid phone number.
Zapier#
Usa l'app WbizTool su Zapier con l'app Zapier di Pipedrive.
Un deal cambia fase: invia un messaggio WhatsApp#
Trigger: Pipedrive Updated Deal Stage
Scegli Pipedrive e il trigger Updated Deal Stage. Per un messaggio di benvenuto, usa invece New Person.
Filtro: solo la tua fase
Aggiungi Filter by Zapier e prosegui solo quando la fase del deal è quella che vuoi. Il trigger si attiva a ogni cambio di fase.
Trova il telefono della persona
Se i dati del trigger non contengono il telefono della persona del deal, aggiungi la ricerca Get Person di Pipedrive con l'ID della persona del deal.
Azione: WbizTool Send Text-Only WhatsApp Message
Scegli il numero che invia in WhatsApp Number. Mappa il telefono della persona su Phone Number, compila Country Code solo se i tuoi numeri in Pipedrive sono locali, e scrivi il Message con il nome della persona.
Testa e pubblica
Un passaggio riuscito significa che il messaggio è stato messo in coda. Se WbizTool non può accettarlo, il passaggio non riesce e indica il motivo, come
WbizTool: Invalid phone number.
Arriva un messaggio WhatsApp: aggiungi una nota in Pipedrive#
Richiede il componente aggiuntivo Unibox. Vedi Requisiti del trigger.
Trigger: WbizTool Incoming WhatsApp Message
Scegli il numero in WhatsApp Number. Quando pubblichi lo Zap, WbizTool aggiunge il numero all'inbox e invia a Zapier i messaggi che riceve.
Filtro: persone, non gruppi
Aggiungi Filter by Zapier: prosegui solo quando Is Group è false e Contact Phone Hidden è false.
Trova o crea la persona
Aggiungi Find or Create Person di Pipedrive: cerca le persone su un campo (scegli il campo del telefono, con Contact Phone) e crea una persona quando non ne trova nessuna. Per una nuova persona, imposta il nome su Contact Name e il telefono su
+seguito da Contact Phone.Crea la nota
Aggiungi Create Note di Pipedrive. Collegala alla persona del passaggio precedente e scrivi il contenuto, per esempio:
WhatsApp from Contact Name: Message Content, con Message Time se vuoi l'ora.
Make#
Non esiste un'app WbizTool su Make. I due blueprint usano i moduli Webhooks, HTTP e JSON di Make: il modulo HTTP chiama l'API di WbizTool e l'API di Pipedrive.
| Blueprint | Cosa fa |
|---|---|
| pipedrive-deal-stage-to-whatsapp.blueprint.json | Webhook di Pipedrive (un deal è cambiato) → filtro sulla tua fase → recupera la persona del deal → le invia un messaggio WhatsApp. |
| whatsapp-to-pipedrive-note.blueprint.json | Webhook dei messaggi in arrivo di WbizTool → trova la persona per telefono → aggiunge una nota, oppure prima crea la persona. |
I blueprint sono costruiti sui moduli generici di Make, quindi funzionano con qualsiasi piano Make e non richiedono una connessione Pipedrive in Make.
Ti servono il tuo token API di Pipedrive (in Pipedrive, Settings → Personal preferences → API) e l'indirizzo della tua azienda su Pipedrive, come yourcompany.pipedrive.com.
Un deal cambia fase: invia un messaggio WhatsApp#
Importa il blueprint
Crea uno scenario in Make, fai clic sui tre puntini nella barra in basso, scegli Import Blueprint e seleziona il file.
Crea il webhook
Apri il primo modulo (Webhooks → Custom webhook), fai clic su Add, salva e copia l'indirizzo che mostra Make.
Compila i segnaposto
- Nel filtro dopo il webhook, sostituisci
YOUR_STAGE_IDcon l'ID della tua fase. Per trovarlo, sposta una volta un deal di prova nella fase e leggidata.stage_idnell'output del webhook. - Nel modulo Get the person, sostituisci
YOUR_COMPANYeYOUR_PIPEDRIVE_API_TOKEN. - Nel modulo Send WhatsApp, sostituisci
YOUR_WBIZTOOL_API_KEYnell'headerAuthorization,YOUR_WHATSAPP_CLIENT_IDnel corpo, e il testo del messaggio.
- Nel filtro dopo il webhook, sostituisci
Punta il webhook di Pipedrive su Make
In Pipedrive, vai su Settings → Tools and apps → Webhooks e crea un webhook: event action change (updated nelle versioni precedenti), event object deal, e l'indirizzo di Make come URL dell'endpoint.
Attivalo
Attiva lo scenario e sposta un deal di prova nella fase. L'output del modulo HTTP mostra la risposta di WbizTool:
"status": 1significa che il messaggio è stato messo in coda.
Per costruirlo invece con i moduli Pipedrive di Make, usa Watch New Events (o un Custom webhook come sopra), Get a Person e il modulo HTTP con la stessa richiesta del modulo Send WhatsApp del blueprint. I moduli Pipedrive di Make restituiscono la persona di un deal solo come ID, quindi ti serve Get a Person per il telefono.
Arriva un messaggio WhatsApp: aggiungi una nota in Pipedrive#
Importa il blueprint
Importa
whatsapp-to-pipedrive-note.blueprint.jsonin un nuovo scenario.Crea il webhook
Apri Webhooks → Custom webhook, fai clic su Add, salva e copia l'indirizzo.
Compila i segnaposto
Sostituisci
YOUR_COMPANYeYOUR_PIPEDRIVE_API_TOKENnei quattro moduli HTTP di Pipedrive (ricerca, creazione della persona e le due note).Aggiungi l'indirizzo in WbizTool
In Numeri inbox, aggiungi il tuo numero all'inbox, oppure apri Impostazioni webhook nella sua scheda. Incolla l'indirizzo di Make in URL del webhook, lascia spuntato solo Messaggi ricevuti e salva.
Attivalo e testalo
Attiva lo scenario e invia un messaggio al tuo numero WhatsApp da un altro telefono. Entro un paio di minuti la nota compare sulla persona in Pipedrive.
Il blueprint salta le chat di gruppo, i numeri nascosti e i messaggi inviati. Per costruirlo invece con i moduli Pipedrive di Make, usa Search Persons sul campo del telefono, un router, Create a Person e Create a Note.
n8n#
Usa i nodi Pipedrive Trigger e Pipedrive di n8n con il community node di WbizTool (n8n-nodes-wbiztool). Installa prima il community node.
| Workflow | Cosa fa |
|---|---|
| pipedrive-deal-stage-to-whatsapp.n8n.json | Pipedrive Trigger (deal cambiato) → If il deal è passato alla tua fase → Pipedrive Get persona → WbizTool Send Message. |
| whatsapp-to-pipedrive-note.n8n.json | Webhook (il messaggio in arrivo di WbizTool) → If è il messaggio di una persona → Pipedrive Search persona per telefono → Create una nota, creando prima la persona se non ne trova nessuna. |
Importa il workflow
In n8n, crea un workflow, apri il menu ⋯ e scegli Import from File. Puoi anche incollare il contenuto del file sul canvas.
Aggiungi le credenziali
Apri ogni nodo Pipedrive e crea una credenziale Pipedrive API con il tuo token API di Pipedrive (Settings → Personal preferences → API in Pipedrive). Apri il nodo WbizTool Send Message e scegli la tua credenziale WbizTool API (Client ID, chiave API e il WhatsApp Client ID da cui inviare).
Imposta la fase e il messaggio
Nel primo workflow, sostituisci
YOUR_STAGE_IDnel nodo If con l'ID della tua fase (sposta un deal di prova nella fase e leggidata.stage_idnell'output del trigger), e modifica il Message Text. Lascia vuoto Country Code quando i tuoi numeri in Pipedrive includono il prefisso internazionale.Attiva
Attiva il workflow. Il Pipedrive Trigger crea da solo il suo webhook in Pipedrive.
Per il secondo workflow, copia la Production URL del nodo Webhook e incollala in URL del webhook in Numeri inbox, con solo Messaggi ricevuti spuntato.
I nodi Pipedrive in questi file sono la versione 2 del nodo Pipedrive di n8n. Se il tuo n8n è più vecchio e li mostra come sconosciuti, aggiorna n8n oppure sostituiscili con il nodo Pipedrive della tua versione, con le stesse impostazioni.
Pabbly Connect#
Non esiste un'app WbizTool su Pabbly Connect: usa i suoi moduli generici.
- Pipedrive → WhatsApp: avvia il workflow con il trigger Pipedrive di Pabbly, oppure con il suo trigger webhook alimentato da un webhook di Pipedrive. Poi aggiungi API (Pabbly) con Execute API Request verso
https://wbiztool.com/api/v1/send_msg/, configurato come in Pabbly Connect, e mappa il telefono e il nome della persona. - WhatsApp → Pipedrive: inizia con il trigger webhook di Pabbly, incolla il suo indirizzo in URL del webhook in Numeri inbox, e invia un messaggio di prova al tuo numero così Pabbly vede i campi. Poi aggiungi i passaggi Pipedrive di Pabbly: trova la persona con
contact.phone, creala se serve, e aggiungi una nota conmessage.content.
Cosa arriva da WhatsApp#
Ogni messaggio in arrivo è una richiesta JSON. I campi usati dalle ricette:
| Campo | Esempio | A cosa serve |
|---|---|---|
event | message_received | Salta message_sent se hai spuntato anche Messaggi inviati. |
contact.phone | 12125550120 | La ricerca in Pipedrive, e il telefono della nuova persona (con +). |
contact.name | Emma Thompson | Il nome della nuova persona. Può essere vuoto: in quel caso usa il telefono. |
contact.is_group, contact.phone_hidden | false | Saltare le chat di gruppo e i numeri nascosti. |
message.content | Can I add a gift note to it? | La nota. Foto e file arrivano come etichetta, come 📸 Image. |
message.timestamp | 2026-10-15T10:30:04+00:00 | Quando è stato inviato, in UTC. |
Tutti i campi, la firma e i nuovi tentativi sono in Numeri inbox e webhook dei messaggi in arrivo.
Risoluzione dei problemi#
| Problema | Cosa controllare |
|---|---|
Auth Error: invalid api key | La chiave è stata eliminata o scritta male, oppure non appartiene allo spazio di lavoro del Client ID. In Make e n8n, controlla l'header Authorization: Bearer o la credenziale. |
Invalid phone number | Il campo del telefono era vuoto o conteneva altro, come un nome. Controlla che la persona abbia un telefono in Pipedrive e di aver mappato il campo del telefono. |
| Il messaggio è andato al numero sbagliato | In Pipedrive il numero è senza prefisso internazionale. Salvalo con il prefisso, come +44 20 7946 0018, oppure invia country_code. |
Invalid JSON format: … | Un corpo JSON grezzo si è rotto, spesso per una virgoletta o un a capo in un campo mappato. Nelle Automations di Pipedrive usa il corpo Key-value; in Make mantieni i moduli JSON del blueprint. |
| L'esecuzione dell'automazione dice "Maximum retry limit reached" | WbizTool ha risposto con un errore. Apri l'esecuzione in Automations → History e leggi il corpo inviato. |
| Non arriva nessun webhook da WbizTool | Il numero deve mostrare In sincronizzazione in Numeri inbox, con Messaggi ricevuti spuntato, con il componente aggiuntivo Unibox. Make, n8n e Pabbly devono rispondere 2xx entro 8 secondi: attiva lo scenario o il workflow. I messaggi vengono inviati entro un paio di minuti. |
| Il tuo server o firewall rifiuta il webhook di WbizTool | Consenti le richieste con lo User-Agent WbizTool-Webhooks/1. Alcuni hosting bloccano i client sconosciuti con 403. |
| La nota viene aggiunta ma la persona non viene trovata, quindi viene creata una persona doppia | Il numero della persona in Pipedrive è salvato in un'altra forma, per esempio senza prefisso internazionale. Salvalo con il prefisso, poi unisci le due persone in Pipedrive. |
| Non succede nulla per un messaggio di gruppo | È voluto: le ricette saltano le chat di gruppo e i numeri nascosti, che non hanno un telefono da abbinare. |
Pagine correlate#
- API Invia messaggio: tutti i campi che puoi inviare
- Numeri inbox e webhook dei messaggi in arrivo
- Chiavi API
- Integrazione con Zapier
- Integrazione con n8n
- Inviare messaggi WhatsApp da qualsiasi strumento di automazione: Make, Pabbly Connect e altri

