Consulte os conetores suportados para a solução Application Integration.

Acionador do HubSpot

Pré-visualização — HubSpot trigger

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

O acionador do HubSpot é um acionador de eventos do conector que lhe permite invocar uma integração com base nos eventos personalizados do HubSpot que definiu na sua instância do HubSpot.

Importante: os conetores de integração são um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças da utilização dos Conetores de integração, consulte o artigo Preços dos Conetores de integração.

Antes de começar

Se planeia criar ou configurar uma nova associação para o acionador do HubSpot, certifique-se de que tem a seguinte função de gestão de identidades e acessos (IAM) no projeto:

• Administrador do conetor (roles/connectors.admin)

Para informações sobre a concessão de funções, consulte o artigo Faça a gestão do acesso.

Conceda as seguintes funções do IAM à conta de serviço que quer usar para o acionador do HubSpot:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Tipos de eventos suportados

Com as subscrições de webhook, pode selecionar os eventos que a sua app recebe. São suportados os seguintes tipos de subscrição:

• deal.creation
• deal.propertyChange
• deal.deletion
• contact.creation
• contact.propertyChange
• contact.deletion

Adicione o acionador do HubSpot

Para adicionar um acionador do HubSpot à sua integração, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Integrações

   A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar.

   A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
5. Clique e coloque o elemento Acionador do HubSpot no editor de integração.

Para configurar o acionador do HubSpot, pode usar uma associação do HubSpot existente disponível nos conectores de integração ou criar uma nova associação do HubSpot através da opção de criação de associação inline.

Configure o acionador da HubSpot através de uma associação existente

Pode configurar o acionador do HubSpot através de uma ligação existente do HubSpot nos Integration Connectors. O acionador do HubSpot é um acionador de eventos do conetor. Por isso, só pode usar uma ligação do HubSpot com a subscrição de eventos ativada para configurar o acionador.

Para obter informações sobre como configurar um acionador do HubSpot através de uma nova associação do HubSpot, consulte o artigo Configure o acionador do HubSpot através de uma nova associação

Para configurar um acionador do HubSpot através de uma ligação existente do HubSpot, siga estes passos:

1. Clique no elemento Acionador do HubSpot no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Forneça os seguintes detalhes de configuração na página Editor do acionador de eventos do conetor:
   1. Região: selecione a região da sua ligação ao HubSpot.
   2. Associação: selecione a associação do HubSpot que quer usar.

      A integração de aplicações só apresenta as associações da HubSpot que estão ativas e têm uma subscrição de eventos ativada.

   3. Tipo de evento: selecione o tipo de evento que quer usar para acionar a integração. Para ver uma lista dos tipos de eventos suportados, consulte o artigo Tipos de eventos suportados.
   4. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para o acionador do HubSpot.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador do HubSpot através de uma nova associação

Para configurar o acionador do HubSpot através de uma nova associação do HubSpot, siga estes passos:

