Connecter HubSpot et AWS S3 (BETA)

Apprenez à connecter HubSpot et AWS S3 pour synchroniser les données HubSpot avec votre panier S3. 

Connecter HubSpot et AWS S3

Pour connecter HubSpot et AWS S3, vous devez suivre les étapes ci-dessous dans l'ordre : 

1. Configurer les autorisations d'accès pour le seau AWS S3
2. Créer une politique IAM
3. Créer le rôle IAM dans AWS
4. Connecter HubSpot et AWS S3
5. Accorder à l'utilisateur IAM les droits d'accès aux objets du panier S3

1. Configurer les autorisations d'accès au panier S3

HubSpot a besoin des autorisations suivantes sur un seau et un dossier AWS S3 pour accéder aux fichiers du dossier et des sous-dossiers :

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Créer une politique IAM

• 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 Paramètres du compte.
• Dans la section Security Token Service (STS) , recherchez la région AWS qui correspond à la région dans laquelle se trouve votre compte AWS. Cliquez pour faire basculer l'interrupteur sur pour activer la région.
• Dans le panneau latéral gauche, cliquez sur Policies. 
• Cliquez sur Créer une politique. 
• Dans l'onglet JSON, cliquez sur Ajouter une nouvelle déclaration. 
• Ajoutez le document de politique ci-dessous qui donnera à HubSpot les permissions dont il a besoin pour charger ou décharger des données en utilisant un seul seau et un seul chemin de dossier. Vous pouvez également purger les fichiers de données à l'aide de l'option de copie PURGE. 

{
 "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_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'"

Les objets personnalisés se verront attribuer un identifiant au moment de leur création et 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.

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 des événements comprennent les événements standard, tels que les ouvertures et les clics d'e-mail, et les propriétés des é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.