HubSpot en AWS S3 verbinden (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>/*"
 ]
 }
 }
 }
 ]
}

• Klik op Volgende.
• Voeg in het gedeelte Review and create de Policy name 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 home dashboard op Services > Security, Identity, & Compliance > IAM.
• Klik op de linkerzijbalk op Rollen.
• Klik op Rol aanmaken.
• Selecteer AWS-account in de sectie Type vertrouwde entiteit.
• In de sectie Een AWS-account selecteert u Een ander AWS-account en voert u uw eigen AWS-account-ID in. Je zult later de vertrouwensrelatie wijzigen om HubSpot toegang te geven.
• Selecteer Externe ID vereisen en voer een tijdelijke ID in zoals 0000. Je zult later de vertrouwensrelatie voor je IAM-rol wijzigen en de externe ID voor je opslagintegratie opgeven. 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 Install app.
• Voer de IAM Role Name in die is geconfigureerd in stap 3 en het S3 URL Path voor de bucket waar je de data in 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 zult hebben. Klik vervolgens op Doorgaan naar Aangesloten Apps.

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

• Log in op de AWS Management Console.
• Klik op het home dashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linker zijbalk op Rollen.
• Selecteer de rol die u in stap 3 hebt gemaakt.
• Selecteer het tabblad Vertrouwensrelaties en klik op Vertrouwensbeleid bewerken.
• Wijzig de beleidsdocumenten 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 opgenomen:

• hubspot_user_arn naar de STORAGE_AWS_IAM_USER_ARN waarde
• 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 records van objecten.
• Associaties: alle associatietypen en bijbehorende records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot gebeurtenissen als aangepaste gedragsgebeurtenissen.
• Lijsten: HubSpot lijsten met contactpersonen en bedrijven.
• Owners: verantwoordelijke records.
• Pijplijnen: deal en ticket pijplijnen en pijplijn fases.
• Eigenschappen: eigenschappen en hun waarden op de records van het object, inclusief de geschiedenis van de eigenschappen.

Objectgegevens van verschillende typen 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 contactpersoonrecords.
• Gecombineerd: allerecords van alle objecttypen worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren zoals "WHERE objectTypeId='0-1'"

Aangepast objecten krijgen een ID toegewezen bij het aanmaken 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 het 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 een "S").

Hieronder staat een volledige 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 contactpersoonrecords in het objecttype Contacten).

object_eigenschappen_geschiedenis

Deze tabel bevat historische waarden van eigenschappen. 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 eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT-tijdstempel 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 associatie records tussen contactpersoonrecords en dealrecords. T
• Combined: alle records van alle associatietypen worden gecombineerd in één tabel.

associaties_x_naar_y

Elk associatietype heeft zijn eigen weergave, gelabeld als associations_<association type name> bijv. 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 object eigenschappen en gebeurtenis eigenschappen in je Hubspot account. Gebeurteniseigenschappen omvatten standaard gebeurtenissen, zoals e-mail openen en klikken, en aangepaste eigenschappen voor gedragsevenementen. Deze informatie kan handig zijn bij het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

Gebeurtenissen

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