BetaEntrare in contatto con HubSpot e AWS S3

Entrare in contatto con HubSpot e AWS S3 per sincronizzare i dati di HubSpot su un bucket S3. Dopo aver collegato l'app, HubSpot può sincronizzare i dati del CRM, compresi gli oggetti, i record, le associazioni, gli eventi e i segmenti con AWS S3 per l'archiviazione, la reportistica e le analisi dati. 

Ad esempio, è possibile sincronizzare i dati dei contatti e delle aziende in un bucket S3 e utilizzarli nel data warehouse dell'azienda, negli strumenti di business intelligence o nei flussi di lavoro per l'elaborazione dei dati.

Nota bene: HubSpot non condivide i dati HIPAA con AWS S3.

Prima di iniziare

Prima di impostare l'integrazione, è necessario iscrivere il proprio account HubSpot allabeta di Access HubSpot data in AWS S3 .

Entrare in contatto con HubSpot e AWS S3

Per entrare in contatto con HubSpot e AWS S3, è necessario seguire in ordine i seguenti passaggi: 

1. Configurare le autorizzazioni di accesso per il bucket AWS S3. 
2. Creare un criterio IAM. 
3. Creare il ruolo IAM in AWS. 
4. Entrare in contatto con 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

1. Accedere alla console di gestione AWS.
2. Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità, & Conformità > IAM.
3. Nella barra laterale sinistra, fare clic su Impostazioni account.
4. 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.
5. Nel pannello laterale sinistro, fare clic su Criteri. 
6. Fare clic su Crea criterio. 
7. Nella scheda JSON , fare clic su Aggiungi nuova dichiarazione. 
8. 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 di copia PURGE. 

{
 "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>/*"
 ]
 }
 }
 }
 ]}

9. Fare clic su Avanti.
10. Nella sezione Recensione e creazione , aggiungere il nome del criterio e una descrizione opzionale.
11. Fare clic su Crea criterio. 

3. Creare il ruolo IAM in AWS

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

1. Accedere alla console di gestione AWS.
2. Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità, & Conformità > IAM.
3. Nella barra laterale sinistra, fare clic su Ruoli. 
4. Fare clic su Crea ruolo. 
5. Nella sezione Tipo di entità attendibile , selezionare Account AWS.
6. Nella sezione Un account AWS , selezionare Un altro account AWS e inserire l'ID del proprio account AWS. In seguito modificherete la relazione di fiducia per dare accesso a HubSpot. 
7. 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. 

8. Fare clic su Avanti. 
9. Selezionare il criterio creato al punto 1 e fare clic su Avanti.
10. Nella sezione Dettagli ruolo , inserire un Nome ruolo e una Descrizione per identificare il ruolo. 
11. Fare clic su Crea ruolo. 
12. Nella pagina di riepilogo del ruolo, copiare il valore ARN . Questo valore verrà utilizzato nella fase successiva. 

4. Entrare in contatto con HubSpot e AWS S3

1. Nel tuo account HubSpot, fai clic sull'icona del Marketplace nella barra di navigazione principale, quindi seleziona Marketplace di HubSpot.
2. Cercare e selezionare AWS S3. 
3. Fare clic su Rata. 
4. Inserire il nome del ruolo IAM configurato al punto 3 e il percorso dell'URL S3 per il bucket in cui si desidera memorizzare i dati.
5. Fare clic su Avanti.
6. Recensire e copiare i valori dell' utente AWS IAM e dell' ID esterno AWS , che serviranno nella fase successiva. Quindi, fare clic su Continua con le applicazioni entrate in contatto.

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

1. Accedere alla console di gestione AWS.
2. Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità, & Conformità > IAM.
3. Nella barra laterale sinistra, fare clic su Ruoli.
4. Selezionate il ruolo creato al punto 3. 
5. Selezionare la scheda Relazioni di fiducia e fare clic su Modifica criterio di fiducia. 
6. 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>"
 }
 }
 }
 ]
}

7. 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, ticket o prodotti.
• Record: record dell'oggetto. 
• Associazioni: tutti i tipi di associazione e i record associati.
• Evento: dati sugli eventi sia per gli eventi standard di HubSpot sia per gli eventi comportamentali personalizzati. 
• Segmenti: Segmenti di contatti e aziende di HubSpot.
• Proprietari: proprietari record. 
• Pipeline: pipeline della trattativa e della ticket e fasi della trattativa. 
• 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: eogni tipo di oggetto è memorizzato in una propria tabella e contiene solo i record dell'oggetto dello stesso tipo. Ad esempio, objects_contacts contiene solo record del contatto.
• Combinato: tutti irecord dell'oggetto vengono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro come "WHERE objectTypeId='0-1'"

Agli oggetti personalizzati verrà 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 della tabella objecttype. Oggetto: se il tipo di oggetto non ha una forma plurale, l'etichetta della forma singolare del nome del tipo di oggetto concatenata con "S" <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 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à.

Interrogazione delle associazioni

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 record dell'associazione tra gli oggetti contatto e trattativa. 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 di HubSpot, con una riga per tipo di associazione.

definizioni_di_proprietà

Questa tabella contiene informazioni sulle proprietà degli oggetti e sugli eventi del vostro 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 di object_properties ed Evento.

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 si sincronizzano quotidianamente tra HubSpot e AWS S3. Per ogni giorno di sincronizzazione dei dati viene creata una cartella. 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, sotto ogni cartella della tabella ci saranno più file CSV gzippati.