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 al 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

Prima di rata l'integrazione, assicuratevi che il vostro account HubSpot sia ha optato per il Accesso ai dati di HubSpot in AWS S3 beta. 

• Cercare e selezionare AWS S3. È anche possibile accedere all'integrazione direttamente dal proprio account utilizzando questo URL.
• 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 , poiché 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.

Tipo di oggetto HubSpot	Tipo di oggettoId	Descrizione dell'oggetto
CONTATTO	0-1	Informazioni sulle persone che interagiscono con la vostra azienda
AZIENDA	0-2	Informazioni su singole aziende o organizzazioni
TRATTATIVA	0-3	Dettagli sulle opportunità di guadagno con un contatto o un'azienda.
COINVOLGIMENTO	0-4	Memorizza i dati delle azioni del CRM, tra cui note, attività, e-mail, riunioni e chiamate.
TICKET	0-5	Rappresenta le richieste di aiuto o di supporto dei clienti.
PREVENTIVO	0-14	Utilizzato per condividere le informazioni sui prezzi con i potenziali acquirenti.
MODULO_INVIO	0-15	Dettagli per i singoli invii di form di HubSpot.
LINE_ITEM	0-8	Rappresenta un sottoinsieme di prodotti venduti in una trattativa. Quando un prodotto è collegato a una trattativa, diventa una voce.
CONVERSAZIONI	0-11	Dettagli dei messaggi in arrivo da più canali.
PAGINA DI ATTERRAGGIO	0-25	Dettagli delle landing page
COMPITO	0-27	Memorizza informazioni sugli elenchi di cose da fare
MODULO	0-28	Utilizzato per raccogliere informazioni sui lead dei visitatori e dei contatti
MARKETING_EMAIL	0-29	Dettagli sulle email provenienti da Marketing hub
AD_ACCOUNT	0-30	Annuncia le informazioni sugli account pubblicitari su Linkedin, Facebook e Google
AD_CAMPAIGN	0-31	Annunci sulle campagne pubblicitarie. Una Campagna pubblicitaria può contenere uno o più annunci
AD_GROUP	0-32	Gruppo logico di annunci all'interno di una Campagna
ANNUNCI	0-33	Dettagli sui singoli annunci
CAMPAGNE	0-35	Informazioni sulle attività e sui contenuti di marketing correlati, in modo da poter misurare facilmente l'efficacia dei vostri sforzi di marketing collettivi.
SITO_PAGINA	0-38	Dati sulle singole pagine del sito web
BLOG_POST	0-39	Dati sui post del blog
ELENCO DEGLI OGGETTI	0-45	Informazioni sui raggruppamenti di record di oggetti in base alle loro proprietà o attività
CHIAMATA	0-48	Chiamate effettuate da altri record del CRM, per esempio i contatti
FATTURA	0-53	Gestire e sincronizzare le fatture con i sistemi contabili esterni
PONTE_MEDIO	0-57	Informazioni sulle risorse multimediali importate in HubSpot
SEQUENZA	0-58	Una sequenza è una serie di modelli di e-mail mirati e temporizzati per coltivare i contatti nel tempo
DEAL_SPLIT	0-72	Le suddivisioni delle trattative sono utilizzate per condividere il credito delle trattative tra più utenti
DOCUMENTO DI VENDITA	0-83	I documenti di vendita costituiscono una libreria di contenuti per tutto il team, che può caricare e condividere documenti con i contatti.
INVIO_DI_RISCONTRO	0-19	Memorizza le informazioni inviate a un sondaggio di feedback.
ABBONAMENTO	0-69	Gli abbonamenti contengono i dettagli dei pagamenti ricorrenti
PAGAMENTO DEL COMMERCIO	0-101	Contiene dati sui fondi raccolti dai clienti

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.

Evento

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.