BètaHubSpot en AWS S3 verbinden (BETA)
Laatst bijgewerkt: maart 21, 2025
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
|
Leer hoe je HubSpot en AWS S3 kunt verbinden om HubSpot-gegevens naar je S3-bucket te synchroniseren.
Let op: HubSpot deelt geen HIPAA-gegevens met AWS S3.
Voordat je begint
Voordat je de integratie instelt, moet je je HubSpot account aanmelden voor de Access HubSpot data in AWS S3 beta.
HubSpot en AWS S3 verbinden
Om HubSpot en AWS S3 te verbinden, moet je de onderstaande stappen in volgorde volgen:
- Toegangsrechten configureren voor de AWS S3 emmer
- Een IAM-beleid maken
- Maak de IAM-rol aan in AWS
- HubSpot en AWS S3 verbinden
- 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.
Let op:
- Zorg ervoor dat je
<bucket>
en<prefix>
vervangt door je eigenlijke emmernaam en mappad prefix.De Amazon Resource Names (ARN) voor emmers in overheidsregio's hebben een arn:aws-us-gov:s3:: voorvoegsel. - Door de voorwaarde
s3:prefix
in te stellen op ["*"] of ["<pad>/*"] wordt toegang verleend tot alle voorvoegsels in respectievelijk de opgegeven emmer of het pad in de emmer.
{
"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
Configureer de toegangsrechten voor HubSpot in de AWS Management Console:
- Log in op de AWS Management Console.
- Klik in het hoofddashboard op Services > Security, Identity, & Compliance > IAM.
- Klik in de linker zijbalk op Rollen.
- Klik op Rol aanmaken.
- Selecteer AWS-account in de sectie Type vertrouwde entiteit.
- Selecteer in de sectie An AWS acount (Een AWS-account ) de optie Another AWS account (Een ander AWS-account ) en voer 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
Voordat je de integratie installeert, moet je ervoor zorgen dat je HubSpot account is aangemeld voor de beta Access HubSpot data in AWS S3 .- Klik in je HubSpot-account op het Marktplaats-pictogram marketplace in de bovenste navigatiebalk en selecteer vervolgens App-marktplaats. Zoek en selecteer AWS S3. Je kunt ook rechtstreeks naar de integratie in je account navigeren met deze URL.
- Klik rechtsboven op Install app.
- Voer de IAM-rolnaam in die is geconfigureerd in stap 3 en het S3 URL-pad voor de emmer waarin u 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 linker zijbalk op Rollen.
- Selecteer de rol die u in stap 3 hebt aangemaakt.
- 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 vastgelegd:
- hubspot_user_arn naar de waarde STORAGE_AWS_IAM_USER_ARN
- hubspot_external_id in de waarde STORAGE_AWS_EXTERNAL_ID
Na het voltooien van de bovenstaande stappen kan HubSpot gegevens synchroniseren met AWS S3.
Gegevensformaat 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 gedragsgebeurtenissen.
- Lijsten: HubSpot contact- en bedrijfslijsten.
- Eigenaren: record eigenaren.
- Pijplijnen: deal en ticket pijplijnen en pijplijn stadia.
- Eigenschappen: eigenschappen en hun waarden op de objectrecords, inclusief de geschiedenis van de eigenschappen.
Objectgegevens van verschillende typen zijn georganiseerd en beschikbaar op twee manieren:
- Individueel: elk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld:
objects_contacts
bevat alleen contactrecords. - 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'".
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 staat een complete lijst met beschikbare HubSpot objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en de bijbehorende tabellen.
HubSpot objecttype |
ObjectTypeId |
Beschrijving |
0-1 |
Informatie over personen die contact hebben met uw bedrijf |
|
0-2 |
Informatie over individuele bedrijven of organisaties |
|
0-3 |
Details over omzetmogelijkheden met een contactpersoon of bedrijf. |
|
0-4 |
Slaat gegevens op van CRM-acties, waaronder notities, taken, e-mails, vergaderingen en gesprekken. |
|
0-5 |
Vertegenwoordigt verzoeken van klanten om hulp of ondersteuning. |
|
0-14 |
Wordt gebruikt om prijsinformatie te delen met potentiële kopers. |
|
0-15 |
Details voor individuele inzendingen voor een HubSpot-formulier. |
|
0-8 |
Vertegenwoordigen een subset van producten die in een deal worden verkocht. Wanneer een product aan een deal wordt gekoppeld, wordt het een regelitem. |
|
0-11 |
Details van inkomende berichten van meerdere kanalen. |
|
0-25 |
Details van je landingspagina's |
|
0-27 |
Slaat informatie op over takenlijsten |
|
0-28 |
Wordt gebruikt om leadinformatie te verzamelen over uw bezoekers en contactpersonen |
|
0-29 |
Details over e-mails van marketing hub |
|
AD_ACCOUNT |
0-30 |
Slaat informatie op over je advertentieaccounts op Linkedin, Facebook en Google |
0-31 |
Informatie over je advertentiecampagnes. Een advertentiecampagne kan een of meer advertenties bevatten |
|
AD_GROEP |
0-32 |
Logische groepering van advertenties binnen een advertentiecampagne |
AD |
0-33 |
Details over individuele advertenties |
0-35 |
Informatie over gerelateerde marketingmiddelen en inhoud, zodat u eenvoudig de effectiviteit van uw gezamenlijke marketinginspanningen kunt meten. |
|
SITE PAGINA |
0-38 |
Gegevens over afzonderlijke pagina's op uw websites |
0-39 |
Gegevens over blogberichten |
|
0-45 |
Informatie over groeperingen van objectrecords gebaseerd op hun eigenschappen of activiteiten |
|
0-48 |
Oproepen gedaan door andere CRM-records, bijvoorbeeld contactpersonen |
|
INVOICE |
0-53 |
Facturen beheren en synchroniseren met externe boekhoudsystemen |
0-57 |
Informatie over in HubSpot geïmporteerde media-assets |
|
0-58 |
Een sequentie is een reeks gerichte, getimede e-mailsjablonen om contacten in de loop van de tijd te voeden. |
|
0-72 |
Dealsplitsingen worden gebruikt om dealtegoed te verdelen onder meerdere gebruikers |
|
0-83 |
Verkoopdocumenten bouwen een inhoudsbibliotheek voor je hele team om documenten te uploaden en te delen met je contactpersonen. |
|
0-19 |
Slaat informatie op die is ingediend bij een feedbackenquête. |
|
0-69 |
Abonnementen bevatten details van terugkerende betalingen |
|
0-101 |
Bevat gegevens over geld dat is verzameld van klanten |
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 eigenschappen. Voor contactpersonen bevat het 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.
Associatie-query's
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>
bijv. associations_contacts_to_deals
.
associatie_definities
Deze tabel bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype.
eigenschap_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 die gevonden worden in object_eigenschappen en gebeurtenisgegevens.
Gebeurtenissen
Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsevents. 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 grootte van de tabel groter is dan 15MB, zullen er meerdere gecomprimeerde CSV-bestanden onder elke tabelmap staan.