HubSpot

Conectar o HubSpot faz com que cada solicitação de cotação também se torne um contato que você pode acompanhar, sem que ninguém copie dados manualmente.

Cuidado

O HubSpot precisa de dois valores, não de um só: um Portal ID e um HubSpot access token. Ele também precisa de três escopos marcados no private app que emite o token. Se faltar qualquer um dos dois, a conexão parece configurada, mas não envia nada: a Etapa 1 cobre ambos.

Nota

O HubSpot consta no plano PRO. Klaviyo, Mailchimp e Shopify são as integrações incluídas no plano FREE. Veja Comparação de planos.

Se o seu plano não o inclui, a lista Third-party integration mostra um botão Upgrade desativado no lugar do ícone de configurações, com um cadeado ao lado. Ao selecionar o cadeado, o app explica qual plano o recurso exige e leva a Pricing plans. Isso é o plano, não uma falha.

Etapa 1: obtenha o Portal ID e o access token no HubSpot

O HubSpot não emite mais chaves de API clássicas. Em vez disso, você cria um private app dentro da sua conta do HubSpot, e ele fornece um access token. O Portal ID é separado: ele identifica a sua própria conta do HubSpot.

1. Encontre o seu Portal ID

   O seu Portal ID (também chamado de ID da conta ou hub ID) identifica em qual conta do HubSpot o app grava. Guia do próprio HubSpot: Check your current account.

   O mesmo link se repete no app, como o texto de ajuda Find your Portal ID abaixo do campo.

2. Crie um private app com os escopos certos

   Crie o private app dentro da sua conta do HubSpot. O guia do próprio HubSpot mostra como: Private apps.

   Antes de terminar de criá-lo, marque pelo menos estes três escopos:

   • forms
   • crm.objects.contacts.write
   • crm.schemas.contacts.write

   O app lista os mesmos três abaixo do campo do token, para que você possa conferi-los depois no seu private app.

   

   Captura de tela necessária. A tela de escopos do private app do HubSpot com forms, crm.objects.contacts.write e crm.schemas.contacts.write marcados.

3. Copie o access token

   O HubSpot mostra o token assim que o private app é criado. Copie-o e guarde em um lugar seguro enquanto conclui a configuração.

Perigo

Os escopos são a falha silenciosa. Um token criado sem forms, crm.objects.contacts.write e crm.schemas.contacts.write é um token perfeitamente válido: Enable continua ativado, o app salva sem reclamar e o HubSpot recusa todos os contatos enviados. Se os contatos nunca chegam, confira os escopos antes de qualquer outra coisa.

Cuidado

O app conecta as solicitações de cotação a um formulário do HubSpot, e não a uma lista de contatos. Crie esse formulário no HubSpot antes de começar: o menu suspenso só consegue oferecer formulários que já existem.

Etapa 2: conecte no app

1. Abra a aba Integrations

   No admin da Shopify, abra SA Request a Quote, selecione Advanced settings e abra a aba Integrations.

2. Selecione HubSpot

   Em Third-party integration, selecione HubSpot, descrito no app como “Seamlessly connect your submissions to your data”.

   A página do HubSpot é aberta, com um caminho Third-party para voltar à lista.

   

   Escolha o serviço e abra as configurações dele.

3. Ative Enable

   Ative Enable, o primeiro controle da página. Nada é enviado ao HubSpot até você fazer isso.

4. Cole as duas credenciais

   Os dois campos ficam logo abaixo de Enable, nesta ordem:

   1. Portal ID: cole o ID da conta da Etapa 1. O texto de ajuda dele é Find your Portal ID.
   2. HubSpot access token: cole o token do private app da Etapa 1. O texto de ajuda dele é Find or generate your access token, e abaixo o app exibe os escopos de que o token precisa: forms, crm.objects.contacts.write e crm.schemas.contacts.write.

   O campo se chama HubSpot access token, e não “API key”: o token é o que um private app emite.

   Preencha os dois. O app só busca os seus formulários do HubSpot quando tem o par completo, então uma página só com o token fica travada, sem nada para escolher. Se o menu suspenso não aparecer depois que você digitar, selecione Merge fields, ao lado do campo do token, para que o app busque de novo.

   

   O HubSpot precisa de dois valores, e eles não são intercambiáveis.