1. Clique no elemento Acionador do HubSpot no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Ignore o campo Região.
4. Clique em Associação e selecione a opção Criar associação no menu pendente.
5. Conclua os seguintes passos no painel Criar associação:
   1. No passo Localização, escolha a localização para a nova associação do HubSpot:
      1. Região: selecione uma região na lista pendente.
      2. Clicar em Seguinte.
   2. Na secção Detalhes da associação, conclua o seguinte:
      1. Conetor: selecione HubSpot na lista pendente de conetores disponíveis.
      2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
      3. No campo Nome da ligação, introduza um nome para a instância de ligação.

         Os nomes das associações têm de cumprir os seguintes critérios:

         • Os nomes das associações podem usar letras, números ou hífenes.
         • As letras têm de ser minúsculas.
         • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das associações não podem exceder 49 carateres.
         • Para os conetores que suportam a subscrição de eventos, os nomes das associações não podem começar com o prefixo "goog".
      4. Opcionalmente, introduza uma Descrição para a instância de associação.
      5. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
      6. Para usar a associação para subscrições de eventos, selecione Ativar subscrição de eventos. Se selecionar esta opção, são apresentadas as seguintes opções:
         • Ativar subscrição de eventos com entidade e ações: selecione esta opção para usar a associação para a subscrição de eventos e as operações do conetor (entidades e ações).
         • Ativar apenas subscrição de eventos: selecione esta opção para usar a associação apenas para a subscrição de eventos. Se selecionar esta opção, clique em Seguinte e, de seguida, configure a subscrição de eventos.
      7. Esquema: especifique a versão da API HubSpot a usar. O HubSpotV4 é a nova API.
      8. BrowsableSchemas: esta propriedade restringe os esquemas comunicados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
      9. Propriedades de contactos: introduza os nomes dos campos separados por vírgulas da entidade Contacts que quer selecionar na operação da entidade List. Por exemplo, fieldA, fieldB, fieldC
      10. Companies Properties: introduza os nomes dos campos separados por vírgulas da entidade Companies que quer selecionar na operação da entidade List. Por exemplo, fieldA, fieldB, fieldC
      11. Propriedades de acordos: introduza os nomes dos campos separados por vírgulas da entidade Deals que quer selecionar na operação da entidade List. Por exemplo, fieldA, fieldB, fieldC
      12. Usar proxy: selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
      13. Esquema de autenticação de proxy: o tipo de autenticação a usar para autenticar no proxy ProxyServer.
      14. Utilizador do proxy: um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
      15. Palavra-passe do proxy: uma palavra-passe a usar para a autenticação no proxy ProxyServer.
      16. Tipo de SSL do proxy: o tipo de SSL a usar ao ligar ao proxy ProxyServer.
      17. Opcionalmente, configure as definições do nó de associação:
          • Número mínimo de nós: introduza o número mínimo de nós de ligação.
          • Número máximo de nós: introduza o número máximo de nós de ligação.

          Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

      Nota: só pode personalizar os valores dos nós de associação se for cliente de pagamento conforme o uso.
      18. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
      19. Clicar em Seguinte.
   3. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
      1. Tipo de destino: pode especificar os detalhes do destino como um endereço de anfitrião ou um anexo de serviço. Selecione um dos seguintes tipos de destinos:
         • Endereço do anfitrião: se quiser especificar o nome de anfitrião ou o endereço IP do destino.
         • Associação de serviços: se quiser especificar o ponto final privado para os seus endereços IP internos. A associação de serviços permite-lhe ocultar os seus endereços IP internos da rede externa. Pode criar uma associação do serviço no Google Cloud através da funcionalidade Private Service Connect. Para obter informações sobre a configuração de um Private Service Connect, consulte o artigo Publique serviços geridos.

         Com base na sua seleção do tipo de destino, introduza o endereço do anfitrião ou o nome da associação de serviço.

         Para introduzir destinos adicionais, clique em +Adicionar destino.

      2. Clicar em Seguinte.
   4. Na secção Autenticação, introduza os detalhes de autenticação.
      1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

         Os seguintes tipos de autenticação são suportados pela associação do HubSpot:

         • Token de acesso a apps privadas: selecione o segredo do Secret Manager que contém o token de acesso a apps privadas.

           As apps privadas permitem-lhe usar as APIs da HubSpot para aceder a dados específicos da sua conta da HubSpot. Pode autorizar o que cada app privada pode pedir ou alterar na sua conta, o que gera um token de acesso exclusivo da sua app privada. Na sua app privada, certifique-se de que concedeu, pelo menos, a autorização de leitura aos seguintes âmbitos:

           • crm.schemas.line_items.read
           • crm.schemas.quotes.read
           • crm.schemas.deals.read
           • crm.schemas.companies.read
           • crm.schemas.custom.read
           • crm.schemas.contacts.read

           Para mais informações, consulte o artigo Apps privadas.

      2. Clicar em Seguinte.
   5. Se ativou a subscrição de eventos, a secção Detalhes da subscrição de eventos é apresentada na página de criação da associação. No passo Detalhes da subscrição de eventos, indique os detalhes de autenticação que vão ser usados para validar a carga útil do token do HubSpot:
      1. Segredo do cliente: (opcional) selecione o segredo do Secret Manager do segredo do cliente da sua app privada e a versão do segredo correspondente no menu pendente Versão do segredo.

      Para mais informações, consulte o artigo Apps privadas.

      2. Selecione Ativar conetividade privada para uma conetividade segura entre a sua aplicação de back-end e a sua ligação. Se selecionar esta opção, tem de realizar passos de configuração adicionais depois de criar a associação. Para mais informações, consulte o artigo Conetividade privada para subscrição de eventos.
      3. Introduza a configuração de mensagens não entregues. Se configurar a fila de mensagens rejeitadas, a ligação escreve os eventos não processados no tópico Pub/Sub especificado. Introduza os seguintes detalhes:
         1. ID do projeto de mensagens não entregues: o ID do projeto do Google Cloud onde configurou o tópico Pub/Sub de mensagens não entregues.
         2. Tópico de mensagens não entregues: o tópico do Pub/Sub onde quer escrever os detalhes do evento não processado.
      4. Clicar em Seguinte.
   6. Rever: reveja os detalhes da ligação e da autenticação.
   7. Clique em Criar.

