HubSpot

Collegare HubSpot significa che ogni richiesta di preventivo diventa anche un contatto da seguire, senza che nessuno copi i dettagli a mano.

Attenzione

HubSpot richiede due valori, non uno: un Portal ID e un HubSpot access token. Servono anche tre ambiti (scope) selezionati nell’app privata che emette il token. Se manca uno dei due, il collegamento sembra configurato ma non invia nulla: il Passaggio 1 copre entrambi.

Nota

HubSpot è incluso nel piano PRO. Klaviyo, Mailchimp e Shopify sono le integrazioni incluse nel piano FREE. Consulta Confronto tra i piani.

Se il tuo piano non lo include, nell’elenco Third-party integration compare un pulsante Upgrade disattivato al posto dell’icona delle impostazioni, con un lucchetto accanto. Selezionando il lucchetto vedi quale piano serve per la funzione e un link a Pricing plans nell’app. Dipende dal piano, non da un guasto.

Passaggio 1 — Ottieni da HubSpot il Portal ID e l’access token

HubSpot non emette più le classiche chiavi API. Crei invece un’app privata nel tuo account HubSpot, che ti fornisce un access token. Il Portal ID è un’altra cosa: identifica il tuo account HubSpot.

1. Trova il tuo Portal ID

   Il tuo Portal ID (detto anche ID account o hub ID) identifica l’account HubSpot in cui l’app scrive. La guida di HubSpot: Check your current account.

   Lo stesso link è ripetuto nell’app come testo di aiuto Find your Portal ID sotto il campo.

2. Crea un’app privata con gli ambiti giusti

   Crea l’app privata nel tuo account HubSpot. La guida di HubSpot ti accompagna: Private apps.

   Prima di finire la creazione, seleziona almeno questi tre ambiti:

   • forms
   • crm.objects.contacts.write
   • crm.schemas.contacts.write

   L’app elenca gli stessi tre sotto il campo del token, così puoi confrontarli in seguito con la tua app privata.

   

   Serve uno screenshot. La schermata degli ambiti dell’app privata di HubSpot con forms, crm.objects.contacts.write e crm.schemas.contacts.write selezionati.

3. Copia il suo access token

   HubSpot mostra il token una volta creata l’app privata. Copialo e conservalo in un posto sicuro mentre completi la configurazione.

Pericolo

Gli ambiti sono il guasto silenzioso. Un token creato senza forms, crm.objects.contacts.write e crm.schemas.contacts.write è un token perfettamente valido: Enable resta attivo, l’app salva senza lamentarsi e HubSpot rifiuta ogni contatto che riceve. Se i contatti non arrivano mai, controlla gli ambiti prima di ogni altra cosa.

Attenzione

L’app collega le richieste di preventivo a un modulo di HubSpot, non a una lista di contatti. Crea quel modulo in HubSpot prima di iniziare: il menu a discesa può proporre solo i moduli già esistenti.

Passaggio 2 — Collegalo nell’app

1. Apri la scheda Integrations

   Nell’amministrazione Shopify apri SA Request a Quote, seleziona Advanced settings, poi apri la scheda Integrations.

2. Seleziona HubSpot

   Sotto Third-party integration, seleziona HubSpot, descritto nell’app come «Seamlessly connect your submissions to your data».

   Si apre la pagina di HubSpot, con un percorso Third-party per tornare all’elenco.

   

   Scegli il servizio, poi apri le sue impostazioni.

3. Attiva Enable

   Attiva Enable, il primo controllo della pagina. Finché non lo fai, non viene inviato nulla a HubSpot.

4. Incolla entrambe le credenziali

   I due campi si trovano subito sotto Enable, in quest’ordine:

   1. Portal ID — incolla l’ID account ottenuto nel Passaggio 1. Il testo di aiuto è Find your Portal ID.
   2. HubSpot access token — incolla il token dell’app privata ottenuto nel Passaggio 1. Il testo di aiuto è Find or generate your access token e sotto l’app riporta gli ambiti che servono al token: forms, crm.objects.contacts.write e crm.schemas.contacts.write.

   Il campo si chiama HubSpot access token, non «API key»: il token è ciò che emette un’app privata.

   Compila entrambi. L’app recupera i tuoi moduli di HubSpot solo quando ha la coppia di valori, quindi una pagina con il solo token resta bloccata senza nulla da scegliere. Se il menu a discesa non compare dopo aver digitato, seleziona Merge fields accanto al campo del token per far recuperare di nuovo i dati all’app.

   

   HubSpot richiede due valori, e non sono intercambiabili.

