Collegare HubSpot e AWS S3 (BETA)

Scoprite come collegare HubSpot e AWS S3 per sincronizzare i dati di HubSpot con il vostro bucket S3.

Collegare HubSpot e AWS S3

Per collegare HubSpot e AWS S3, è necessario seguire in ordine i passaggi indicati di seguito:

1. Configurare le autorizzazioni di accesso per il bucket AWS S3
2. Creare un criterio IAM
3. Creare il ruolo IAM in AWS
4. Collegare HubSpot e AWS S3
5. Concedere all'utente IAM le autorizzazioni per accedere agli oggetti del bucket S3

1. Configurare le autorizzazioni di accesso per il bucket S3

HubSpot ha bisogno delle seguenti autorizzazioni su un bucket e una cartella AWS S3 per accedere ai file della cartella e delle sottocartelle:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Creare un criterio IAM

• Accedere alla console di gestione AWS.
• Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
• Nella barra laterale sinistra, fare clic su Impostazioni account.
• Nella sezione Security Token Service (STS) , cercate la regione AWS che corrisponde alla regione in cui si trova il vostro account AWS. Fare clic per attivare l'interruttore per attivare la regione.
• Nel pannello laterale sinistro, fare clic su Criteri.
• Fare clic su Crea criterio.
• Nella scheda JSON, fare clic su Aggiungi nuova dichiarazione.
• Aggiungete il documento di policy qui sotto che darà a HubSpot le autorizzazioni necessarie per caricare o scaricare i dati utilizzando un singolo bucket e un percorso di cartella. È inoltre possibile eliminare i file di dati utilizzando l'opzione PURGE copy.

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:PutObject",
 "s3:GetObject",
 "s3:GetObjectVersion",
 "s3:DeleteObject",
 "s3:DeleteObjectVersion"
 ],
 "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
 },
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListBucket",
 "s3:GetBucketLocation"
 ],
 "Resource": "arn:aws:s3:::<bucket>",
 "Condition": {
 "StringLike": {
 "s3:prefix": [
 "<prefix>/*"
 ]
 }
 }
 }
 ]
}

• Fare clic su Avanti.
• Nella sezione Revisione e creazione, aggiungere il nome del criterio e una descrizione opzionale.
• Fare clic su Crea criterio.

3. Creare il ruolo IAM in AWS

Per configurare le autorizzazioni di accesso a HubSpot in AWS Management Console:

• Accedere alla console di gestione AWS.
• Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
• Nella barra laterale sinistra, fare clic su Ruoli.
• Fare clic su Crea ruolo.
• Nella sezione Tipo di entità attendibile, selezionare Account AWS.
• Nella sezione Un account AWS, selezionare Un altro account AWS e inserire l'ID del proprio account AWS. In seguito si modificherà la relazione di fiducia per dare accesso a HubSpot.
• Selezionare Richiedi ID esterno e inserire un ID segnaposto come 0000. In seguito si modificherà la relazione di fiducia per il ruolo IAM e si specificherà l'ID esterno per l'integrazione dello storage. Un ID esterno viene utilizzato per concedere l'accesso alle risorse AWS a un'applicazione di terze parti come HubSpot.

• Fare clic su Avanti.
• Selezionare il criterio creato al punto 1 e fare clic su Avanti.
• Nella sezione Dettagli ruolo, inserire un Nome ruolo e una Descrizione per identificare il ruolo.
• Fare clic su Crea ruolo.
• Nella pagina di riepilogo del ruolo, copiare il valore ARN. Questo valore verrà utilizzato nel passaggio successivo.

4. Collegare HubSpot e AWS S3

• Assicuratevi che il vostro account HubSpot sia abilitato a questa beta: Accesso ai dati di HubSpot in AWS S3.
• Andate a questo URL e selezionate il vostro account HubSpot.
• In alto a destra, fare clic su Installa app.
• Inserire il nome del ruolo IAM configurato al punto 3 e il percorso dell'URL S3 per il bucket in cui si desidera scaricare i dati.
• Fare clic su Avanti.
• Esaminare e copiare i valori dell'utente AWS IAM e dell' ID esterno AWS , in quanto saranno necessari nel passaggio successivo. Quindi, fare clic su Continua su Connected Apps.

5. Concedere all'utente IAM le autorizzazioni per l'accesso agli oggetti del bucket.

• Accedere alla console di gestione AWS.
• Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
• Nella barra laterale sinistra, fare clic su Ruoli.
• Selezionate il ruolo creato al punto 3.
• Selezionare la scheda Relazioni di fiducia e fare clic su Modifica criterio di fiducia.
• Modificare i documenti della polizza con i valori registrati al punto 3.

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

