Conectar HubSpot y AWS S3 (BETA)

Aprende a conectar HubSpot y AWS S3 para sincronizar los datos de HubSpot con tu bucket de S3. 

Conectar HubSpot y AWS S3

Para conectar HubSpot y AWS S3, debes seguir los siguientes pasos en orden: 

1. Configurar los permisos de acceso para el bucket de AWS S3
2. Crear una política IAM
3. Crear el rol IAM en AWS
4. Conectar HubSpot y AWS S3
5. Conceder al usuario IAM permisos para acceder a los objetos del bucket S3

1 1. Configurar los permisos de acceso para el bucket S3

HubSpot necesita los siguientes permisos en un bucket y carpeta de AWS S3 para acceder a los archivos de la carpeta y subcarpetas:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListaCubo
• s3:PonerObjeto
• s3:EliminarObjeto

2. Crear una política IAM

• Inicie sesión en la consola de administración de AWS .
• En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
• En la barra lateral izquierda, haga clic en Configuración de la cuenta.
• En la sección Security Token Service (STS) , busque la región de AWS que corresponda a la región en la que se encuentra su cuenta de AWS. Haga clic para activar el interruptor en para activar la región.
• En el panel lateral izquierdo, haga clic en Políticas. 
• Haga clic en Crear política. 
• En la pestaña JSON, haga clic en Añadir nueva sentencia. 
• Añade el documento de política que aparece a continuación y que dará a HubSpot los permisos que necesita para cargar o descargar datos utilizando un único bucket y una única ruta de carpeta. También puede purgar archivos de datos utilizando la opción de copia PURGA. 

{
 "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>/*"
 ]
 }
 }
 }
 ]
}

• Haz clic en Siguiente.
• En la sección Revisar y crear, añada el nombre de la política y una descripción opcional . 
• Haga clic en Crear política. 

3. Crear el rol IAM en AWS

Para configurar los permisos de acceso para HubSpot en la consola de administración de AWS:

• Inicie sesión en la consola de administración de AWS .
• En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
• En la barra lateral izquierda, haga clic en Roles. 
• Haga clic en Crear rol. 
• En la sección Tipo de entidad de confianza, seleccione Cuenta de AWS.
• En la sección Una cuenta AWS, seleccione Otra cuenta AWS e introduzca su propio ID de cuenta AWS. Más adelante cambiarás la relación de confianza para dar acceso a HubSpot. 
• Seleccione Requerir ID externo e introduzca un ID de marcador de posición como 0000. Más adelante cambiará la relación de confianza para su rol de IAM y especificará el ID externo para su integración de almacenamiento. Un ID externo se utiliza para conceder acceso a sus recursos de AWS a una aplicación de terceros como HubSpot. 

• Haz clic en Siguiente. 
• Seleccione la política creada en el paso 1 y haga clic en Siguiente.
• En la sección Detalles del rol, introduzca un Nombre del rol y Descripción para identificar el rol. 
• Haga clic en Crear rol. 
• En la página de resumen de funciones , copie el valor ARN. Utilizará este valor en el siguiente paso. 

4. Conectar HubSpot y AWS S3

• Asegúrate de que tu cuenta de HubSpot está opted into this beta: Accede a los datos de HubSpot en AWS S3. 
• Navega a esta URL y selecciona tu cuenta de HubSpot.
• En la parte superior derecha, haz clic en Instalar aplicación. 
• Introduzca el IAM Role Name configurado en el paso 3 y la S3 URL Path para el bucket en el que desea volcar los datos. 
• Haga clic en Siguiente.
• Revisa y copia los valores AWS IAM User y AWS External ID ya que los necesitarás en el siguiente paso. A continuación, haga clic en Continuar con las aplicaciones conectadas. 

5. Conceder al usuario IAM permisos para acceder a los objetos del cubo

• Inicie sesión en la consola de administración de AWS .
• En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
• En la barra lateral izquierda, haga clic en Roles.
• Seleccione el rol que creó en el Paso 3. 
• Seleccione la pestaña Relaciones de confianza y haga clic en Editar política de confianza. 
• Modifique los documentos de la póliza con los valores que registró en el paso 3. 

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

En la política anterior, cambie los dos campos siguientes a los valores que registró en el paso 4:

• hubspot_external_id al valor STORAGE_AWS_EXTERNAL_ID  

Después de completar los pasos anteriores, HubSpot puede sincronizar los datos en AWS S3.

