Anslut HubSpot och 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>/*"
 ]
 }
 }
 }
 ]
}

• Klicka på Next (Nästa).
• I avsnittet Granska och skapa lägger du till policynamnet och en valfri beskrivning.
• Klicka på Skapa policy.

3. Skapa IAM-rollen i AWS

Så här konfigurerar du åtkomstbehörigheter för HubSpot i AWS Management Console:

• Logga in på AWS Management Console.
• På startpanelen klickar du på Tjänster > Säkerhet, identitet och efterlevnad > IAM.
• Klicka på Roller i det vänstra sidofältet.
• Klicka på Skapa roll.
• I avsnittet Typ av betrodd enhet väljer du AWS-konto.
• I avsnittet Ett AWS-konto väljer du Ett annat AWS-konto och anger ditt eget AWS-konto-ID. Du kommer senare att ändra förtroendeförhållandet för att ge åtkomst till HubSpot.
• Välj Kräv externt ID och ange ett platshållar-ID som 0000. Du kommer senare att ändra förtroenderelationen för din IAM-roll och ange det externa ID:t för din lagringsintegration. Ett externt ID används för att ge åtkomst till dina AWS-resurser till en tredjepartsapp som HubSpot.

• Klicka på Nästa.
• Välj den policy som skapades i steg 1 och klicka på Nästa.
• I avsnittet Role details anger du ett rollnamn och en beskrivning för att identifiera rollen.
• Klicka på Skapa roll.
• Kopiera ARN-värdet på sidan Rollsammanfattning. Du kommer att använda det här värdet i nästa steg.

4. Anslut HubSpot och AWS S3

Innan du installerar integrationen, se till att ditt HubSpot-konto är valt in den Få tillgång till HubSpot-data i AWS S3 beta. 

• Sök efter och välj AWS S3. Du kan också navigera till integrationen direkt i ditt konto med hjälp av den här URL:en.
• Klicka på Installera app längst upp till höger.
• Ange det IAM Role Name som konfigurerades i steg 3 och S3 URL Path för den bucket som du vill att data ska dumpas till.
• Klicka på Nästa.
• Granska och kopiera värdena AWS IAM User och AWS External ID eftersom du kommer att behöva dem i nästa steg. Klicka sedan på Fortsätt till Anslutna appar.

5. Ge IAM-användaren behörighet att komma åt bucket-objekt

• Logga in på AWS Management Console.
• På startpanelen klickar du på Tjänster > Säkerhet, identitet och efterlevnad > IAM.
• Klicka på Roller i den vänstra sidofältet.
• Välj den roll som du skapade i steg 3.
• Välj fliken Förtroenderelationer och klicka på Redigera förtroendepolicy.
• Ändra dokumenten i policyn med de värden du registrerade i steg 3.

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

I ovanstående policy ändrar du följande två fält till de värden som du registrerade i steg 4:

• hubspot_user_arn till värdet STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id till värdet STORAGE_AWS_EXTERNAL_ID

När du har slutfört ovanstående steg kan HubSpot synkronisera data till AWS S3.

Dataformat för synkronisering mellan HubSpot och AWS S3

Tillgängliga data för synkronisering

Du kan synkronisera följande data från HubSpot till AWS S3:

• Objects: standardobjekt och anpassade objekt, t.ex. kontakter, företag, biljetter eller produkter.
• Records: enskilda objektposter.
• Associationer : alla associationstyper och associerade poster.
• Händelser: Händelsedata för både standardhändelser i HubSpot och anpassade beteendehändelser.
• Listor: HubSpots kontakt- och företagslistor.
• Ägare: ägare till poster.
• Pipelines: affärs- och ärendepipelines och pipelinefaser.
• Egenskaper : egenskaper och deras värden på objektposterna, inklusive egenskapshistorik.

Objektdata av olika slag är organiserade och tillgängliga på två sätt:

• Individuell: varje objekttyp lagras i en egen tabell och innehåller endast poster av samma objekttyp. Till exempel innehåller objects_contacts endast kontaktposter.
• Combined: allaposter för alla objekttyper kombineras till ett databasobjekt. När du gör en sökning måste du alltså ange ett filter som "WHERE objectTypeId='0-1'

Anpassade objekt tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345.

objekt_x tabeller

Varje tillgänglig objekttyp, inklusive anpassade objekt, har sin egen specifika tabell. Dessa tabeller namnges enligt formatet OBJECTS_<object type name> där <object type name> är pluralformen av objecttype. (Observera att om objekttypen inte har någon pluralform, kommer <object type name> att vara singularformen av objekttypens namn sammanlänkat med "S").

Nedan finns en fullständig lista över tillgängliga HubSpot-objekttyper, en kort beskrivning av de data de representerar och deras motsvarande tabeller.

HubSpot Objekttyp	ObjektTypId	Beskrivning av objekt
KONTAKT	0-1	Information om personer som interagerar med ditt företag
FÖRETAG	0-2	Information om enskilda företag eller organisationer
DEAL	0-3	Detaljer om intäktsmöjligheter med en kontakt eller ett företag.
ENGAGEMANG	0-4	Lagrar data från CRM-åtgärder, inklusive anteckningar, uppgifter, e-postmeddelanden, möten och samtal.
TICKET	0-5	Representerar kundförfrågningar om hjälp eller support.
QUOTE	0-14	Används för att dela prisinformation med potentiella köpare.
FORMULÄR_INLÄMNING	0-15	Detaljer för enskilda inskick av ett HubSpot-formulär.
LINJE_ITEM	0-8	Representerar en delmängd av de produkter som säljs i en affär. När en produkt är kopplad till en affär blir den ett radobjekt.
KONVERTERING	0-11	Detaljer om inkommande meddelanden från flera kanaler.
LANDNINGSSIDA	0-25	Detaljer om dina målsidor
UPPDRAG	0-27	Lagrar information om att-göra-listor
FORM	0-28	Används för att samla in information om potentiella kunder om dina besökare och kontakter
MARKNADSFÖRING_EMAIL	0-29	Detaljer om e-postmeddelanden från Marketing hub
AD_ACCOUNT	0-30	Lagrar information om dina annonskonton på Linkedin, Facebook och Google
AD_CAMPAIGN	0-31	Annonser om dina kampanjer. En annonskampanj kan innehålla en eller flera annonser
AD_GROUP	0-32	Logisk gruppering av annonser inom en annonskampanj
ANNONSER	0-33	Detaljer om enskilda annonser
KAMPANJER	0-35	Information om relaterade marknadsföringstillgångar och innehåll, så att du enkelt kan mäta effektiviteten i dina gemensamma marknadsföringsinsatser.
SITE_PAGE	0-38	Data om enskilda sidor på dina webbplatser
BLOGG_POST	0-39	Data om blogginlägg
OBJECT LIST	0-45	Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter
CALL	0-48	Samtal som gjorts av andra CRM-poster, t.ex. kontakter
FAKTURA	0-53	Hantera och synkronisera fakturor med externa redovisningssystem
MEDIA_BRIDGE	0-57	Information om medietillgångar som importerats till HubSpot
SEQUENCE	0-58	En sekvens är en serie riktade, tidsbestämda e-postmallar för att vårda kontakter över tid
DEAL_SPLIT	0-72	Deal splits används för att dela deal credit mellan flera användare
SALES_DOKUMENT	0-83	Försäljningsdokument skapar ett bibliotek med innehåll för hela ditt team som kan ladda upp och dela dokument med dina kontakter.
FEEDBACK_INLÄMNING	0-19	Lagrar information som skickats in till en feedbackundersökning.
ABONNEMANG	0-69	Prenumerationer innehåller information om återkommande betalningar
HANDEL BETALNING	0-101	Innehåller data om medel som samlats in från kunder

objekt_med_objekt_egenskaper

Den här tabellen innehåller data från dina HubSpot-poster. Du kan få en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen kontakter).

objekt_egenskaper_historik

Denna tabell innehåller historiska värden för egenskaper. För kontakter innehåller den de senaste 45 värdena. För alla andra objekt innehåller den de senaste 20 värdena. Tabellen har en rad för varje historiskt värde för en egenskap. Det aktuella värdet för en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i egenskapens historik.

Föreningens förfrågningar

Precis som objektdata är associationsdata organiserad på två sätt:

• Individuell: varje associationstyp lagras i en egen tabell och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationer mellan kontakt- och affärsobjekt. T
• Combined: alla poster för alla associationstyper kombineras i en tabell.

föreningar_x_till_y

Varje associationstyp har sin egen vy, märkt som associations_<association type name>, t.ex. associations_contacts_to_deals.

associationer_definitioner

Den här tabellen innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp.

fastighets_definitioner

Den här tabellen innehåller information om egenskaper för objekt och händelser i ditt HubSpot-konto. Egenskaperna för händelser inkluderar standardhändelser, t.ex. öppningar och klick på e-postmeddelanden, och anpassade beteendemässiga händelse egenskaper. Denna information kan vara till hjälp för att definiera värden som finns i object_properties och data om händelser.

Händelser

Händelser inkluderar standard HubSpot-händelser och anpassade beteendemässiga händelser. Varje händelse har sin egen tabell, märkt som events_eventname.

objekt_och_händelsetyp_definitioner

Denna tabell innehåller definitioner för alla objekt och händelser som är tillgängliga i ditt HubSpot-konto.

Synkroniseringsfrekvens och dataorganisation

Data synkroniseras dagligen mellan HubSpot och AWS S3. En mapp kommer att skapas för varje dag som data synkroniseras. Var och en av följande tabeller kommer att finnas tillgänglig som en mapp med gzippade 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 kommer att finnas flera undermappar för varje tabell. Om tabellens storlek överstiger 15 MB kommer det att finnas flera gzippade CSV-filer under varje tabellmapp.