Conectar HubSpot y AWS S3

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

Nota: HubSpot no comparte datos HIPAA con AWS S3.

Antes de empezar

Antes de ajustar la integración, tendrás que optar por tu cuenta de HubSpot en labeta de Acceso a datos de HubSpot en AWS S3 .

Conectar HubSpot y AWS S3

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

1. Configure 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. Conceda al usuario de IAM permisos para acceder a los objetos del bucket de S3. 

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

1. Inicie sesión en la consola de administración de AWS.
2. En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
3. En la barra lateral izquierda, haga clic en Configuración de la cuenta.
4. 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.
5. En el panel lateral izquierdo, haga clic en Políticas. 
6. Haga clic en Crear política. 
7. En la pestaña JSON, haga clic en Añadir nueva sentencia. 
8. 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>/*"
 ]
 }
 }
 }
 ]}

9. Haz clic en Siguiente.
10. En la sección Revisar y crear, añada el nombre de la política y una descripción opcional .
11. 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:

1. Inicie sesión en la consola de administración de AWS .
2. En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
3. En la barra lateral izquierda, haga clic en Roles. 
4. Haga clic en Crear rol. 
5. En la sección Tipo de entidad de confianza, seleccione Cuenta de AWS.
6. En la sección Una cuenta de AWS , seleccione Otra cuenta de AWS e introduzca su propio ID de cuenta de AWS. Más tarde cambiarás la relación de confianza para dar acceso a HubSpot. 
7. 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. 

8. Haz clic en Siguiente. 
9. Seleccione la política creada en el paso 1 y haga clic en Siguiente.
10. En la sección Detalles del rol, introduzca un Nombre del rol y Descripción para identificar el rol. 
11. Haga clic en Crear rol. 
12. 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

1. En tu cuenta de HubSpot, haz clic en el icono Mercado marketplace en la barra de navegación superior, y luego selecciona Mercado de HubSpot.
2. Busque y seleccione AWS S3. 
3. Haz clic en Instalar. 
4. Introducir el Nombre de rol de IAM configurado en el Paso 3 y la Ruta URL de S3 para el bucket en el que desea que se almacenen los datos.
5. Haga clic en Siguiente.
6. Revisa y copia los valores de 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

1. Inicie sesión en la consola de administración de AWS.
2. En el panel de inicio, haga clic en Servicios > Seguridad, Identidad y Cumplimiento > IAM.
3. En la barra lateral izquierda, haga clic en Roles.
4. Seleccione el rol que creó en el Paso 3. 
5. Seleccione la pestaña Relaciones de confianza y haga clic en Editar política de confianza. 
6. 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>"
 }
 }
 }
 ]
}

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

• • hubspot_user_arn al valor STORAGE_AWS_IAM_USER_ARN
  • 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. 
• Segmentos: Segmentos de contactos y empresas de HubSpot.
• Propietarios: propietarios de registros. 
• Pipelines: pipelines de negocios 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: cada tipo de objeto se almacena en su propia tabla y solo tiene registros del mismo tipo de objeto. Por ejemplo objects_contacts solo contiene registros de contactos.
• Combinado: todos los registros de todos los tipos de objeto se combinan en un objeto de base de datos. Por lo tanto, al consultar, tienes que 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. 

objects_x tables

Cada tipo de objeto disponible, incluidos los objetos personalizados, tiene su propia tabla específica. Estas tablas se denominan siguiendo el formato OBJECTS_<object type name> donde <object type name> es la etiqueta de la forma plural del objecttype. (Ten en cuenta que si el tipo de objeto no tiene forma plural, entonces <object type name> será la etiqueta de 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. Puedes obtener una fila por cada registro dentro de un objecttype (por ejemplo, todos los registros de contactos en el objecttype 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 la propiedad. El valor actual de una propiedad está determinado por la marca de tiempo UPDATEDAT más reciente en el historial de la propiedad.

Consultas sobre asociación

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 solo contiene registros de ese tipo. Por ejemplo, associations_contacts_to_deals solo contiene registros de asociación entre objetos de contacto y negocio. T
• Combinado: todos los registros de todos los tipos de asociación se combinan en una sola tabla.

associations_x_to_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 los objetos de 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 correo electrónico, y propiedades de eventos de comportamiento personalizados. Esta información puede ser útil para definir los valores que se encuentran en object_properties y en los datos de eventos.

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 con gzip debajo de cada carpeta de tabla.