Formato de datos para la sincronización entre HubSpot y AWS S3

Datos disponibles para la sincronización

Puedes sincronizar los siguientes datos desde HubSpot a AWS S3: 

• Objetos: objetos estándar y personalizados, como contactos, empresas, tickets o productos.
• Registros: registros de objetos individuales. 
• Asociaciones: todos los tipos de asociaciones y registros asociados.
• Eventos: datos de eventos tanto para eventos estándar de HubSpot como para eventos de comportamiento personalizados. 
• Listas: Listas de contactos y empresas de HubSpot.
• Propietarios: propietarios registrados. 
• Pipelines: pipelines de transacciones y tickets y etapas de pipelines. 
• Propiedades: propiedades y sus valores en los registros de objetos, incluido el historial de propiedades. 

Los datos de los objetos de diferentes tipos están organizados y disponibles de dos maneras:

• Individual: eada tipo de objeto se almacena en su propia tabla y sólo tiene registros del mismo tipo de objeto. Por ejemplo, objects_contacts sólo contiene registros de contactos.
• Combinado: atodos los registros de todos los tipos de objeto se combinan en un objeto de base de datos. Por lo tanto, al realizar la consulta, es necesario especificar un filtro como "WHERE objectTypeId='0-1'

A los objetos personalizados se les asignará un ID en el momento de su creación, y se identificarán como 2-unique_ID. Por ejemplo, 2-12345. 

objetos_x tablas

Cada tipo de objeto disponible, incluidos los objetos personalizados, tiene su propia tabla específica. Estas tablas se nombran siguiendo el formato OBJECTS_<object type name> donde <object type name> es la etiqueta de la forma plural del objecttype. (Tenga en cuenta que si el tipo de objeto no tiene forma plural, entonces <object type name> será la etiqueta de la forma singular del nombre del tipo de objeto concatenada con "S").

A continuación se muestra una lista completa de los tipos de objetos de HubSpot disponibles, una breve descripción de los datos que representan y sus tablas correspondientes.

object_with_object_properties

Esta tabla contiene datos de tus registros de HubSpot. Puede obtener una fila por cada registro dentro de un tipo de objeto (por ejemplo, todos los registros de contactos en el tipo de objeto contactos). 

object_properties_history

Esta tabla contiene valores históricos de la propiedad. Para los contactos, contiene los 45 valores más recientes. Para todos los demás objetos, contiene los 20 valores más recientes. La tabla tiene una fila para cada valor histórico de propiedad. El valor actual de una propiedad viene determinado por la marca de tiempo UPDATEDAT más reciente del historial de la propiedad.

Consultas sobre asociaciones

Al igual que los datos de los objetos, los datos de las asociaciones se organizan de dos maneras:

• Individual: cada tipo de asociación se almacena en su propia tabla y sólo contiene registros de ese tipo. Por ejemplo, associations_contacts_to_deals sólo contiene registros de asociación entre objetos de contacto y operaciones. T
• Combinado: todos los registros de todos los tipos de asociación se combinan en una sola tabla.

asociaciones_x_a_y 

Cada tipo de asociación tiene su propia vista, etiquetada como associations_<association type name> por ejemplo associations_contacts_to_deals. 

association_definitions

Esta tabla contiene información sobre todos los tipos de asociación disponibles entre objetos HubSpot, con una fila por tipo de asociación.

property_definitions

Esta tabla contiene información sobre propiedades de objetos y propiedades de eventos en tu cuenta de HubSpot. Las propiedades de eventos incluyen eventos estándar, como aperturas y clics de correos electrónicos, y propiedades de eventos de comportamiento personalizados de . Esta información puede ser útil para definir los valores que se encuentran en object_properties y events data.

Eventos

Los eventos incluyen eventos estándar de HubSpot y eventos de comportamiento personalizados. Cada evento tiene su propia tabla, etiquetada como events_eventname.

object_and_event_type_definitions

Esta tabla contiene definiciones para todos los objetos y eventos disponibles en tu cuenta de HubSpot.

Frecuencia de sincronización y organización de datos

Los datos se sincronizan diariamente entre HubSpot y AWS S3. Se creará una carpeta por cada día que se sincronicen los datos. Cada una de las siguientes tablas estará disponible como una carpeta con archivos CSV comprimidos con gzip:

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

Habrá varias subcarpetas para cada tabla. Si el tamaño de la tabla supera los 15 MB, habrá varios archivos CSV comprimidos bajo cada carpeta de tabla.