Creare lead e contatti in HubSpot usando la CLI di Formspree

Aggiungere l’azione hubspot nel file formspree.json ha lo stesso effetto di aggiungere il plugin HubSpot nella dashboard di Formspree. Consulta l’articolo di aiuto sul plugin HubSpot per conoscere leadStatus, lifeCycleStage e per maggiori informazioni.

Creare una Private App

HubSpot ha deprecato la API Key dell’account. Per ora, dovresti creare invece una Private App e selezionare scope specifici per il token di accesso. Per maggiori informazioni consulta qui.

• Nel tuo account HubSpot, clicca sull’icona delle impostazioni nella barra di navigazione principale.
• Nel menu della barra laterale sinistra, vai su Integrations>Private Apps.
• Clicca su Create private app.
• Configura i dettagli della tua app
• Clicca sulla scheda scopes e seleziona
  • crm.objects.contacts.read (CRM->Contacts->Read)
  • crm.objects.contacts.write (CRM->Contacts->Read)
  • crm.objects.companies.read (CRM->Companies->Read)
  • crm.objects.companies.write (CRM->Companies->Write)
• Nella finestra di dialogo, esamina le informazioni sul token di accesso della tua app, poi clicca su Continue creating.

Per iniziare a effettuare chiamate API, vai alla pagina dei dettagli della tua app.

Nella scheda Access token, clicca su Show token per rivelare il tuo token di accesso. Clicca su Copy per copiare il token negli appunti e incollalo nel file di distribuzione della CLI di Formspree come attributo accessToken.

Configurazione di Formspree.json

Chiave	Tipo	Descrizione
app	String	Deve essere hubspot
type	String	Deve essere createContact
apiKey	String	La tua API key (deve essere un riferimento a una variabile d’ambiente con $, obbligatorio) (deprecato)
accessToken	String	Il token di accesso della tua Private APP (deve essere un riferimento a una variabile d’ambiente con $, obbligatorio)
leadStatus	String	Campo opzionale. Deve essere uno tra NEW, OPEN, IN_PROGRESS, OPEN_DEAL, UNQUALIFIED, ATTEMPTED_TO_CONTACT, CONNECTED, o BAD_TIMING. Il valore predefinito è NEW.
lifeCycleStage	String	Campo opzionale. Deve essere uno tra subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, o other. Il valore predefinito è vuoto.
overwriteContact	Boolean	Campo opzionale. Se true, sovrascrive le informazioni del contatto se l’email del contatto esiste già in HubSpot. Il valore predefinito è false

Esempio

{
  "forms": {
    "registrationForm": {
      "name": "Registration Form",
      "actions": [
        {
          "app": "hubspot",
          "type": "createContact",
          "accessToken": "$accessToken",
          "leadStatus": "NEW",
          "lifeCycleStage": "lead",
          "overwriteContact": true
        }
      ]
    }
  }
}

Regole di validazione

L’azione create support ticket aggiunge implicitamente le seguenti regole di validazione:

Campo	Regola di validazione
email	Obbligatorio
email	Il tipo è email