Conectar HubSpot y 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>/*"
 ]
 }
 }
 }
 ]
}

• 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_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. 
• 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.

Tipo de objeto HubSpot	objectTypeId	Descripción
CONTACTO	0-1	Información sobre las personas que interactúan con su empresa
EMPRESA	0-2	Información sobre empresas u organizaciones individuales
NEGOCIO	0-3	Detalles sobre las oportunidades de ingresos con un contacto o empresa.
INTERACCIÓN	0-4	Almacena datos de acciones de CRM, incluidas notas, tareas, correos electrónicos, reuniones y llamadas.
TICKET	0-5	Representar las solicitudes de ayuda o apoyo de los clientes.
COTIZACIÓN	0-14	Se utiliza para compartir la información sobre los precios con los posibles compradores.
FORMULARIO_SOMETIMIENTO	0-15	Detalles para los envíos individuales de un formulario de HubSpot.
LINE_ITEM	0-8	Representan un subconjunto de productos vendidos en una operación. Cuando un producto está adjunto a un negocio, se convierte en elemento de pedido.
CONVERSACIONES	0-11	Detalles de los mensajes entrantes de múltiples canales.
PÁGINA DE ATERRIZAJE	Entre 0 y 25	Detalles de sus páginas de destino
TAREA	0-27	Almacena información sobre las listas de tareas pendientes
FORMULARIO	0-28	Se utiliza para recopilar información sobre sus visitantes y contactos
MARKETING_EMAIL	0-29	Detalles sobre los correos electrónicos del Marketing Hub
AD_ACCOUNT	0-30	Almacena información sobre sus cuentas de publicidad en Linkedin, Facebook y Google
AD_CAMPAÑA	0-31	Detalles sobre sus campañas publicitarias. Una campaña publicitaria puede contener uno o varios anuncios
AD_GROUP	0-32	Agrupación lógica de anuncios dentro de una campaña publicitaria
ANUNCIO	0-33	Detalles sobre los anuncios individuales
CAMPAÑA	0-35	Información sobre los activos y contenidos de marketing relacionados, para que pueda medir fácilmente la eficacia de sus esfuerzos colectivos de marketing.
PÁGINA DEL SITIO	0-38	Datos sobre las páginas individuales de sus sitios web
BLOG_POST	0-39	Datos sobre las entradas del blog
OBJETO LISTA	0-45	Información sobre agrupaciones de registros de objetos en función de sus propiedades o actividades
LLAMAR	0-48	Llamadas realizadas por otros registros CRM, por ejemplo contactos
FACTURA	0-53	Gestionar y sincronizar las facturas con los sistemas contables externos
MEDIA_BRIDGE	0-57	Información sobre los activos de medios importados en HubSpot
SECUENCIA	0-58	Una secuencia es una serie de plantillas de correo electrónico dirigidas y programadas para nutrir a los contactos a lo largo del tiempo
DEAL_SPLIT	0-72	Los repartos de tratos se utilizan para compartir el crédito de los tratos entre varios usuarios
DOCUMENTO_DE_VENTA	0-83	Los documentos de ventas construyen una biblioteca de contenidos para que todo su equipo cargue y comparta documentos con sus contactos.
ENVÍO_DE_COMENTARIOS	0-19	Almacena la información enviada a una encuesta de opinión.
SUSCRIPCIÓN	0-69	Las suscripciones contienen detalles de los pagos recurrentes
COMERCIO PAGO	0-101	Contiene datos sobre los fondos recaudados de los clientes

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 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 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.