Hubspot: obter dados via REST API

Você pode aproveitar a integração Get Lead do Ion com a REST API do HubSpot para otimizar suas Ion experiences. Essa integração permite que você colete dados do HubSpot com base no endereço de e-mail de um visitante. Você pode aproveitar o Get Lead para preencher previamente (ou encurtar) os formulários do Ion, para segmentar automaticamente os visitantes e para criar perfis progressivos.

Este documento fornece instruções passo a passo para configurar uma integração REST API com o HubSpot para obter dados de leads. Neste artigo, usaremos a integração para preencher previamente um formulário Ion, mas, conforme observado, existem algumas maneiras diferentes de usar o Get Lead para aprimorar suas Ion experiences.

Antes de começar

Existem alguns itens que você precisa preencher no HubSpot antes de configurar a integração, listados abaixo.

Confira a postagem de suporte "Antes de começar" para obter orientação sobre como criar esses itens.

  • Crie campos de coleta de dados que vão armazenar dados HubSpot.
  • Crie Ion forms.
  • Configure publicações de teste.

Vamos começar!

1. Adicione as credenciais da conta HubSpot ao Ion

  1. Clique na guia Integrations na navegação lateral do Ion Console.
  2. Clique no botão Set up account credentials, na parte superior da tela.
  3. Em HubSpot, clique em New HubSpot credential.
  4. Adicione um Label para a sua conta.
  5. Salve.
  6. Você será redirecionado para o HubSpot para autenticar suas credenciais.
  7. Depois de entrar no HubSpot, clique no botão Grant access para permitir que a plataforma Ion acesse sua conta HubSpot.
  8. Após conceder acesso, você retornará ao seu Ion Console.

2. Crie Field mapping

Seguindo as etapas abaixo você poderá levar um valor de endereço de e-mail para o HubSpot e mapear os “Data points” correspondentes aos campos de coleta de dados do Ion. Para começar, adicione seu novo Field mapping.

  1. Vá para a tela Integrations.
  2. Clique no botão ver New field mapping.
  3. Nomeie o campo e, opcionalmente, adicione uma descrição.
  4. No menu Integration, selecione HubSpot.
  5. Salve.

3. Adicione Email Address como Outbound field

O valor de endereço de e-mail será usado como a chave para trazer dados do HubSpot.

  1. Clique no botão verde New outbound field.
  2. Selecione Data field no menu suspenso Source.
  3. Selecione Contact Info > Email Address.
  4. Marque Required para a integração funcionar.
  5. Selecione o campo correspondente no HubSpot Email Address.
  6. Salve. 

4. Crie Inbound fields

Os Inbound fields mapearão os dados que o HubSpot retorna em seus campos de coleta de dados correspondentes.

  1. Clique no botão verde New inbound field.
  2. No menu suspenso Target, selecione Data field e, em seguida, selecione o Ion data field que você deseja preencher com os dados do HubSpot.
  • Para pré-preencher os Ion forms com dados do HubSpot, certifique-se de selecionar o Data field usado no seu formulário.

3. Nos menus suspensos Source, selecione o campo HubSpot do qual você deseja extrair dados.

4. OU selecione o código Javascript se quiser transformar os dados do HubSpot antes de armazená-los na Ion data collection.

  • Use responseBody.HubSpot_field_name para acessar o campo HubSpot via Javascript.

5. OU selecione Response body para salvar a resposta do HubSpot para um Ion data field.

6. Salve.

7. Repita essas etapas para cada campo de dados HubSpot que deseja salvar na Ion data collection.

5. Crie Integrations

  1. Navegue de volta para a tela Integrations.
  2. Clique na aba Integrations.
  3. Clique no botão verde New integration.
  4. Insira um Label.
  5. Opcionalmente, adicione uma descrição.
  6. Selecione o Field Mapping que você acabou de criar.
  7. Pule a opção Maximum retries.
  8. Selecione Get Lead como o API method.
  9. Selecione o campo Outbound Email Address.
  10. Opcionalmente, adicione-se à Debug distribution list para teste.
  • Isso entregará um e-mail ao endereço designado quando a integração for executada, exibindo a solicitação e a resposta do HubSpot.
  • Marque Only send error emails se quiser receber o e-mail de depuração apenas quando houver um erro.

6. Adicione Integrations às páginas Ion

A plataforma Ion executa a integração com base nas regras que você cria. Para o HubSpot Get Lead, a regra normalmente executará a integração no nível da página da landing page. Você pode, no entanto, executar a integração em qualquer etapa acionável na sua Ion experience. As etapas abaixo descrevem como adicionar a regra no nível da página para preencher um Ion form com dados do HubSpot.

  1. Navegue até a publicação de teste com o formulário que você configurou antes de iniciar as etapas de integração.
  2. Na aba Page, no Creative Studio, clique em +RULES.
  3. Adicione a seguinte regra.
  • Condition: nenhuma condição necessária.
  • Action: Run integration (selecione a integração HubSpot Get Lead).

4. Salve.

7. Teste as Integrations

Observe que as Integrations não são executadas no modo de visualização, então você deve abrir um URL para sua publicação de teste. Passe o endereço de e-mail para sua página Ion na Query string ou envie seu formulário inicial que coleta o endereço de e-mail. Se passar o endereço de e-mail para o Ion na Query string, certifique-se de que o nome do parâmetro anexado ao URL corresponda ao Data name do Ion data collection field selecionado como o Outbound field em seu Field mapping.

Assim que a integração for executada, o formulário que você preencheu previamente exibirá os dados recuperados do HubSpot. Se estiver na Debug email distribution list, você receberá um e-mail que exibe a solicitação e a resposta do HubSpot.

Bom trabalho!

Depois de concluir essas etapas, sua integração está pronta para uso. Você pode adicionar a regra para executar a integração em todas as publicações aplicáveis.

Conforme observado, o HubSpot Get Lead pode ser usado para cumprir outros objetivos. Aqui estão alguns exemplos que podem ser realizados usando essa integração e o mecanismo de regras do Ion:

  • encurtar ou substituir formulários;
  • segmentar automaticamente os visitantes;
  • criar perfis progressivos;
  • distribuir conteúdo dinâmico com base nos dados HubSpot.

Sinta-se à vontade para enviar uma mensagem para ionsupport@scribblelive.com para obter ajuda no uso dessa integração.