HubSpot: Como exportar dados via API REST

O Ion se integra perfeitamente à HubSpot por meio de sua API REST. A integração do Ion com a HubSpot permite adicionar contatos à HubSpot em tempo real. Este artigo traz um passo a passo para você configurar e começar a aproveitar uma integração com a HubSpot.

Antes de começarmos

Existem algumas etapas que você precisa seguir no Ion antes de configurar a integração. São estas:

Confira a parte de "Antes de começar" no artigo de suporte para obter orientações de como criar esses itens.

• Crie campos de coleta de dados
• Crie formulários Ion
• Configure uma publicação de teste

Vamos começar!

1. Adicione credenciais da conta HubSpot ao Ion

1. Clique na aba "Integrations" no painel de navegação lateral do Ion Console.

2. Clique em "Set up account credentials" na parte superior da tela.

3. Em "HubSpot", clique em “New HubSpot credential”.

4. Adicione uma tag amigável para sua conta.

5. Salve.

6. Você será redirecionado para o HubSpot para autenticar as suas credenciais.

7. Depois de entrar na HubSpot, clique no botão "Grant access" para permitir que a plataforma Ion acesse sua conta HubSpot.

8. Após permitir o acesso, você retornará ao Ion Console. 

2. Crie um mapeamento de campo

Ao seguir os passos abaixo, você poderá mapear seus campos de coleta de dados do Ion para seus nomes de campo correspondentes da API da HubSpot. Para começar, adicione um novo mapeamento de campo:

1. Navegue até a tela "Integrations".

2. Clique no botão verde “New field mapping”.

3. Insira uma label e, opcionalmente, adicione uma descrição.

4. No menu "Integration type", selecione “HubSpot”.

5. Selecione suas credenciais HubSpot no menu suspenso.

6. Salve.

3. Adicionar campos de saída ao mapeamento de campo

Os campos de saída definem os dados que você conecta do Ion ao HubSpot.

1. Clique no botão verde “New outbound field”

2. Adicione um campo selecionando o tipo de campo no menu suspenso.

• Para adicionar um campo de formulário, campo oculto ou variável de string de consulta, selecione "Data field" e escolha a categoria do campo de dados e o campo de coleta de dados
• OU, para adicionar um campo core do Ion, selecione "Core Field" e escolha o campo que deseja incluir
• OU, para exportar vários campos do Ion para um campo externo, escolha "Mashup" e conecte {{DataName1}} {{DataName2}} etc. no editor
• OU, para reformatar um valor antes de exportar, escolha o "Javascript Code" e adicione lógica no valor coletado. Para acessar os campos de coleta de dados via Javascript, use respondent.dataname.

3. Opcionalmente, torne seu campo obrigatório para executar a integração.

4. Opcionalmente, adicione um valor padrão.

5. Selecione o campo HubSpot no menu suspenso no lado direito da tela.

6. Salve.

7. Repita essas etapas para cada campo que deve ser incluído no mapeamento de campos.

8. Pule a inclusão de campos de entrada.

4. Crie a integração

1. Navegue de volta para a tela "Integrations".

2. Clique na guia "Integrations".

3. Clique no botão verde “New integration”

4. Insira a label.

5. Opcionalmente, adicione uma descrição.

6. Selecione o mapeamento de campo que você acabou de criar.

7. Defina o número máximo de tentativas.

• Se houver alguma interrupção do serviço com a plataforma externa, o Ion tentará novamente a postagem na próxima hora por quantas tentativas você indicar aqui.

8. Selecione "Add Lead" como o método de API.

9. Opcionalmente, adicione-se à lista de distribuição de depuração para teste.

• Isso enviará um e-mail ao endereço cadastrado quando a integração for executada, mostrando a solicitação e a resposta da HubSpot.

5. Adicione a integração às páginas do Ion

A plataforma Ion executa a integração com base nas regras que você cria. As regras podem ser adicionadas a qualquer item acionável em sua publicação. As regras de integração são normalmente executadas no nível do formulário, no envio dos dados ou em uma etapa de avaliação. Siga os passos abaixo para adicionar a integração às suas páginas do Ion.

1. Navegue até a publicação.

2. Clique no formulário, botão ou link em que você deseja para criar o gatilho para executar sua integração.

3. No Creative Studio, clique em "+ Rules".

4. Selecione a condição que precisa ser atendida para executar a integração.

• “No conditions required” é normalmente a opção usada.

5. Selecione “Run integration” e, em seguida, selecione sua integração da HubSpot como a ação

6. Salve.

6. Teste a integração

Para testar sua integração, use a publicação que você configurou antes de iniciar. Note que as integrações não são executadas no modo de visualização, portanto, você deve abrir uma URL para testar. A integração será executada assim que você enviar o formulário do Ion ou concluir a ação que executa a regra de integração. Se você estiver na lista de envio de e-mail de depuração, receberá uma mensagem que mostra os dados transferidos e a resposta da HubSpot. Você também deseja verificar o sucesso garantindo que o lead foi criado em sua instância da HubSpot.

Bom trabalho!

Depois de concluir essas etapas, a sua integração está pronta para uso. Você pode adicionar a regra para executar a integração em todas as publicações aplicáveis. Se você encontrar qualquer problema, entre em contato com ion@rockcontent.com.