5. Scegli il modulo di HubSpot

   Apri Select a HubSpot form to integrate e scegli il modulo a cui devono arrivare le richieste di preventivo. Finché non scegli, riporta «Please select a HubSpot form».

   Se l’app dice «It looks like you don’t have any HubSpot forms», o il modulo non esiste ancora, oppure una delle due credenziali è sbagliata, oppure al token manca l’ambito forms. Risolvi prima di proseguire: l’associazione dei campi resta nascosta finché non è selezionato un modulo.

6. Associa i campi del modulo

   Le righe di associazione compaiono solo quando Portal ID, HubSpot access token e modulo sono tutti impostati. Le righe derivano dal modulo HubSpot appena scelto, quindi sono i campi di quel modulo e non un elenco fisso: scegli prima il modulo e le righe seguono.

   Leggi ogni riga da sinistra a destra:

   • A sinistra — il campo di HubSpot, disattivato perché non puoi rinominarlo.
   • Al centro — come viene fornito il valore: has no value, is dynamic value by (preso dal modulo di preventivo) o is fixed value by (invia lo stesso testo a ogni preventivo).
   • A destra — il campo del modulo di preventivo che invii, oppure il testo fisso che hai digitato.

   Quindi scegli a destra il valore del modulo di preventivo che riempie il campo di HubSpot indicato a sinistra, mai il contrario.

   La riga dell’email è quella che non puoi saltare: senza, non c’è un contatto da creare. Se il tuo modulo raccoglie Company information, associa anche il nome dell’azienda, così il team commerciale vede chi sta chiedendo. Se un campo è contrassegnato come obbligatorio nel modulo di HubSpot e lo lasci senza associazione, l’app segnala la riga e rifiuta di salvare.

   

7. Salva

   Seleziona Save. Finché non lo fai, non viene memorizzato nulla e una pagina non salvata non invia niente.

   Quando ci sono modifiche non salvate, l’app mostra una barra con Save e Discard changes: Discard changes annulla tutto ciò che hai digitato nella pagina. Un messaggio Changes saved conferma il salvataggio.

Nota

Mailchimp mostra la stessa tabella di associazione dei campi da vicino. Seguila solo per l’associazione: Mailchimp richiede una sola chiave API e sceglie una lista, mentre HubSpot richiede anche il Portal ID e sceglie un modulo.

Passaggio 3 — Provalo

Invia una vera richiesta di preventivo dalla tua vetrina, poi controlla in HubSpot il nuovo contatto. Verifica che siano arrivati davvero i campi che hai associato, non solo l’indirizzo email.

Attenzione

Non saltare la prova. Un collegamento può sembrare attivo e non consegnare comunque nulla di utile se i campi sono associati male, e te ne accorgi solo quando provi a usare i dati.

È lo strumento giusto?

È la scelta giusta se i preventivi sono gestiti da un team commerciale e non dal marketing.

Se non usi già HubSpot, non adottarlo solo per questo: Zapier collega i dati dei preventivi a quasi tutto e Crea un cliente Shopify dopo l’invio tiene tutto dentro Shopify con il piano FREE.

Se i contatti non arrivano

• Controlla gli ambiti della tua app privata. forms, crm.objects.contacts.write e crm.schemas.contacts.write devono essere tutti concessi. Un token senza di essi si salva senza problemi e non consegna nulla. È la causa più comune.
• Controlla che Enable sia ancora attivo. Finché è disattivato, non viene inviato nulla.
• Controlla il Portal ID oltre al token. Un token corretto con un Portal ID mancante o digitato male lascia il collegamento a metà: l’app non riesce a caricare i tuoi moduli, quindi non viene inviato nulla.
• Controlla che il token sia ancora valido. Ruotare un token in HubSpot interrompe il collegamento finché non incolli quello nuovo. I token salvati sono mostrati mascherati, quindi in caso di dubbio incolla un token nuovo.
• Controlla di aver scelto il modulo giusto. I contatti potrebbero arrivare in un posto in cui non stai guardando.
• Controlla che la riga dell’email sia associata. Senza, non c’è un contatto da creare.

Hai ancora bisogno di aiuto? Scrivi a [email protected].

Prossimi passi

• Panoramica sulle integrazioni — gli altri strumenti che puoi collegare
• Crea un modulo B2B — raccogli i dati dell’azienda utili da inviare a un CRM
• Confronto tra i piani — cosa include il piano PRO