I betaTilkoble HubSpot og AWS S3

Tilkoble HubSpot og AWS S3 for å synkronisere HubSpot-data til en S3-bøtte. Når appen er tilkoblet, kan HubSpot CRM-data, inkludert objekter, oppføringer, tilknytninger, hendelser og segmenter, synkroniseres med AWS S3 for lagring, rapportering og analyse. 

Du kan for eksempel synkronisere kontakt- og bedriftsdata til en S3-bøtte og bruke dem i organisasjonens datavarehus, business intelligence-verktøy eller arbeidsflyter for databehandling.

Merk: HubSpot deler ikke HIPAA-data til AWS S3.

Før du setter i gang

Før du setter opp integreringen, må du velge HubSpot-kontoen din i Access HubSpot data in AWS S3 beta.

Tilkoble HubSpot og AWS S3

For å tilkoble HubSpot og AWS S3 må du følge trinnene nedenfor i rekkefølge: 

1. Konfigurer tilgangstillatelser for AWS S3-bøtten. 
2. Opprett en IAM-policy. 
3. Opprett IAM-rollen i AWS. 
4. Tilkoble HubSpot og AWS S3. 
5. Gi IAM-brukeren rettigheter til å få tilgang til objekter i S3-bøtta. 

1. Konfigurer tilgangstillatelser for S3-bøtta

HubSpot trenger følgende tillatelser på en AWS S3-bøtte og -mappe for å få tilgang til filer i mappen og undermapper:

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

2. Opprett en IAM-policy