Nel criterio di cui sopra, modificare i due campi seguenti con i valori registrati al punto 4:

• hubspot_user_arn al valore STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id al valore STORAGE_AWS_EXTERNAL_ID

Dopo aver completato i passaggi sopra descritti, HubSpot può sincronizzare i dati in AWS S3.

Formato dei dati per la sincronizzazione tra HubSpot e AWS S3

Dati disponibili per la sincronizzazione

È possibile sincronizzare i seguenti dati da HubSpot ad AWS S3:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, biglietti o prodotti.
• Record: record di singoli oggetti.
• Associazioni: tutti i tipi di associazione e i record associati.
• Eventi: dati sugli eventi sia per gli eventi standard di HubSpot sia per gli eventi comportamentali personalizzati.
• Elenchi: Elenchi di contatti e aziende di HubSpot.
• Proprietari: proprietari registrati.
• Pipeline: pipeline di transazioni e ticket e fasi di pipeline.
• Proprietà: proprietà e relativi valori sui record dell'oggetto, compresa la cronologia delle proprietà.

I dati degli oggetti di diverso tipo sono organizzati e disponibili in due modi:

• Individuale: ogni tipo di oggetto è memorizzato nella propria tabella e contiene solo record dello stesso tipo di oggetto. Ad esempio, objects_contacts contiene solo record di contatti.
• Combinato: tutti irecord di tutti i tipi di oggetto vengono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro del tipo "WHERE objectTypeId='0-1'".

Aglioggetti personalizzati viene assegnato un ID al momento della creazione, identificato come 2-unique_ID. Ad esempio, 2-12345.

oggetti_x tabelle

Ogni tipo di oggetto disponibile, compresi gli oggetti personalizzati, ha una tabella specifica. Queste tabelle sono denominate secondo il formato OBJECTS_<object type name>, dove <object type name> è l'etichetta della forma plurale del tipo di oggetto objecttype.(Si noti che se il tipo di oggetto non ha una forma plurale, allora <object type name> sarà l'etichetta della forma singolare del nome del tipo di oggetto concatenata con "S").

Di seguito è riportato un elenco completo dei tipi di oggetto HubSpot disponibili, una breve descrizione dei dati che rappresentano e le tabelle corrispondenti.

oggetto_con_proprietà_di_oggetto

Questa tabella contiene i dati dei record di HubSpot. È possibile ottenere una riga per ogni record all'interno di un tipo di oggetto (ad esempio, tutti i record dei contatti nel tipo di oggetto Contatti).

oggetto_proprietà_storia

Questa tabella contiene i valori storici delle proprietà. Per i contatti, contiene i 45 valori più recenti. Per tutti gli altri oggetti, contiene i 20 valori più recenti. La tabella contiene una riga per ogni valore storico della proprietà. Il valore attuale di una proprietà è determinato dal timestamp UPDATEDAT più recente nella cronologia della proprietà.

Domande di associazione

Come i dati degli oggetti, i dati delle associazioni sono organizzati in due modi:

• Individuale: ogni tipo di associazione è memorizzato nella propria tabella e contiene solo i record di quel tipo. Ad esempio, associations_contacts_to_deals contiene solo i record di associazione tra gli oggetti contatto e affare. T
• Combinato: tutti i record per tutti i tipi di associazione vengono combinati in un'unica tabella.

associazioni_x_a_y

Ogni tipo di associazione ha una propria vista, etichettata come associations_<association type name>, ad esempio associations_contacts_to_deals.

definizioni_di_associazione

Questa tabella contiene informazioni su tutti i tipi di associazione disponibili tra gli oggetti HubSpot, con una riga per tipo di associazione.

definizioni_di_proprietà

Questa tabella contiene informazioni sulle proprietà degli oggetti e sugli eventi dell'account HubSpot. Le proprietà degli eventi includono eventi standard, come le aperture e i clic delle e-mail, e proprietà di eventi comportamentali personalizzati. Queste informazioni possono essere utili per definire i valori presenti nei dati object_properties ed events.

Eventi

Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha una propria tabella, etichettata come events_eventname.

definizioni_di_tipo_di_oggetto_e_di_evento

Questa tabella contiene le definizioni di tutti gli oggetti e gli eventi disponibili nel vostro account HubSpot.

Frequenza di sincronizzazione e organizzazione dei dati

I dati vengono sincronizzati quotidianamente tra HubSpot e AWS S3. Verrà creata una cartella per ogni giorno di sincronizzazione dei dati. Ciascuna delle seguenti tabelle sarà disponibile come cartella con file CSV gzippati:

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS

Ci saranno diverse sottocartelle per ogni tabella. Se la dimensione della tabella supera i 15 MB, ci saranno più file CSV gzippati sotto ogni cartella della tabella.