Torna alle notizie per sviluppatori

Integrazione della piattaforma WhatsApp Business con HubSpot

HubSpot è una piattaforma CRM che consente alle organizzazioni di promuovere, vendere e supportare i propri prodotti o servizi in modo più efficace.

La piattaforma WhatsApp Business consente alle aziende di utilizzare l'API Cloud, ospitata da Meta, per comunicare direttamente con i propri clienti dal CRM attraverso le integrazioni di WhatsApp. Ciò fornisce un facile accesso alle funzioni di messaggistica e consente l'integrazione diretta con la maggior parte degli stack tecnologici esistenti.

Qui daremo un'occhiata a come configurare questo tipo di integrazione con HubSpot e creare un flusso di lavoro all'interno del CRM per rispondere automaticamente ai messaggi in base a eventi e regole personalizzate sulla piattaforma HubSpot da WhatsApp.

Prerequisiti

Per completare questo tutorial avrai bisogno di:

Questo articolo presuppone che tu abbia familiarità con la piattaforma WhatsApp Business, Meta for Developers e HubSpot.

Invio di messaggi

Il primo passaggio è la configurazione degli account. Per eseguire questa operazione:

  1. Crea un account sviluppatore di Facebook o effettua l'accesso se ne hai già uno.

  2. Completa il passaggio "Configurazione delle risorse per sviluppatori e dell'accesso alla piattaforma" riportato nella documentazione introduttiva ufficiale e invia un messaggio di testo.

  3. Aggiungi il tuo numero di telefono alla configurazione dell'app API Cloud.

Ricezione di messaggi con un'app di esempio

Dovremo configurare un webhook e il relativo URL di iscrizione con un endpoint per il test dei webhook. Per questa operazione useremo l'app di esempio menzionata sopra.

Clicca sul pulsante Remix to Edit (Modifica con remix) in alto a destra per modificare i dettagli di configurazione.

Apri il file .env e incolla il tuo token d'accesso dell'API Cloud nel campo WHATSAPP_TOKEN. Nel campo VERIFY_TOKEN puoi immettere qualsiasi stringa, ma ricorda di tenerla a portata di mano perché ci servirà più avanti.

Configurazione del webhook dell'API Cloud

A questo punto, configura il webhook per l'API in modo da consentire le iscrizioni agli aggiornamenti o le risposte alle modifiche degli eventi iniziando dalla dashboard gestione app di Meta for Developers per la tua app. Clicca sulla barra di navigazione per WhatsApp. Quindi, in Primi passi, clicca su Configurazione e poi su Modifica.

Compila i campi URL di callback e Verifica token nella finestra di dialogo Modifica l'URL del webhook di callback. L'URL di callback sarà https://<<PROJECT NAME>>.glitch.me. Sostituisci il nome del progetto con il nome del tuo progetto (ad es., https://defiant-standing-mirror.glitch.me). Quindi, verifica che l'URL corrisponda a quello indicato in alto.

Clicca su Verifica e salva. Per maggiori dettagli sulla configurazione dei webhook di WhatsApp, dai un'occhiata alla guida per sviluppatori.

Schermata di modifica dell'URL webhook di callback

Ora puoi inviare notifiche di test all'endpoint.

Nella stessa pagina, sotto il pulsante Modifica, clicca su Campi dei webhook e poi su Gestisci, quindi attiva l'iscrizione agli eventi che desideri seguire attraverso l'endpoint. Ora, clicca su Test per inviare un messaggio di notifica al numero di telefono del destinatario configurato in precedenza.

Schermata dei campi dei webhook

Per verificare che l'app sia in esecuzione e in ascolto degli eventi, vai a Glitch, clicca su Registri e visualizza i registri per l'evento selezionato.

Schermata di visualizzazione dei registri in Glitch

Configurazione del CRM di HubSpot

Ora, puoi configurare il CRM di HubSpot in modo da inviare automaticamente messaggi WhatsApp ai clienti le cui informazioni di contatto includono un numero di telefono.

Vai alla piattaforma HubSpot e accedi al tuo account sviluppatore o creane uno. L'account sviluppatore offre un periodo di accesso gratuito di 90 giorni di tutte le funzioni per le aziende di HubSpot, incluse le funzioni di marketing, vendita, assistenza e CMS, per consentire di provare l'API e gli strumenti HubSpot.

Dopo aver configurato il tuo account sviluppatore, clicca su Gestisci account test.

Accesso effettuato con account sviluppatore sul CRM di HubSpot