1. Logg inn på AWS Management Console.
2. På instrumentpanelet klikker du på Services > Security, Identity, & Compliance > IAM.
3. Klikk på Innstillinger for konto i venstre sidefelt.
4. I Security Token Service (STS) -delen ser du etter AWS-regionen som tilsvarer regionen AWS-kontoen din befinner seg i. Klikk for å slå bryteren på for å aktivere regionen.
5. Klikk på Policyer i venstre sidepanel. 
6. Klikk på Opprett policy. 
7. I JSON-fanen klikker du på Legg til ny setning. 
8. Legg til policy-dokumentet nedenfor som gir HubSpot de nødvendige tillatelsene til å laste inn eller ut data ved hjelp av en enkelt bucket og mappebane. Du kan også slette datafiler ved hjelp av alternativet 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>/*"
 ]
 }
 }
 }
 ]}

9. Klikk på Neste.
10. I delen Gjennomgå og opprett legger du til navnet på policyen og en valgfri beskrivelse.
11. Klikk på Opprett policy. 

3. Opprett IAM-rollen i AWS

Slik konfigurerer du tilgangstillatelser for HubSpot i AWS Management Console:

1. Logg inn på AWS Management Console.
2. På instrumentpanelet klikker du på Services > Security, Identity, & Compliance > IAM.
3. Klikk på Roller i venstre sidefelt. 
4. Klikk på Opprett rolle. 
5. Velg AWS-konto i delen Type betrodd enhet.
6. I delen En AWS-konto velger du En annen AWS-konto og skriver inn din egen AWS-konto-ID. Du vil senere endre tillitsforholdet for å gi tilgang til HubSpot. 
7. Velg Krev ekstern ID , og skriv inn en plassholder-ID, for eksempel 0000. Du vil senere endre tillitsforholdet for IAM-rollen din og angi den eksterne ID-en for integreringen av lagringsplassen. En ekstern ID brukes til å gi tilgang til AWS-ressursene dine til en tredjepartsapp som HubSpot. 

8. Klikk på Neste. 
9. Velg policyen som ble opprettet i trinn 1, og klikk på Neste.
10. I delen Rolledetaljer angir du et rollenavn og en beskrivelse for å identifisere rollen. 
11. Klikk på Opprett rolle. 
12. Kopier ARN-verdien på siden Role summary (Rolleoversikt). Denne verdien skal du bruke i neste trinn. 

4. Tilkoble HubSpot og AWS S3

1. På HubSpot-kontoen din klikker du på Marketplace-ikonet i den øverste navigasjonslinjen, og deretter velger du HubSpot Marketplace.
2. Søk etter og velg AWS S3. 
3. Klikk på Avdrag. 
4. Skriv inn IAM-rollenavnet som ble konfigurert i trinn 3, og S3 URL-banen for skuffen du vil at dataene skal lagres i.
5. Klikk på Neste.
6. Gjennomgå og kopier verdiene for AWS IAM User og AWS External ID , da du trenger dem i neste trinn. Klikk deretter på Fortsett til Tilkoblede apper.

5. Gi IAM-brukeren rettigheter til å få tilgang til objektene i skuffen

1. Logg inn på AWS Management Console.
2. På instrumentpanelet klikker du på Services > Security, Identity, & Compliance > IAM.
3. Klikk på Roller i venstre sidefelt.
4. Velg rollen du opprettet i trinn 3. 
5. Velg fanen Tillitsrelasjoner , og klikk på Rediger tillitspolicy. 
6. Endre policydokumentene med verdiene du oppførte i trinn 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. I policyen ovenfor endrer du de to følgende feltene til verdiene du oppførte i trinn 4:

• • hubspot_user_arn til STORAGE_AWS_IAM_USER_ARN-verdien
  • hubspot_external_id til STORAGE_AWS_EXTERNAL_ID-verdien  

Når du har fullført trinnene ovenfor, kan HubSpot synkronisere data til AWS S3.

Dataformat for synkronisering mellom HubSpot og AWS S3

Tilgjengelige data for synkronisering

Du kan synkronisere følgende data fra HubSpot til AWS S3: 

• Objekter: standard og egendefinerte objekter, for eksempel kontakter, selskaper, tickets eller produkter.
• Oppføringer: Oppføringer av individuelle objekter. 
• Tilknytninger: alle typer tilknytninger og tilknyttede oppføringer.
• Hendelser: Hendelsesdata for både standard HubSpot-hendelser og egendefinerte atferdsmessige hendelser. 
• Segmenter: HubSpot kontakt- og bedriftssegmenter.
• Eiere: Oppføring av eiere. 
• Pipelines: avtale- og ticket-pipelines og pipeline-faser. 
• Egenskaper: egenskaper og deres verdier på objektets oppføringer, inkludert egenskapsoversikten. 

Objektdata av ulike typer er organisert og tilgjengelig på to måter:

• Individuell: ehver objekttype lagres i sin egen tabell og har bare oppføringer av samme objekttype. For eksempel objects_contacts inneholder bare kontaktoppføringer.
• Kombinert: Alleoppføringer for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor spesifisere et filter som "WHERE objectTypeId='0-1'

Egendefinerte objekter får tildelt en ID når de opprettes, og identifiseres som 2-unique_ID. For eksempel 2-12345. 

objects_x-tabeller

Hver tilgjengelig objekttype, inkludert egendefinerte objekter, har sin egen spesifikke tabell. Disse tabellene er navngitt etter formatet OBJECTS_<object type name> hvor <object type name> er betegnelsen på flertallsskjemaet for objecttype. Merk at hvis objekttypen ikke har noe skjema i flertall, vil <object type name> være entallsformen av objekttypens navn sammenkjedet med "S".

Nedenfor finner du en fullstendig liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og de tilhørende tabellene.

objekt_med_objektegenskaper

Denne tabellen inneholder data fra oppføringene dine i HubSpot. Du kan få én rad for hver oppføring i en objekttype (f.eks. alle kontaktoppføringer i objekttypen kontakter). 

object_properties_history

Denne tabellen inneholder historiske verdier for egenskaper. For kontakter inneholder den de 45 siste verdiene. For alle andre objekter inneholder den de 20 siste verdiene. Tabellen har en rad for hver historiske egenskap. Den nåværende verdien av en egenskap bestemmes av det siste UPDATEDAT-tidsstempelet i egenskapens historikk.

Tilknytning spørsmål

I likhet med data om objekter er data om tilknytninger organisert på to måter:

• Individuell: Hver type tilknytning lagres i sin egen tabell og inneholder bare oppføringer av den typen. For eksempel associations_contacts_to_deals inneholder bare tilknytninger for oppføring mellom kontakt- og avtaleobjekter. T
• Kombinert: Alle oppføringer for alle typer tilknytninger samles i én tabell.

assosiasjoner_x_til_y 

Hver type tilknytning har sin egen visning, merket som associations_<association type name> f.eks. associations_contacts_to_deals. 

assosiasjon_definisjoner

Denne tabellen inneholder informasjon om alle tilgjengelige tilknytningstyper mellom HubSpot-objekter, med én rad per tilknytningstype.

property_definitions

Denne tabellen inneholder informasjon om egenskaper for objekter og hendelser i HubSpot-kontoen din. Egenskapene for hendelser omfatter standardhendelser, for eksempel åpning og klikk på e-post, og egendefinerte atferdsmessige hendelser. Denne informasjonen kan være nyttig for å definere verdier som finnes i object_properties og data om hendelser.

Hendelser

Hendelser inkluderer standard HubSpot-hendelser og egendefinerte atferdsmessige hendelser. Hver hendelse har sin egen tabell, merket som events_eventname.

objekt_og_hendelse_typedefinisjoner

Denne tabellen inneholder definisjoner for alle objekter og hendelser som er tilgjengelige på HubSpot-kontoen din.

Synkroniseringsfrekvens og organisering av data

Data synkroniseres daglig mellom HubSpot og AWS S3. Det opprettes en mappe for hver dag dataene synkroniseres. Hver av de følgende tabellene vil være tilgjengelig som en mappe med gzippede CSV-filer:

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

Det vil være flere undermapper for hver tabell. Hvis tabellens størrelse overstiger 15 MB, vil det være flere gzippede CSV-filer under hver tabellmappe.