Integrazione WhatsApp CRM: 3 modi per collegare e sincronizzare
Integrazione WhatsApp CRM: connettori, middleware o API e webhook, con flusso dei dati, mappatura dei campi, sincronizzazione del consenso e checklist.
Di OmniChannels.ai Editorial Team · Revisione di BroadNet Messaging Solutions Team
Integrazione
Risposta breve
Un'integrazione WhatsApp CRM collega la WhatsApp Business API al vostro CRM, così messaggi in entrata, stati di consegna e invii in uscita sono associati alle schede dei contatti. Si può costruire in tre modi: un connettore già pronto, middleware o strumenti di automazione, oppure API e webhook diretti. Scegliete in base alla logica richiesta, a chi la mantiene e a quanto rigorosamente dovete sincronizzare il consenso.
In questa pagina
- Che cos'è un'integrazione WhatsApp CRM?
- Che cosa serve prima di iniziare?
- Quali sono i tre modi per integrare WhatsApp con un CRM?
- Come scorrono i dati? Il quadro passo dopo passo
- Quali campi mappare tra WhatsApp e CRM?
- Come si sincronizza il consenso tra WhatsApp e CRM?
- Come rendere affidabile l'integrazione?
- Quali CRM e strumenti documentiamo?
- Gli agenti IA possono lavorare con il vostro CRM e WhatsApp?
- Esempio pratico: un'agenzia immobiliare a Gedda
- Quali errori evitare?
- Come vi aiuta OmniChannels.ai
Punti chiave
- Integrare WhatsApp e CRM significa gestire due flussi di dati: il CRM attiva i messaggi in uscita tramite API, mentre messaggi in entrata e stati di consegna tornano via webhook e aggiornano il contatto.
- I tre approcci sono un connettore già pronto (il più rapido, il meno flessibile), middleware o strumenti di automazione (equilibrato) e API più webhook diretti (massimo controllo, servono sviluppatori).
- Associate le persone tramite un numero di telefono normalizzato in formato E.164, mai tramite il nome, e salvate fonte e data/ora del consenso come campi del CRM.
- Gli eventi webhook possono arrivare due volte o in ordine sparso: conservate l'evento grezzo, confermate subito la ricezione ed elaborate in modo asincrono con deduplicazione.
- I messaggi avviati dall'azienda fuori dalla finestra di assistenza clienti di 24 ore richiedono template approvati, quindi il CRM deve tracciare l'orario dell'ultimo messaggio in entrata.
Questa guida è pensata per sales operations, amministratori CRM e sviluppatori che vogliono che conversazioni e messaggi WhatsApp vivano dentro il CRM. Spiega i tre modi per collegarli, i dati che devono viaggiare in ciascuna direzione e le regole su consenso e affidabilità che la maggior parte dei progetti trascura.
Che cos'è un'integrazione WhatsApp CRM?
Un'integrazione WhatsApp CRM è un collegamento tra la WhatsApp Business API e un CRM, in modo che messaggi, stati di consegna e consenso siano associati al contatto, al lead o al ticket giusto.
Prevede sempre due flussi:
- In uscita: un evento nel CRM (l'invio di un modulo, una fase della trattativa, una data) attiva un messaggio WhatsApp tramite API.
- In entrata: le risposte dei clienti e gli stati di consegna vengono rimandati via webhook, associati a un contatto e scritti nel CRM.
Non confondetela con un widget laterale che mostra le chat. Il valore deriva dai due flussi e da un'associazione pulita dei contatti. Per i dettagli sul funzionamento dei webhook, leggete come collegare un CRM a una inbox omnicanale con i webhook.
Che cosa serve prima di iniziare?
Servono un numero WhatsApp Business API, template approvati per i messaggi avviati dall'azienda, un CRM in grado di chiamare un'API o eseguire webhook e un processo documentato per il consenso.
Checklist:
- Un numero registrato sulla WhatsApp Business Platform (non l'app Business gratuita; vedete API e app Business a confronto). Vedete come configurare la WhatsApp Business API e la checklist di preparazione.
- Template approvati per i messaggi che il CRM attiverà, nella categoria corretta.
- Numeri di telefono salvati in formato E.164 (prefisso internazionale, senza spazi né zeri iniziali).
- Una registrazione dell'opt-in per ogni contatto.
- Un responsabile dell'integrazione e un canale di allerta per i guasti.
Quali sono i tre modi per integrare WhatsApp con un CRM?
Potete usare un connettore già pronto, middleware o strumenti di automazione, oppure API e webhook diretti. Scambiano velocità con controllo.
| Connettore già pronto | Middleware o strumento di automazione | API e webhook diretti | |
|---|---|---|---|
| Che cos'è | Un'app pronta o una funzione integrata che collega un provider di messaggistica al CRM | Uno strumento visuale di workflow (per esempio Zapier, Make o n8n) tra CRM e API | Codice vostro che chiama l'API REST e riceve i webhook |
| Rapidità di avvio | La più alta | Alta | La più bassa |
| Flessibilità | Limitata a ciò che il connettore espone | Alta per i flussi tipici | La più alta |
| Chi lo mantiene | Il fornitore del connettore | Un analista di business | I vostri sviluppatori |
| Limite tipico | Mappatura dei campi fissa; potrebbe non coprire ogni canale o oggetto personalizzato | Limiti di attività, latenza e limiti per esecuzione dello strumento | Richiede tempo di sviluppo, monitoraggio e test |
| Ideale per | Esigenze standard su un CRM supportato | Team senza sviluppatori; prototipi | Logiche complesse, volumi elevati, regole di consenso rigorose |
Diffidate di qualsiasi affermazione secondo cui un connettore «funziona e basta». Chiedete che cosa fa quando un webhook arriva due volte, che cosa fa quando un numero corrisponde a due contatti e come viene verificato il consenso.
Una nota sul nostro approccio: OmniChannels.ai si integra tramite API REST, webhook e strumenti di automazione, e le nostre pagine di integrazione dichiarano apertamente che per questi CRM non esiste un'app su marketplace.
Quale approccio scegliere?
- Se il vostro CRM ha un connettore che copre il vostro caso d'uso e i campi di consenso, partite da lì.
- Se vi servono attivazioni e aggiornamenti dei campi ma non codice personalizzato, usate un middleware.
- Se vi servono logiche personalizzate, volumi elevati o verificabilità, usate direttamente l'API, magari con un middleware come tappa intermedia.
- Qualunque scelta facciate, testate prima con numeri verificati vostri.
Come scorrono i dati? Il quadro passo dopo passo
In parole, il flusso funziona così.
In uscita
- Parte un workflow del CRM (per esempio, un nuovo lead con consenso).
- Il workflow o il middleware controlla il consenso e l'orario dell'ultimo messaggio in entrata.
- Chiama l'API di messaggistica con il numero E.164 del contatto e un template approvato, oppure con un messaggio libero se la finestra di 24 ore è aperta.
- L'API restituisce un ID messaggio, che salvate nella cronologia del contatto.
In entrata e stati 5. WhatsApp consegna la risposta del cliente alla piattaforma, che invia un evento al vostro URL webhook. 6. Il vostro endpoint conserva il corpo grezzo, risponde con un 2xx e mette l'evento in coda. 7. Un worker associa il numero del mittente a un contatto, ne crea uno se il processo lo consente e registra il messaggio. 8. Gli eventi di stato (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED nel nostro formato normalizzato) aggiornano il messaggio salvato, senza mai far tornare indietro uno stato. 9. Scattano le regole: assegnare un responsabile, creare un'attività, spostare la fase di una trattativa o etichettare il contatto.
Meta descrive il webhook dei messaggi WhatsApp come comprensivo dei messaggi degli utenti e dello stato dei messaggi che avete inviato. La nostra documentazione sui webhook tratta gli stati di consegna, i nuovi tentativi e che cosa fare quando mancano degli eventi. I campi del payload variano per canale, quindi registrate gli eventi grezzi e fate la mappatura partendo da esempi reali del vostro account.
Quali campi mappare tra WhatsApp e CRM?
Mappate un piccolo insieme di identificativi stabili e campi di stato, e tenete il contenuto dei messaggi fuori dal CRM se non vi serve.
| Campo CRM (suggerito) | Origine | Direzione | Note |
|---|---|---|---|
| Cellulare (E.164) | CRM o modulo | CRM → API | Normalizzate prima dell'invio; validate con lookup se serve |
| Consenso WhatsApp (sì/no/revocato) | Raccolta dell'opt-in | Il CRM è la fonte di verità | Controllate prima di ogni invio di marketing |
| Fonte e data/ora del consenso | Modulo, QR, chat o casella da spuntare | CRM | Conservate il testo mostrato al cliente |
| Lingua preferita | CRM | CRM → API | Determina la lingua del template |
| Orario dell'ultimo messaggio in entrata | Webhook | API → CRM | Indica se la finestra di 24 ore è aperta |
| Stato dell'ultimo messaggio | Webhook | API → CRM | Aggiornamenti solo in avanti |
| ID messaggio | Risposta dell'API | API → CRM | Serve ad associare gli stati alle voci della cronologia |
| Link alla conversazione | Inbox | API → CRM | Permette a un commerciale di aprire il thread con un clic |
| Responsabile o operatore assegnato | CRM o inbox | Entrambe | Definite quale sistema prevale in caso di conflitto |
| Fase del ciclo di vita o tag | CRM | CRM → inbox | Permette agli operatori di vedere il contesto della trattativa |
Create questi campi come proprietà personalizzate fin dall'inizio; cambiare il tipo dei campi dopo il lancio è complicato.
Come si sincronizza il consenso tra WhatsApp e CRM?
Considerate il CRM come sistema di riferimento per l'opt-in e controllatelo prima di ogni messaggio di marketing avviato dall'azienda. La policy business di WhatsApp consente di contattare le persone solo se vi hanno dato il loro numero e hanno accettato di ricevere vostre comunicazioni, e prevede che rispettiate le richieste di blocco, interruzione o disiscrizione.
Un insieme di regole praticabile:
- Raccogliete il consenso con una dichiarazione chiara di che cosa riceverà la persona e su quale canale.
- Salvate il consenso per canale, con fonte, data/ora e testo.
- Aggiornate il consenso subito dopo un messaggio di disiscrizione o un blocco.
- Fate in modo che il passaggio di invio legga il campo, non un elenco in cache.
- Tenete separate le conversazioni di servizio (risposte al messaggio di un cliente) dagli invii di marketing.
Leggete opt-in e consenso per le campagne multicanale e generate il testo con il generatore di consenso opt-in.
Come rendere affidabile l'integrazione?
Confermate rapidamente i webhook, salvate prima di elaborare e rendete l'elaborazione idempotente.
- Salvare, confermare, poi elaborare. Le chiamate lente al CRM dentro il gestore causano nuovi tentativi e duplicati.
- Deduplicate per ID messaggio; trattate lo stesso evento ricevuto due volte come un'operazione nulla.
- Aspettatevi eventi fuori ordine. Un SENT in ritardo non deve sovrascrivere DELIVERED.
- Limitate la frequenza delle chiamate al CRM e rallentate in caso di errori.
- Associate i contatti in sicurezza. Normalizzate i numeri, gestite deliberatamente due contatti con lo stesso numero e non unite mai in base al solo nome.
- Non rinviate mai da un gestore di webhook. Decidete i nuovi tentativi in un job separato dopo aver controllato lo stato.
- Proteggete l'endpoint. Usate HTTPS, un percorso non indovinabile e la validazione della forma del corpo. Meta documenta mTLS per i propri webhook; per i nostri, vedete la pagina sui webhook.
- Monitorate. Allertate sui fallimenti dei webhook, sulla profondità della coda e su un calo degli eventi in entrata.
Quali CRM e strumenti documentiamo?
Documentiamo schemi per diversi sistemi nelle nostre pagine di integrazione. Nessuna descrive un'app su marketplace; ciascuna spiega come usare l'API REST e i webhook con quel prodotto.
| Sistema | Schema tipico | Pagina |
|---|---|---|
| HubSpot | Codice personalizzato del workflow o azione webhook, oppure strumento di automazione | HubSpot |
| Salesforce | Chiamata HTTP da Flow o chiamata Apex con Named Credential | Salesforce |
| Zoho CRM | Webhook del workflow o funzione Deluge | Zoho CRM |
| Microsoft Dynamics 365 | Flusso Power Automate | Dynamics 365 |
| Zendesk | Webhook attivato da trigger; strumento di automazione per le risposte | Zendesk |
| Freshdesk | Webhook da regola di automazione; strumento di automazione per le risposte | Freshdesk |
| Strumenti di automazione | Zapier, Make, n8n | Zapier, Make, n8n |
Quali azioni sono disponibili dentro un CRM dipende dal vostro piano con quel fornitore, quindi verificate nella sua documentazione.
Gli agenti IA possono lavorare con il vostro CRM e WhatsApp?
Sì, se date all'agente strumenti controllati. Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti IA di chiamare strumenti esterni. Il nostro server MCP espone l'API di messaggistica (invio, template, rapporti di consegna) ai client MCP con i permessi del token che fornite; leggere o aggiornare i record del CRM richiede un connettore che controllate voi. Cominciate con ricerche in sola lettura, aggiungete le azioni di scrittura una alla volta e registrate tutto. Vedete la guida al server MCP per WhatsApp e gli agenti IA per il servizio clienti.
Esempio pratico: un'agenzia immobiliare a Gedda
«Red Sea Homes», un'agenzia sintetica, vuole che ogni richiesta su un immobile riceva una risposta WhatsApp e che ogni conversazione compaia nella scheda del lead.
- Una richiesta dal portale crea un lead con il telefono in E.164 e una casella di consenso dal modulo.
- Un workflow controlla il consenso, poi invia un template di utilità approvato che conferma la richiesta e salva l'ID del messaggio.
- Il cliente risponde; il webhook aggiorna «orario ultimo messaggio in entrata» e assegna il responsabile del lead.
- Il responsabile risponde per 24 ore dalla inbox con messaggi liberi. Dopo un silenzio, il follow-up successivo è un template approvato, categorizzato e con consenso.
- Il passaggio alla fase «visita fissata» invia un template di promemoria il giorno prima.
- Ogni settimana il team esamina gli invii falliti e i numeri non corrispondenti.
Per il lato messaggistica, vedete il follow-up dei lead immobiliari su WhatsApp.
Quali errori evitare?
- Associare i contatti per nome o con numeri non formattati.
- Saltare il campo del consenso e affidarsi alla memoria.
- Elaborare dentro il gestore del webhook e poi andare in timeout.
- Inviare contenuti di marketing dentro un template categorizzato come utilità; la categoria la decide Meta.
- Dimenticare che fuori dalla finestra di 24 ore si possono inviare solo template.
- Lasciare che entrambi i sistemi modifichino lo stesso campo senza una regola su chi prevale.
- Nessun allarme, così un webhook rotto passa inosservato per settimane.
Come vi aiuta OmniChannels.ai
OmniChannels.ai, sviluppata da BroadNet Technologies, offre un'API REST/JSON, webhook per gli stati di consegna, la Omni Inbox per le conversazioni degli operatori e un server MCP per gli agenti IA. BroadNet è un Meta Business Solution Provider ufficiale e il nostro team gestisce con voi attivazione (onboarding) e registrazioni WhatsApp. Gli sviluppatori possono partire dalla documentazione API e dalla guida all'API WhatsApp; l'accesso di prova è riservato ai vostri numeri verificati e non esiste una registrazione self-service immediata.
Domande frequenti
Che cos'è un'integrazione WhatsApp CRM?
È un collegamento tra la WhatsApp Business API e un CRM, in modo che conversazioni, stati dei messaggi e consenso siano legati al contatto o al lead giusto. Di solito il CRM attiva i messaggi in uscita dai workflow, mentre i webhook rimandano indietro messaggi in entrata e stati di consegna per aggiornare schede e cronologie. La sola app WhatsApp Business non ha un collegamento API di questo tipo.
Posso collegare l'app WhatsApp Business al mio CRM?
In generale no. Le integrazioni CRM funzionano tramite la WhatsApp Business Platform, l'API usata dai business solution provider, non tramite l'app Business scaricabile gratuitamente. Registrate un numero sulla piattaforma, il che cambia il modo in cui quel numero viene usato. Leggete il nostro confronto tra API e app Business prima di spostare un numero che gli operatori usano oggi su un telefono.
Quali CRM si possono collegare a WhatsApp?
Qualsiasi CRM in grado di chiamare un'API HTTP o di eseguire webhook può collegarsi alla WhatsApp Business API, direttamente o tramite uno strumento di automazione. Nelle nostre pagine di integrazione documentiamo gli schemi per HubSpot, Salesforce, Zoho CRM, Microsoft Dynamics 365, Zendesk e Freshdesk. La disponibilità delle azioni integrate dipende dal vostro abbonamento al CRM, quindi controllate il vostro piano.
Mi serve uno sviluppatore per integrare WhatsApp e CRM?
Non sempre. Attivazioni semplici, come l'invio di un template al cambio di fase di una trattativa, possono girare in uno strumento di automazione o in un workflow del CRM. Serve uno sviluppatore per logiche personalizzate sui campi, sincronizzazione bidirezionale con deduplicazione, controlli del consenso, nuovi tentativi e qualsiasi cosa debba scalare. Prevedete comunque un monitoraggio, perché le integrazioni falliscono in silenzio senza avvisi.
Come gestisco opt-in e consenso nel CRM?
Salvate un campo di consenso per canale, insieme a fonte, data/ora e testo mostrato. Controllatelo prima di ogni invio di marketing e aggiornatelo subito quando qualcuno si disiscrive. La policy business di WhatsApp consente di contattare le persone solo se vi hanno dato il loro numero e hanno dato l'opt-in, quindi il CRM deve essere il sistema di riferimento per quello stato.
Un agente IA può leggere e aggiornare il mio CRM da WhatsApp?
Un agente IA può usare strumenti per cercare e aggiornare record se lo collegate ai vostri sistemi, per esempio tramite il Model Context Protocol (MCP). Assegnategli permessi ristretti, registrate ogni azione e mantenete un percorso verso un operatore umano. Il nostro server MCP espone l'API di messaggistica ai client MCP; le azioni sul CRM richiedono un connettore che controllate voi.
Fonti
Continuate a leggere
Altre guideIntegrazione
Guida ai webhook WhatsApp: eventi, sicurezza e nuovi tentativi
Come funzionano i webhook WhatsApp: eventi di messaggi e stati, gestore affidabile, firma di Meta, nuovi tentativi, idempotenza e recupero degli eventi persi.
10 min di lettura
Integrazione
Inviare un messaggio WhatsApp via API: cURL, Node, Python, PHP
Come inviare un messaggio WhatsApp con una API: esempi in cURL, Node.js, Python e PHP per template e messaggi di sessione, con stati ed errori.
10 min di lettura
WhatsApp
Codici di errore WhatsApp Cloud API: significato e soluzioni
I codici di errore più comuni della WhatsApp Cloud API, da 131047 e 131026 a 132001 e 130429: che cosa significano, come risolverli e quando non riprovare.
8 min di lettura