Seleziona Create app test account (Crea un account test dell'app), assegnagli il nome demo_whatsapp_integration (o qualsiasi altro nome tu preferisca) e clicca su Crea.

Schermata di creazione di un account test dell'app

Clicca sull'account test dell'app appena creato e accedi alla sua dashboard. Quindi clicca su Contatti in alto a sinistra della barra di navigazione. Vedrai due contatti demo. Puoi rimuoverli e aggiungere un nuovo contatto che includa un numero di telefono di prova da usare per il test di WhatsApp.

Dashboard del nuovo account test dell'app

Collegamento di WhatsApp al CRM di HubSpot

A questo punto occorre installare un'integrazione di WhatsApp con il CRM di HubSpot. Come prima cosa, vai a Impostazioni in HubSpot. In Configurazione account, clicca su Integrazioni e poi su App collegate.

Schermata App collegate

Seleziona Visit App Marketplace (Visita il Marketplace delle app). Usa il campo Cerca per cercare l'app WhatsApp. Clicca su WhatHub: WhatsApp Integration (WhatHub: integrazione WhatsApp).

Marketplace delle app

Seleziona l'account demo_whatsapp_integration e clicca su Scegli account. Comparirà un'icona di WhatsApp sulla pagina di contatto accanto alle altre opzioni di contatto. Cliccaci per iniziare a inviare messaggi dal CRM di HubSpot. Puoi usare sia i messaggi personalizzati sia i modelli predefiniti.

Messaggio personalizzato di WhatsApp

Comparirà una lista di messaggi con il relativo stato nella tab Attività.

Configurazione di un flusso di lavoro automatizzato

Procediamo ora all'integrazione in un flusso di lavoro attivato da un evento nel CRM. Per farlo, configuriamo un flusso di lavoro personalizzato dalla dashboard di HubSpot. Clicca su Automazione nella barra di navigazione e poi su Flussi di lavoro per aprire la dashboard del flusso di lavoro.

Clicca sul flusso di lavoro Crea e seleziona l'opzione Da zero. Ora, clicca su Contact-based (Basato sui contatti) e poi su Avanti.

Schermata di ritorno ai flussi di lavoro

Clicca su Set up triggers (Configura trigger) e seleziona il messaggio WhatsApp inviato dall'opzione dell'evento di integrazione del portale di HubSpot.

Schermata di configurazione trigger

Seleziona il tipo di filtro Messaggio inviato, imposta il trigger del flusso di lavoro su "is equal to any of" (è uguale a uno di) e specifica il valore Buy item (Acquista articolo). Per ultimo, clicca sul filtro Applica e poi su Salva.

Clicca sull'icona + e aggiungi un'altra azione. Nella lista Scegli un'azione, clicca su Crea attività.

Schermata di selezione di un'azione

Chiamala "Attività di test", quindi assegnala al tuo account test e clicca su Salva. Ora clicca su Controlla, Pubblica e "Attiva" nell'angolo in alto a destra della finestra per attivare il flusso di lavoro.

Schermata di attivazione del flusso di lavoro

Seleziona Test e scegli il contatto di prova per testare il flusso di lavoro. Questa operazione attiva il flusso di lavoro, come mostrato sotto.

Schermata di selezione del contatto di prova

A questo punto, creeremo un'integrazione che sia in ascolto di WhatsApp e che aggiorni automaticamente i dati nel CRM di HubSpot quando viene ricevuta una notifica. Prima di configurare il flusso di lavoro, dobbiamo aggiungere il contatto di prova a una lista. Clicca su Contatti e poi su Liste per creare una nuova lista.

Una volta completata l'operazione, accedi alla pagina dei flussi di lavoro per creare un nuovo flusso di lavoro e assegnagli il nome "WhatsApp Automation" (Automazione WhatsApp).

Seleziona le liste basate sui contatti, aggiungi il nome della lista e seleziona la lista statica. Clicca su Avanti e poi sul pulsante + Add filter (+ Aggiungi filtro).

Scegli List membership (Membri lista) dalla lista Aggiungi filtro per aggiungere questo elemento come filtro, quindi clicca su Salva lista.

Schermata di aggiunta filtro

Ora puoi continuare con la configurazione del flusso di lavoro. Per farlo, seleziona Contact-based (Basato sui contatti) e aggiungi il trigger di registrazione dei contatti a List membership (Membri lista).

Schermata del trigger di registrazione contatti

Configura un'attività da attivare quando questo flusso di lavoro è abilitato. Verifica che questa attività sia visibile nella timeline Azioni e clicca su Salva.

Nella lista Scegli un'azione, clicca su Send a webhook (Invia un webhook).

Opzione di invio di un webhook

Crea un'azione per cui, all'attivazione del flusso di lavoro, questo invia il payload all'endpoint.

Schermata di invio di un webhook

Assicurati di usare l'URL che hai configurato in precedenza nel tutorial. Clicca su Salva. Infine, procedi al test del flusso di lavoro come hai fatto prima: apri la lista Test, seleziona il contatto di prova dalla lista Anteprima per e clicca su Test. Il flusso di lavoro è completo.

Ora controlliamo i registri e la timeline Azioni. Torna indietro alla timeline Azioni per rivedere l'attività creata.

Registri e timeline Azioni

Per controllare i registri, torna indietro all'app Glitch in esecuzione e visualizza i registri per verificare la ricezione dei messaggi.

Visualizzazione dei registri nell'app Glitch

Conclusioni

L'integrazione della piattaforma WhatsApp Business con HubSpot ti consente di automatizzare l'invio e la ricezione di messaggi in base alle regole create da te per gli eventi e le azioni intraprese dai tuoi clienti.

Questo articolo ha spiegato come collegare questi due servizi in un tutorial passo-passo per l'invio di messaggi WhatsApp ai contatti con dettagli registrati in HubSpot. Sei tu a configurare flussi di lavoro personalizzati che attivano azioni in base a eventi predefiniti. Inoltre, hai la possibilità di configurare un flusso di lavoro per l'invio di una notifica a un endpoint precedentemente configurato e l'inizio di una nuova attività.

Per garantire un flusso di messaggi efficace e che gli aggiornamenti comunicati ai tuoi clienti siano attesi, pertinenti e tempestivi, non eccedere con la quantità di messaggi inviati. Evita di sovraccaricare gli utenti in modo che siano soddisfatti e predisposti all'interazione.

Per maggiori informazioni sui diversi modi in cui puoi integrare WhatsApp nelle tue app e nei tuoi progetti, fai riferimento agli altri tutorial per sviluppatori a tua disposizione.