5. Escolha o formulário do HubSpot

   Abra Select a HubSpot form to integrate e escolha o formulário que as solicitações de cotação devem alimentar. Até você escolher, aparece “Please select a HubSpot form”.

   Se o app disser “It looks like you don’t have any HubSpot forms”, ou o formulário ainda não existe, ou uma das duas credenciais está errada, ou falta o escopo forms no token. Resolva isso antes de continuar: o mapeamento de campos fica oculto até que um formulário seja selecionado.

6. Associe os campos do formulário

   As linhas de mapeamento só aparecem quando o Portal ID, o HubSpot access token e o formulário estão definidos. As linhas vêm do formulário do HubSpot que você acabou de escolher, então são os campos desse formulário, e não uma lista fixa: escolha primeiro o formulário e as linhas o acompanham.

   Leia cada linha da esquerda para a direita:

   • À esquerda: o campo do HubSpot, esmaecido porque não pode ser renomeado.
   • No meio: como o valor é fornecido: has no value, is dynamic value by (pegar do formulário de cotação) ou is fixed value by (enviar o mesmo texto em todas as cotações).
   • À direita: o campo do formulário de cotação que você está enviando, ou o texto fixo que você digitou.

   Ou seja, você escolhe o valor do formulário de cotação à direita para preencher o campo do HubSpot indicado à esquerda, nunca o contrário.

   A linha de e-mail é a que você não pode pular: sem ela, não há contato para criar. Se o seu formulário coleta Company information, associe também o nome da empresa, para que a equipe de vendas veja quem está pedindo. Se um campo for obrigatório no formulário do HubSpot e você o deixar sem associação, o app sinaliza a linha e se recusa a salvar.

   

7. Salve

   Selecione Save. Nada é armazenado até você fazer isso, e uma página não salva não envia nada.

   Enquanto houver alterações não salvas, o app mostra uma barra de salvamento com Save e Discard changes; Discard changes descarta tudo o que você digitou na página. Uma mensagem Changes saved confirma o salvamento.

Nota

O Mailchimp mostra a mesma tabela de mapeamento de campos em detalhe. Siga-o só para o mapeamento: o Mailchimp precisa de uma única API key e escolhe uma lista, enquanto o HubSpot também precisa do Portal ID e escolhe um formulário.

Etapa 3: teste

Envie uma solicitação de cotação de verdade pela sua loja virtual e depois confira no HubSpot se o novo contato apareceu. Confirme que os campos associados realmente chegaram, e não apenas o endereço de e-mail.

Cuidado

Não pule o teste. Uma conexão pode parecer ativa e mesmo assim não entregar nada útil se os campos estiverem associados de forma errada, e você só percebe quando tenta usar os dados.

Essa é a ferramenta certa?

É a escolha certa se as cotações são tratadas por uma equipe de vendas, e não pelo marketing.

Se você ainda não usa o HubSpot, não o adote só para isso: o Zapier conecta os dados de cotação a quase tudo, e Criar um cliente Shopify após o envio mantém tudo dentro da Shopify no plano FREE.

Se os contatos não estiverem chegando

• Confira os escopos do seu private app. forms, crm.objects.contacts.write e crm.schemas.contacts.write precisam estar todos concedidos. Um token sem eles salva sem problemas e não entrega nada. Essa é a causa mais comum.
• Confira se Enable continua ativado. Nada é enviado enquanto estiver desativado.
• Confira o Portal ID, além do token. Um token correto com Portal ID ausente ou digitado errado deixa a conexão pela metade: o app não consegue carregar os seus formulários, então nada é enviado.
• Confira se o token ainda é válido. Girar um token no HubSpot interrompe a conexão até você colar o novo. Os tokens salvos aparecem mascarados, então cole um novo se tiver dúvida.
• Confira se você escolheu o formulário certo. Os contatos podem estar chegando em um lugar que você não está olhando.
• Confira se a linha de e-mail está associada. Sem ela, não há contato para criar.

Ainda com dificuldade? Envie um e-mail para [email protected].

Próximos passos

• Visão geral das integrações: as outras ferramentas que você pode conectar
• Criar um formulário B2B: colete dados da empresa que valem ser enviados a um CRM
• Comparação de planos: o que o plano PRO inclui