Connettere HubSpot e AWS S3 (BETA)

{
 "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 nella console di gestione AWS:

• 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 proprio 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 nel passaggio 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: Accedere ai dati HubSpot in AWS S3.
• Accedere a questo URL e selezionare l'account HubSpot.
• In alto a destra, fare clic su Rata.
• 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.
• Rivedete e copiate i valori di AWS IAM User e AWS External ID , perché vi serviranno nel passaggio successivo. Quindi, fare clic su Continua in Applicazioni connesse.

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.
• Selezionare il ruolo creato al punto 3.
• Selezionare la scheda Relazioni di fiducia e fare clic su Modifica criteri di fiducia.
• Modificare i documenti del criterio 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 a AWS S3:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, ticket o prodotti.
• Record: i record dei singoli oggetti.
• Associazioni: tutti i tipi di associazione e i record associati.
• Eventi: dati degli eventi sia per gli eventi standard di HubSpot sia per gli eventi comportamentali personalizzati.
• Elenchi: Elenchi di contatti e aziende di HubSpot.
• Proprietari: i proprietari dei record.
• Pipeline: pipeline del ticket e fasi della trattativa.
• Proprietà: proprietà e relativi valori sui record degli oggetti, 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 del contatto.
• Combinato: tutti irecord di tutti i tipi di oggetto sono 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 di objecttype.(Si noti che se il tipo di oggetto non ha una forma plurale, <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 del contatto 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 record di quel tipo. Ad esempio, associations_contacts_to_deals contiene solo i record dell'associazione tra gli oggetti Contatto e Trattativa. T
• Combinata: tutti i record di tutti i tipi di associazione sono 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 i tipi di oggetto di 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 in object_properties e nei dati degli eventi.

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 nell'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 tabelle seguenti 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.