HubSpot en AWS S3 verbinden (BETA)

Leer hoe je HubSpot en AWS S3 kunt verbinden om HubSpot-gegevens naar je S3-bucket te synchroniseren.

HubSpot en AWS S3 verbinden

Om HubSpot en AWS S3 te verbinden, moet je de onderstaande stappen in volgorde volgen:

1. Toegangsrechten configureren voor de AWS S3 emmer
2. Een IAM-beleid maken
3. Maak de IAM-rol aan in AWS
4. HubSpot en AWS S3 verbinden
5. Geef de IAM-gebruiker rechten om toegang te krijgen tot S3 emmerobjecten

1. Configureer de toegangsrechten voor de S3 emmer

HubSpot heeft de volgende rechten nodig op een AWS S3 bucket en map om toegang te krijgen tot bestanden in de map en submappen:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:LijstBucket
• s3:PutObject
• s3:VerwijderObject

2. Maak een IAM-beleid aan

• Log in op de AWS Management Console.
• Klik op het startdashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linkerzijbalk op Accountinstellingen.
• Zoek in het gedeelte Security Token Service (STS) naar de AWS-regio die overeenkomt met de regio waarin uw AWS-account zich bevindt. Klik om de schakelaar aan te zetten om de regio te activeren.
• Klik in het linkerpaneel op Beleid.
• Klik op Beleid maken.
• Klik op het tabblad JSON op Nieuwe verklaring toevoegen.
• Voeg het onderstaande beleidsdocument toe dat HubSpot de rechten geeft die het nodig heeft om gegevens te laden of te verwijderen met behulp van een enkele emmer en mappad. Je kunt ook gegevensbestanden wissen met de optie 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>/*"
 ]
 }
 }
 }
 ]
}

• Klik op Volgende.
• Voeg in het gedeelte Beoordelen en maken de Beleidsnaam en een optionele beschrijving toe.
• Klik op Beleid maken.

3. Maak de IAM-rol aan in AWS

Om toegangsrechten voor HubSpot te configureren in de AWS Management Console:

• Log in op de AWS Management Console.
• Klik op het startdashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linkerzijbalk op Rollen.
• Klik op Rol maken.
• Selecteer AWS-account in de sectie Type vertrouwde entiteit.
• Selecteer in het gedeelte An AWS acount de optie Another AWS account en voer je eigen AWS account ID in. Je zult later de vertrouwensrelatie wijzigen om HubSpot toegang te geven.
• Selecteer Vereis externe ID en voer een tijdelijke ID in zoals 0000. Later zul je de vertrouwensrelatie voor je IAM-rol wijzigen en de externe ID voor je opslagintegratie specificeren. Een externe ID wordt gebruikt om toegang tot je AWS-bronnen te verlenen aan een app van derden zoals HubSpot.

• Klik op Volgende.
• Selecteer het beleid dat in stap 1 is gemaakt en klik op Volgende.
• Voer in het gedeelte Roldetails een Rolnaam en Beschrijving in om de rol te identificeren.
• Klik op Rol maken.
• Kopieer de ARN-waarde op de pagina Overzicht rol. U zult deze waarde in de volgende stap gebruiken.

4. HubSpot en AWS S3 verbinden

• Zorg ervoor dat je HubSpot-account is aangemeld voor deze bèta: Toegang tot HubSpot-gegevens in AWS S3.
• Navigeer naar deze URL en selecteer je HubSpot account.
• Klik rechtsboven op App installeren.
• Voer de IAM Role Name in die geconfigureerd is in stap 3 en het S3 URL Path voor de bucket waarin je de gegevens wilt dumpen.
• Klik op Volgende.
• Controleer en kopieer de AWS IAM User- en AWS External ID-waarden omdat u deze in de volgende stap nodig hebt. Klik vervolgens op Continue to Connected Apps.

5. Geef de IAM-gebruiker rechten om toegang te krijgen tot bucket-objecten

• Log in op de AWS Management Console.
• Klik op het startdashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linkerzijbalk op Rollen.
• Selecteer de rol die je in stap 3 hebt gemaakt.
• Selecteer het tabblad Vertrouwensrelaties en klik op Vertrouwensbeleid bewerken.
• Pas de beleidsdocumenten aan met de waarden die u in stap 3 hebt vastgelegd.

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

Wijzig in het bovenstaande beleid de volgende twee velden in de waarden die u in stap 4 hebt vastgelegd:

• hubspot_user_arn naar de waarde STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id naar de waarde STORAGE_AWS_EXTERNAL_ID

Na het voltooien van de bovenstaande stappen kan HubSpot gegevens synchroniseren met AWS S3.

Gegevensindeling voor synchronisatie tussen HubSpot en AWS S3

Beschikbare gegevens voor synchronisatie

Je kunt de volgende gegevens synchroniseren van HubSpot naar AWS S3:

• Objecten: standaard en aangepaste objecten, zoals contactpersonen, bedrijven, tickets of producten.
• Records: individuele objectrecords.
• Associaties: alle associatietypen en bijbehorende records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen als aangepaste gedragsevents.
• Lijsten: HubSpot contact- en bedrijfslijsten.
• Eigenaren: geregistreerde eigenaars.
• Pijplijnen: deal- en ticketpijplijnen en pijplijnfasen.
• Eigenschappen: eigenschappen en hun waarden op de objectrecords, inclusief de geschiedenis van de eigenschappen.

Objectgegevens van verschillende types zijn op twee manieren georganiseerd en beschikbaar:

• Individueel: elk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld: objects_contacts bevat alleen records van contactpersonen.
• Gecombineerd: allerecords voor alle objecttypes worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren zoals "WHERE objectTypeId='0-1'".

Aangepaste objecten krijgen een ID toegewezen op het moment van creatie en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345.

objecten_x tabellen

Elk beschikbaar objecttype, inclusief aangepaste objecten, heeft zijn eigen specifieke tabel. Deze tabellen worden benoemd volgens het formaat OBJECTS_<object type name> waarbij <object type name> het label van de meervoudsvorm van de objecttype is. (Merk op dat als het objecttype geen meervoudsvorm heeft, <object type name> het label van de enkelvoudsvorm van de objecttypenaam is, aaneengesloten met "S").

Hieronder vind je een complete lijst met beschikbare HubSpot objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en de bijbehorende tabellen.

object_met_object_eigenschappen

Deze tabel bevat gegevens van je HubSpot-records. Je kunt een rij krijgen voor elke record binnen een objecttype (bijvoorbeeld alle contactrecords in het objecttype Contacten).

object_eigenschappen_geschiedenis

Deze tabel bevat historische waarden van eigendommen. Voor contactpersonen bevat deze de meest recente 45 waarden. Voor alle andere objecten bevat het de meest recente 20 waarden. De tabel heeft een rij voor elke historische waarde van een eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente tijdstempel UPDATEDAT in de geschiedenis van de eigenschap.

Verenigingsvragen

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

• Individueel: elk associatietype wordt opgeslagen in zijn eigen tabel en bevat alleen records van dat type. Bijvoorbeeld, associations_contacts_to_deals bevat alleen associatierecords tussen contact- en dealobjecten. T
• Gecombineerd: alle records voor alle associatietypen worden gecombineerd in één tabel.

associaties_x_tot_y

Elk associatietype heeft zijn eigen weergave, gelabeld als associations_<association type name> bijvoorbeeld associations_contacts_to_deals.

associatie_definities

Deze tabel bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype.

eigendom_definities

Deze tabel bevat informatie over objecteigenschappen en gebeurteniseigenschappen in je HubSpot-account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals e-mail openen en klikken, en aangepaste gedragseigenschappen voor gebeurtenissen. Deze informatie kan handig zijn bij het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

Evenementen

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen tabel, gelabeld als events_eventname.

object_en_gebeurtenis_type_definities

Deze tabel bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in je HubSpot-account.

Synchronisatiefrequentie en gegevensorganisatie

Gegevens worden dagelijks gesynchroniseerd tussen HubSpot en AWS S3. Er wordt een map gemaakt voor elke dag dat de gegevens worden gesynchroniseerd. Elk van de volgende tabellen zal beschikbaar zijn als een map met gecomprimeerde CSV-bestanden:

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

Er zullen verschillende submappen zijn voor elke tabel. Als de tabel groter is dan 15MB, zullen er meerdere CSV-bestanden onder elke tabelmap staan.