1. Prima di iniziare
- Un account LetsBot. Puoi iniziare con una prova gratuita di 14 giorni, senza carta di credito.
- Un numero WhatsApp Business collegato in LetsBot, perché i messaggi vengono inviati tramite la WhatsApp Business API ufficiale.
- Un account HubSpot in cui hai i permessi per installare app (un amministratore dell'account).
- Numeri di telefono validi in formato internazionale sui tuoi contatti HubSpot, così l'app può individuare il destinatario.
2. Installa l'app e collega HubSpot
La connessione avviene tramite OAuth di HubSpot. Non ti verrà mai chiesto di copiare o incollare una chiave API.
-
1
Accedi al pannello di LetsBot.
letsbot.net/login
-
2
Apri la sezione Integrazioni, poi scegli HubSpot.
-
3
Fai clic sul pulsante Collega HubSpot. Verrai portato alla schermata di autorizzazione OAuth di HubSpot.
-
4
Scegli l'account che vuoi collegare, poi controlla le autorizzazioni e approvale.
-
5
Verrai riportato automaticamente al pannello di LetsBot con la connessione completata, e i trigger principali saranno già attivi e pronti da personalizzare.
3. Autorizzazioni richieste e perché
L'app richiede solo le autorizzazioni di cui le sue funzionalità hanno effettivamente bisogno. Ecco l'elenco completo:
| Ambito |
Perché serve |
crm.objects.contacts.read |
Lettura delle proprietà del contatto (nome, telefono, e-mail) per individuare il destinatario e compilare le variabili del messaggio. |
crm.objects.contacts.write |
Creazione di un contatto quando arriva un messaggio WhatsApp da un numero sconosciuto e registrazione delle risposte come note nella cronologia del contatto. |
crm.objects.deals.read |
Lettura delle proprietà della trattativa (nome, fase, importo, data di chiusura) e del contatto associato, per alimentare i trigger delle trattative. |
tickets |
Lettura delle proprietà del ticket (oggetto, contenuto) e del contatto associato, per alimentare il trigger dei ticket. |
L'app non modifica mai le tue trattative o i tuoi ticket e non elimina mai alcun record. Le uniche scritture che esegue sono la creazione di un contatto quando arriva un messaggio da un numero sconosciuto e l'aggiunta di una nota di conversazione nella cronologia di quel contatto.
4. Scegli un evento trigger
Ogni evento è indipendente: attivi solo ciò che ti serve e puoi disattivare il resto in qualsiasi momento. Nessun messaggio viene mai inviato per un evento che non hai attivato tu.
| Evento |
Tipo di abbonamento HubSpot |
Cosa succede |
| Contatto creato |
contact.creation |
Invia un messaggio di benvenuto nel momento in cui viene aggiunto un nuovo contatto in HubSpot. |
| Fase del ciclo di vita del contatto cambiata |
contact.propertyChange |
Invia un messaggio quando il contatto passa a una nuova fase del ciclo di vita (ad esempio, Marketing Qualified Lead). |
| Trattativa creata |
deal.creation |
Invia un messaggio al contatto associato alla trattativa non appena questa viene creata. |
| Fase della trattativa cambiata |
deal.propertyChange |
Invia un aggiornamento quando la trattativa passa a un'altra fase della tua pipeline. |
| Ticket creato |
ticket.creation |
Avvisa il cliente su WhatsApp che il suo ticket è stato ricevuto ed è in lavorazione. |
5. Scrivi il messaggio o scegli un modello
Per ogni evento puoi scrivere un rapido messaggio di testo o scegliere un modello WhatsApp avanzato che supporta pulsanti, elenchi e contenuti multimediali. I dati di HubSpot vengono inseriti nel messaggio tramite queste variabili:
| Variabile |
Valore |
{CONTACT_FIRSTNAME} |
Nome del contatto |
{DEAL_NAME} |
Nome della trattativa |
{DEAL_STAGE} |
Fase della trattativa |
{DEAL_AMOUNT} |
Importo della trattativa |
{TICKET_SUBJECT} |
Oggetto del ticket |
{TICKET_CONTENT} |
Contenuto del ticket |
I messaggi supportano sia l'arabo sia l'inglese. Se la lingua del contatto è impostata in LetsBot viene inviata la versione corrispondente, altrimenti viene usata di default la versione inglese.
6. Attiva e prova
-
1
Attiva l'interruttore accanto all'evento che hai configurato, poi salva.
-
2
In HubSpot, crea un record reale di quel tipo (ad esempio un nuovo contatto) usando il tuo numero di telefono.
-
3
Un messaggio WhatsApp ti arriva in pochi secondi. Puoi seguire lo stato di consegna dal registro dei messaggi in LetsBot.
7. Risposte registrate in HubSpot
Quando un cliente risponde su WhatsApp, LetsBot registra la risposta come nota nella cronologia del contatto in HubSpot, così l'intero contesto della conversazione resta sulla scheda del cliente. Se la risposta arriva da un numero che non hai, viene creato automaticamente un contatto e la nota viene registrata su di esso.
8. Risoluzione dei problemi
Il messaggio non è arrivato
- Verifica che l'interruttore dell'evento sia attivo e salvato.
- Verifica che il contatto HubSpot abbia un numero di telefono valido in formato internazionale; senza di esso il destinatario non può essere individuato.
- Verifica che il tuo numero WhatsApp Business sia collegato e risulti online in LetsBot.
I trigger di trattative o ticket non si attivano
I trigger di trattative e ticket dipendono da un contatto associato, perché il messaggio viene inviato a una persona e non a un record. Associa la trattativa o il ticket a un contatto con un numero di telefono, poi riprova.
La connessione si è interrotta
Succede se l'app è stata disinstallata da HubSpot o se l'autorizzazione è stata revocata. Ricollegati dal pannello di LetsBot facendo di nuovo clic su Collega HubSpot.
9. Disconnessione e disinstallazione
Puoi disconnetterti in qualsiasi momento dal pannello di LetsBot con il pulsante di disconnessione, oppure rimuovendo l'app dalle impostazioni delle app collegate nel tuo account HubSpot. Non appena viene disconnessa, tutti i messaggi automatici si interrompono immediatamente e l'app non conserva alcun accesso ai tuoi dati.
10. Dati e privacy
Tutti i dati vengono trasmessi su una connessione crittografata e i token di accesso sono archiviati in forma crittografata. LetsBot legge da HubSpot solo i campi necessari per personalizzare il messaggio e individuare il destinatario, e i tuoi dati non vengono mai condivisi con terze parti.
Ti serve aiuto con la configurazione? Il nostro supporto IA risponde 24/7 in qualsiasi lingua e il nostro team umano è disponibile in arabo e in inglese per aiutarti a completare la connessione e inviare il primo messaggio.