Conecte o HubSpot e o AWS S3 (BETA)

Aprenda como conectar o HubSpot e o AWS S3 para sincronizar dados do HubSpot com seu bucket S3. 

Conecte o HubSpot e o AWS S3

Para conectar o HubSpot e o AWS S3, você deve seguir os passos abaixo na ordem: 

1. Configurar permissões de acesso para o bucket AWS S3
2. Criar uma política de IAM
3. Crie a função IAM na AWS
4. Conecte o HubSpot e o AWS S3
5. Conceda ao usuário do IAM permissões para acessar objetos do bucket S3

1. Configurar permissões de acesso para o bucket S3

O HubSpot precisa das seguintes permissões em um bucket e pasta do AWS S3 para acessar arquivos na pasta e subpastas:

• s3:ObterLocalizaçãoBucket
• s3:ObterObjeto
• s3:ObterVersãoDoObjeto
• s3:ListBucket
• s3:ColocarObjeto
• s3:ExcluirObjeto

2. Criar uma política de IAM

• Faça login no Console de gerenciamento da AWS.
• No painel inicial, clique em Serviços > Segurança, Identidade e Conformidade > EU SOU.
• Na barra lateral esquerda, clique em Configurações de Conta.
• No Serviço de Token de Segurança (STS) seção, procure a região da AWS que corresponde à região em que sua conta da AWS está localizada. Clique para alternar o interruptor sobre para ativar a região.
• No painel lateral esquerdo, clique em Políticas. 
• Clique Criar política. 
• No JSON aba, clique Adicionar nova declaração. 
• Adicione o documento de política abaixo que dará ao HubSpot as permissões necessárias para carregar ou descarregar dados usando um único bucket e caminho de pasta. Você também pode limpar arquivos de dados usando a opção de cópia 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>/*"
 ]
 }
 }
 }
 ]
}

• Clique em Próximo.
• No Revisar e criar seção, adicione o Nome da política e um opcional descrição. 
• Clique Criar política. 

3. Crie a função IAM na AWS

Para configurar permissões de acesso para o HubSpot no AWS Management Console:

• Faça login no Console de gerenciamento da AWS.
• No painel inicial, clique em Serviços > Segurança, Identidade e Conformidade > EU SOU.
• Na barra lateral esquerda, clique em Funções. 
• Clique Criar função. 
• No Tipo de entidade confiável seção, selecione Conta AWS.
• No Uma conta AWS seção, selecione Outra conta AWS e insira seu próprio ID de conta da AWS. Mais tarde, você alterará a relação de confiança para dar acesso ao HubSpot. 
• Selecione Exigir ID externo e insira um ID de espaço reservado como 0000. Mais tarde, você alterará o relacionamento de confiança para sua função do IAM e especificará o ID externo para sua integração de armazenamento. Um ID externo é usado para conceder acesso aos seus recursos da AWS a um aplicativo de terceiros, como o HubSpot. 

• Clique em Próximo. 
• Selecione a política criada na Etapa 1 e clique em Próximo.
• No Detalhes da função seção, insira um Nome da função e Descrição para identificar a função. 
• Clique Criar função. 
• No Página de resumo da função, copie o ARN valor. Você usará esse valor na próxima etapa. 

4. Conecte o HubSpot e o AWS S3

• Certifique-se de que sua conta HubSpot esteja optou por esta versão beta: Acesse dados do HubSpot no AWS S3. 
• Navegar para esta URL e selecione sua conta HubSpot.
• No canto superior direito, clique em Instalar aplicativo. 
• Entre no Nome da função do IAM configurado na Etapa 3 e o Caminho da URL S3 para o bucket no qual você deseja que os dados sejam despejados. 
• Clique Próximo.
• Revise e copie o Usuário do AWS IAM e ID externo da AWS valores, pois você precisará deles na próxima etapa. Então, clique Continuar para aplicativos conectados.

5. Conceda ao usuário do IAM permissões para acessar objetos do bucket

• Faça login no Console de gerenciamento da AWS.
• No painel inicial, clique em Serviços > Segurança, Identidade e Conformidade > EU SOU.
• Na barra lateral esquerda, clique em Funções.
• Selecione a função que você criou na Etapa 3. 
• Selecione o Relações de confiança tab e clique Editar política de confiança. 
• Modifique os documentos da política com os valores registrados na Etapa 3. 

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

Na política acima, altere os dois campos a seguir para os valores registrados na Etapa 4:

• usuário_hubspot_arn para o ARMAZENAMENTO_AWS_IAM_USER_ARN valor
• ID_externo_do_hubspot para o ARMAZENAMENTO_AWS_EXTERNO_ID valor 

Após concluir as etapas acima, o HubSpot pode sincronizar dados no AWS S3.

Formato de dados para sincronização entre HubSpot e AWS S3

Dados disponíveis para sincronização

Você pode sincronizar os seguintes dados do HubSpot para o AWS S3: 

• Objetos: objetos padrão e personalizados, como contatos, empresas, tickets ou produtos.
• Registros: registros de objetos individuais. 
• Associações: todos os tipos de associação e registros associados.
• Eventos: dados de eventos para eventos padrão do HubSpot e eventos comportamentais personalizados. 
• Listas: Listas de contatos e empresas do HubSpot.
• Proprietários: detentores de recordes. 
• Tubulações: pipelines de negócios e tickets e estágios do pipeline. 
• Propriedades: propriedades e seus valores nos registros de objetos, incluindo o histórico de propriedades. 

Dados de objetos de diferentes tipos são organizados e disponíveis de duas maneiras:

• Individual: eCada tipo de objeto é armazenado em sua própria tabela e possui apenas registros do mesmo tipo de objeto. Por exemplo, objects_contacts contém apenas registros de contato.
• Combinado: aTodos os registros de todos os tipos de objetos são combinados em um único objeto de banco de dados. Portanto, ao consultar, você precisa especificar um filtro como “WHERE objectTypeId='0-1'

Objetos personalizados será atribuído um ID no momento da criação e será identificado como 2-ID_único. Por exemplo, 2-12345. 

tabelas objects_x

Cada tipo de objeto disponível, incluindo objetos personalizados, tem sua própria tabela específica. Essas tabelas são nomeadas seguindo o formato OBJECTS_<object type name> onde <object type name> é o plural do rótulo objecttype. (Observe que se o tipo de objeto não tiver forma plural, então <object type name> será o rótulo de forma singular do nome do tipo de objeto concatenado com “S”).

Abaixo está uma lista completa dos tipos de objetos do HubSpot disponíveis, uma breve descrição dos dados que eles representam e suas tabelas correspondentes.

object_with_object_properties

Esta tabela contém dados dos seus registros do HubSpot. Você pode obter uma linha para cada registro dentro de um objecttype (por exemplo, todos os registros de contato no objecttype contacts). 

object_properties_history

Esta tabela contém valores históricos de propriedades. Para contatos, contém os 45 valores mais recentes. Para todos os outros objetos, ele contém os 20 valores mais recentes. A tabela tem uma linha para cada valor histórico da propriedade. O valor atual de uma propriedade é determinado pelo registro de data e hora UPDATEDAT mais recente no histórico da propriedade.

Consultas de associação

Assim como os dados de objetos, os dados de associações são organizados de duas maneiras:

• Individual: cada tipo de associação é armazenado em sua própria tabela e contém apenas registros desse tipo. Por exemplo, associations_contacts_to_deals contém apenas registros de associação entre objetos de contato e negócio. E
• Combinado: todos os registros para todos os tipos de associação são combinados em uma tabela.

associações_x_para_y 

Cada tipo de associação tem sua própria visão, rotulada como associations_<association type name> por exemplo associations_contacts_to_deals. 

association_definitions

Esta tabela contém informações sobre todos os tipos de associação disponíveis entre objetos do HubSpot, com uma linha por tipo de associação.

property_definitions

Esta tabela contém informações sobre propriedades do objeto e propriedades de eventos na sua conta HubSpot. As propriedades do evento incluem eventos padrão, como aberturas e cliques de e-mail, e evento comportamental personalizado propriedades. Essas informações podem ser úteis para definir valores encontrados em propriedades_do_objeto e eventos dados.

Eventos

Os eventos incluem eventos padrão do HubSpot e eventos comportamentais personalizados. Cada evento tem sua própria tabela, rotulada como events_eventname.

object_and_event_type_definitions

Esta tabela contém definições para todos os objetos e eventos disponíveis na sua conta HubSpot.

Frequência de sincronização e organização de dados

Sincronização de dados diário entre HubSpot e AWS S3. Uma pasta será criada para cada dia em que os dados forem sincronizados. Cada uma das tabelas a seguir estará disponível como uma pasta com arquivos CSV compactados:

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

Haverá várias subpastas para cada tabela. Se o tamanho da tabela exceder 15 MB, haverá vários arquivos CSV compactados em cada pasta da tabela.