Connecter HubSpot et 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>/*"
 ]
 }
 }
 }
 ]
}

• Cliquez sur Suivant.
• Dans la section Review and create, ajoutez le nom de la politique et une description facultative .  
• Cliquez sur Créer une politique. 

3. Créer le rôle IAM dans AWS

Pour configurer les autorisations d'accès à HubSpot dans la console de gestion AWS :

• Connectez-vous à la console de gestion AWS .
• Sur le tableau de bord d'accueil, cliquez sur Services > Security, Identity, & Compliance > IAM.
• Dans la barre latérale gauche, cliquez sur Rôles. 
• Cliquez sur Créer un rôle. 
• Dans la section Trusted entity type, sélectionnez AWS account.
• Dans la section An AWS acount, sélectionnez Another AWS account et entrez votre propre identifiant de compte AWS. Vous modifierez ultérieurement la relation de confiance pour donner accès à HubSpot. 
• Sélectionnez Require external ID et saisissez un identifiant fictif tel que 0000. Vous modifierez ensuite la relation de confiance pour votre rôle IAM et spécifierez l'ID externe pour votre intégration de stockage. Un identifiant externe est utilisé pour accorder l'accès à vos ressources AWS à une application tierce comme HubSpot. 

• Cliquez sur Suivant. 
• Sélectionnez la politique créée à l'étape 1 et cliquez sur Next.
• Dans la section Role details, entrez un Role name et Description pour identifier le rôle. 
• Cliquez sur Créer un rôle. 
• Sur la page Role summary page, copiez la valeur ARN. Vous utiliserez cette valeur à l'étape suivante. 

4. Connecter HubSpot et AWS S3

• Assurez-vous que votre compte HubSpot est opt in this beta: Accédez aux données HubSpot dans AWS S3. 
• Naviguez vers this URL et sélectionnez votre compte HubSpot.
• Dans l'angle supérieur droit, cliquez sur Installer l'application. 
• Saisissez le nom de rôle IAM configuré à l'étape 3 et le chemin d'accès à l'URL S3 pour le panier dans lequel vous souhaitez que les données soient transférées. 
• Cliquez sur Next.
• Vérifiez et copiez les valeurs AWS IAM User et AWS External ID car vous en aurez besoin à l'étape suivante. Cliquez ensuite sur Continuer vers les applications connectées. 

5. Accorder à l'utilisateur IAM les droits d'accès aux objets du seau

• Connectez-vous à la console de gestion AWS .
• Sur le tableau de bord d'accueil, cliquez sur Services > Security, Identity, & Compliance > IAM.
• Dans la barre latérale gauche, cliquez sur Rôles.
• Sélectionnez le rôle que vous avez créé à l'étape 3. 
• Sélectionnez l'onglet Relations de confiance et cliquez sur Modifier la politique de confiance. 
• Modifiez les documents de police avec les valeurs que vous avez enregistrées à l'étape 3. 

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

Dans la police ci-dessus, remplacez les deux champs suivants par les valeurs enregistrées à l'étape 4 :

• hubspot_user_arn à la valeur STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id à la valeur STORAGE_AWS_EXTERNAL_ID  

Après avoir effectué les étapes ci-dessus, HubSpot peut synchroniser les données dans AWS S3.

Format de données pour la synchronisation entre HubSpot et AWS S3

Données disponibles pour la synchronisation

Vous pouvez synchroniser les données suivantes de HubSpot vers AWS S3 : 

• Objets : objets standard et personnalisés, tels que les contacts, les entreprises, les tickets ou les produits.
• Enregistrements : enregistrements d'objets individuels. 
• Associations : tous les types d'associations et les enregistrements associés.
• Événements : données d'événements pour les événements standard de HubSpot et les événements comportementaux personnalisés. 
• Listes : Listes de contacts et d'entreprises HubSpot.
• Propriétaires : propriétaires enregistrés. 
• Pipelines : pipelines de transactions et de tickets et étapes du pipeline. 
• Propriétés : propriétés et leurs valeurs sur les enregistrements de l'objet, y compris l'historique des propriétés. 

Les données d'objets de différents types sont organisées et disponibles de deux manières :

• Individu : ehaque type d'objet est stocké dans sa propre table et ne comporte que des enregistrements du même type d'objet. Par exemple, objects_contacts ne contient que des enregistrements de contacts.
• Combiné :Tous les enregistrements de tous les types d'objets sont combinés en un seul objet de la base de données. Ainsi, lors de l'interrogation, vous devez spécifier un filtre tel que "WHERE objectTypeId='0-1'"

Un ID sera attribué aux objets personnalisés au moment de leur création. Ceux-ci seront identifiés comme 2-unique_ID. Par exemple, 2-12345. 

objets_x tables

Chaque type d'objet disponible, y compris les objets personnalisés, possède son propre tableau. Ces tableaux sont nommés selon le format OBJECTS_<object type name> où <object type name> est l'étiquette de la forme plurielle de objecttype(si le type d'objet n'a pas de forme plurielle, <object type name> sera l'étiquette de la forme singulière du nom du type d'objet concaténé avec "S").

Vous trouverez ci-dessous une liste complète des types d'objets HubSpot disponibles, une brève description des données qu'ils représentent et les tables correspondantes.

Type d'objet HubSpot	ObjectTypeId	Description
CONTACT	0-1	Informations sur les personnes qui interagissent avec votre entreprise
COMPAGNIE	0-2	Informations sur des entreprises ou des organisations individuelles
DEAL	0-3	Détails sur les opportunités de revenus avec un contact ou une entreprise.
FIANÇAILLES	0-4	Stocke les données des actions CRM, y compris les notes, les tâches, les e-mails, les réunions et les appels.
BILLET	0-5	Représenter les demandes d'aide ou de soutien des clients.
CITER	0-14	Utilisé pour partager des informations sur les prix avec des acheteurs potentiels.
FORMULAIRE_SOUMISSION	0-15	Détails des soumissions individuelles pour un formulaire HubSpot.
LINE_ITEM	0-8	Représentent un sous-ensemble de produits vendus dans une transaction. Lorsqu'un produit est associé à une transaction, il devient une ligne de produit.
CONVERSATION	0-11	Détails des messages entrants provenant de plusieurs canaux.
LANDING_PAGE	0 à 25	Détails de vos pages de destination
TÂCHE	0-27	Stocke des informations sur les listes de tâches
FORME	0-28	Utilisé pour recueillir des informations sur vos visiteurs et vos contacts
MARKETING_EMAIL	0-29	Détails sur les e-mails du Marketing Hub
AD_ACCOUNT	0-30	Stocke des informations sur vos comptes publicitaires sur Linkedin, Facebook et Google
AD_CAMPAIGN	0-31	Détails sur vos campagnes publicitaires. Une campagne publicitaire peut contenir une ou plusieurs publicités
AD_GROUP	0-32	Regroupement logique des annonces au sein d'une campagne publicitaire
PUBLICITÉ	0-33	Détails sur les annonces individuelles
CAMPAGNE	0-35	Informations sur les actifs et le contenu marketing connexes, afin que vous puissiez facilement mesurer l'efficacité de vos efforts de marketing collectifs.
SITE_PAGE	0-38	Données sur les pages individuelles de vos sites web
BLOG_POST	0-39	Données sur les articles de blog
OBJECT LISTE	0-45	Informations sur les regroupements d'enregistrements d'objets en fonction de leurs propriétés ou de leurs activités
APPELER	0-48	Appels passés par d'autres enregistrements CRM, par exemple des contacts
FACTURE	0-53	Gérer et synchroniser les factures avec les systèmes comptables externes
MEDIA_BRIDGE	0-57	Informations sur les médias importés dans HubSpot
SEQUENCE	0-58	Une séquence est une série de modèles d'e-mails ciblés et programmés pour entretenir les contacts au fil du temps
DEAL_SPLIT	0-72	La division des transactions permet de partager le crédit des transactions entre plusieurs utilisateurs
SALES_DOCUMENT	0-83	Les documents de vente constituent une bibliothèque de contenu que toute votre équipe peut télécharger et partager avec vos contacts.
FEEDBACK_SUBMISSION	0-19	Stocke les informations soumises à une enquête de satisfaction.
ABONNEMENT	0-69	Les abonnements contiennent les détails des paiements récurrents
PAIEMENT DU COMMERCE	0-101	Contient des données sur les fonds collectés auprès des clients

object_with_object_properties

Ce tableau contient des données provenant de vos enregistrements HubSpot. Vous pouvez obtenir une ligne pour chaque enregistrement d'un type d'objet (par exemple, tous les enregistrements de contacts dans le type d'objet contacts). 

object_properties_history

Ce tableau contient les valeurs historiques des propriétés. Pour les contacts, elle contient les 45 valeurs les plus récentes. Pour tous les autres objets, elle contient les 20 valeurs les plus récentes. Le tableau comporte une ligne pour chaque valeur historique de la propriété. La valeur actuelle d'une propriété est déterminée par l'horodatage UPDATEDAT le plus récent dans l'historique de la propriété.

Questions sur les associations

Comme les données relatives aux objets, les données relatives aux associations sont organisées de deux manières :

• Individuel : Chaque type d'association est stocké dans sa propre table et ne contient que les enregistrements de ce type. Par exemple, associations_contacts_to_deals contient uniquement des enregistrements d'association entre les objets contact et transaction. T
• Combiné : tous les enregistrements pour tous les types d'association sont combinés dans un seul tableau.

associations_x_to_y 

Chaque type d'association a sa propre vue, étiquetée comme associations_<association type name>, par exemple associations_contacts_to_deals.  

association_definitions

Ce tableau contient des informations sur tous les types d'association disponibles entre les objets HubSpot, avec une ligne par type d'association.

property_definitions

Ce tableau contient des informations sur les propriétés des objets  et les propriétés des événements dans votre compte HubSpot. Les propriétés d’événement comprennent des événements standards, tels que les ouvertures d’e-mails et les clics, ainsi que des propriétés d’événements comportementaux personnalisés. Ces informations peuvent être utiles pour définir les valeurs figurant dans les données object_properties et events.

Évènements

Les événements comprennent des événements HubSpot standard et des événements comportementaux personnalisés. Chaque événement a son propre tableau, étiqueté comme suit : events_eventname.

object_and_event_type_definitions

Ce tableau contient les définitions de tous les objets et événements disponibles dans votre compte HubSpot.

Fréquence de synchronisation et organisation des données

Synchronisation des données quotidienne entre HubSpot et AWS S3. Un dossier sera créé pour chaque jour où les données sont synchronisées. Chacun des tableaux suivants sera disponible sous la forme d'un dossier contenant des fichiers CSV compressés :

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

Il y aura plusieurs sous-dossiers pour chaque tableau. Si la taille du tableau dépasse 15 Mo, il y aura plusieurs fichiers CSV gzippés dans chaque dossier de tableau.