Crie e edite subscrições de webhook

Para concluir a configuração da subscrição de eventos, tem de registar o URL do webhook na sua aplicação HubSpot. Por conseguinte, após a criação da associação ser bem-sucedida, execute os seguintes passos adicionais:

1. Aceda à página de detalhes da associação recém-criada e copie o URL do webhook para a subscrição de eventos. O URL do webhook é necessário quando cria uma subscrição de webhook no passo seguinte.

   A imagem seguinte mostra o campo Ponto final do ouvinte de eventos na página de detalhes da associação do HubSpot:

   
2. Siga os passos para criar e editar subscrições de webhooks no HubSpot.

Saída do acionador

O acionador do HubSpot demora alguns minutos a concluir a configuração da subscrição de eventos. Pode ver o estado da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

O acionador do HubSpot indica o estado de uma subscrição de eventos através dos seguintes estados:

• Creating: indica que o acionador está a subscrever a subscrição de eventos.
• Active: indica que o acionador subscreveu com êxito uma subscrição de eventos.
• Error: indica que existe um problema com a subscrição de eventos configurada.

Além do estado da subscrição de eventos, a secção Detalhes da subscrição de eventos também apresenta outros detalhes, como a região da associação, o nome da associação, o nome da subscrição de eventos e muito mais.

A imagem seguinte mostra um exemplo de esquema do painel de configuração do acionador do HubSpot:

Variável de saída do acionador

Para cada evento, o acionador do HubSpot gera uma variável de saída ConnectorEventPayload que pode usar nas tarefas subsequentes. A variável de saída está no formato JSON e contém o esquema do payload de saída do HubSpot.

Veja as subscrições de eventos

Para ver e gerir todas as subscrições de eventos associadas a uma ligação nos Integration Connectors, faça o seguinte:

1. Aceda à página Integration Connectors > Ligações.

   Aceda à página Ligações

2. Clique na associação para a qual quer ver as subscrições.
3. Clique no separador Subscrições de eventos.

   Esta apresenta todas as subscrições de eventos da associação.

Edite o acionador da HubSpot

Pode editar um acionador do HubSpot para alterar ou atualizar a configuração da associação e os detalhes da subscrição de eventos.

Importante: quando edita ou modifica um acionador do HubSpot, pode manter a subscrição de eventos configurada anteriormente que está anexada ao acionador ou pode eliminá-la. A eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam essa subscrição de eventos.

Para editar um acionador do HubSpot, siga estes passos:

1. Clique no elemento Acionador do HubSpot no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador do HubSpot.
3. Faça o seguinte na página Editor de acionadores de eventos do conetor:
   1. Para manter a subscrição de eventos configurada anteriormente, clique em Manter. Caso contrário, clique em Eliminar.
      Aviso: a eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam a subscrição de eventos. Não é possível anular esta tarefa.
   2. Atualize a configuração da associação e os detalhes da subscrição de eventos conforme pretendido.
   3. Clique em Concluído.

Pode ver os detalhes atualizados da associação e da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais acerca do processamento de erros.
• Saiba mais sobre os registos de execução da integração.