Como fazer o registro de leads na HubSpot Take Blip 23 de agosto de 2021 12:21 Atualizado Hubspot é uma ferramenta de CRM extremamente completa, que integra o time de marketing e vendas como um todo. Trabalhar com um bot integrado a Hubspot pode ser muito vantajoso para potencializar os resultados de vendas da empresa. 1.1. Como funciona o Registro de Lead Todo usuário que interage com o bot possui uma variável de contato associada que pode ser utilizada para salvar informações importantes adquiridas ao longo do fluxo conversacional. Uma vez que estas informações estão disponíveis nesta variável, é possível criar e/ou atualizar o lead (contato) na HubSpot. Na versão atual da integração é possível registrar leads em uma ou mais contas distintas da HubSpot (que é uma evolução da versão anterior que só permitia integrar apenas uma conta) a partir de um ou mais bots. O passo a passo de como definir isto será melhor explicitado na seção de configuração da integração. 1.2. Requisitos Antes de tentar registrar um lead na HubSpot é necessário que em seu bot já tenha sido instalado o plugin da integração da HubSpot previamente. Caso não tenha realizado esse processo, saiba Como instalar o aplicativo de integração da HubSpot 2. Configurando seu bot para registrar o lead Como abordado previamente, as informações dos clientes, salvas no contato do Blip, serão utilizadas para registrar o lead na HubSpot. Sendo assim, é necessário assegurar que todas as informações (que você deseja integrar à HubSpot) de seu cliente, sejam devidamente perguntadas e salvas ao longo do fluxo de conversa, para posteriormente salvá-las no contato. Atualmente o e-mail do contato é uma informação obrigatória para que o lead seja criado pela primeira vez na HubSpot, caso contrário o registro não ocorrerá. Sendo assim, faz-se necessário obter tal informação do usuário no fluxo do bot. Importante: Após cadastrar o lead pela primeira vez na HubSpot, o email do contato pode ser alterado sem maiores problemas em todos os canais, exceto naqueles onde a sessão do usuário possui um tempo de expiração, como o Blip Chat. Outra informação importante a se ter em mente é que ao registrar cada contato na HubSpot, ele passará a ter em seu extras uma propriedade chamada hubSpotContactId. Esta propriedade guarda informações vitais do contato na HubSpot. Por isso jamais apague esta propriedade. 2.1. Salvando as respostas do usuário em uma variável Sempre que houver a possibilidade de resposta do usuário e houver o desejo de salvar este dado na HubSpot é necessário, primeiramente salvar a entrada do usuário em uma variável. Uma das formas de fazer isto é: No bloco em que se deseja salvar a resposta do usuário clicar em “Entrada do usuário”: Após isso, habilitar a opção “Salvar resposta em variável” e dar um nome qualquer a variável, como explicitado abaixo: Desta forma, esta variável poderá ser utilizada posteriormente na definição de contato. Caso seja necessário tratar (por qualquer motivo) a resposta do usuário pode ser necessário definir uma ação de Execução de Script e salvar a resposta na variável desejada. Estes passos podem ser consultados aqui. 2.2. Definindo o contato Após salvar em variáveis todas as informações desejadas basta criar uma ação de definição de contato para que tais dados sejam salvos no contato do cliente. Para isto há duas formas possíveis de realizar este processo (escolha apenas uma delas). Definir contato localmente A primeira opção é criar uma ação de definição de contato (em Ações de Saída) em cada um dos blocos (ou seja localmente) onde o usuário disponibiliza a informação desejada, salvando apenas aquela informação em questão. Por exemplo, caso haja um bloco pedindo o email, será criado uma definição de contato, em ações de saída, salvando o email, como mostrada abaixo: E assim sucessivamente para os demais blocos que pedem a informação desejada do usuário. Definir contato globalmente A segunda opção é definir o contato de forma global, desta forma é necessário apenas criar a ação, nas ações globais de seu bot e não mais em cada bloco específico. Para isto siga os passos abaixo: Acessar configuração: Em ações globais criar a ação de saída: definir contato: Salvar todas as informações desejadas (já definidas em suas respectivas variáveis) de uma só vez: Desta forma esta ação de salvar o contato será executada globalmente. Mais informações sobre a ação de definição de contato podem ser encontradas neste link. 2.3. Ação de requisição HTTP para a API da HubSpot Neste passo é necessário configurar a requisição que irá de fato, enviar os dados do lead (contato) para a HubSpot. Para isto é necessário definir uma ação de requisição HTTP (em ações de saída) nas ações globais do bot. Acesse o seguinte caminho no builder: Configuração >> Ações Globais >> Adicionar Ação de Saída >> Requisição HTTP Ao clicar na ação Requisição HTTP faz-se necessário preencher algumas informações necessárias para que a mesma seja executada com sucesso. Segue a configuração informando o nome do parâmetro e o seu valor correspondente: Método: POST URL: https://hubspot.cs.blip.ai/api/HubSpot/v2/lead/management Cabeçalhos: Clique na opção "adicionar cabeçalho" e adicione os seguintes cabeçalhos. O botId se refere ao campo Key[a]. O seu valor é explicado abaixo: botId: <O id do roteador caso a integração tenha sido instalada nele> ou <o id do bot que está sendo feita essa configuração caso não possua roteador>. Esta informação pode ser encontrada na página inicial do seu bot/roteador como mostrado na imagem a seguir: Importante: Para que o registro de lead venha funcionar é necessário que a integração da HubSpot tenha sido instalado no bot corrente ou no roteador (caso seus bots sejam ligados em um roteador). No primeiro caso você usa o id do bot filho. Já no segundo caso utilize, necessariamente, o id do roteador (sendo inclusive a forma recomendada: instalar o plugin e as integrações pelo roteador e usar o id do roteador nos bots filhos para realizar requests na API da HubSpot). Corpo: Ao clicar na opção corpo defina-o com o valor mostrado abaixo e aperte ctrl + s para salvar: { "contact" : {{contact.serialized}}, "integrations" : [ "Integração 1", "Integração 2", ] } Importante: A propriedade integrations é a única que pode ser alterada no corpo mostrado acima. Ela irá definir para quais contas da HubSpot o registro de lead deve acontecer. Para isto basta especificar um por um o nome da integração que corresponde a cada uma das contas da HubSpot que você deseja integrar (lembre-se que os nomes da integrações informados devem corresponder às integrações cadastradas no bot em que o plugin foi instalado). Para consultar os nomes de integrações disponíveis basta acessar o plugin de Integração da HubSpot. Sempre escreva os nomes das integrações exatamente como mostrado no Plugin, entre as aspas duplas (“”) e separando cada nome de integração por vírgula (como mostrado no exemplo acima). Caso queira que o registro de lead ocorra para todas as integrações (contas da HubSpot) atualmente disponíveis no bot em questão, basta apenas definir a propriedade integrations como vazia, como mostrado abaixo: { "contact" : {{contact.serialized}}, "integrations" : [] } Um exemplo do corpo da ação de requisição HTTP para registrar o lead nas contas nomeadas por Integração 1 e Integração 2 é: Variável para Status da resposta: <Qualquer nome desejado>, porém recomendamos leadStatus. Variável para o corpo da resposta: <Qualquer nome desejado>, porém recomendamos leadResponse. Desta forma sua configuração estará como exibido na figura abaixo (apenas diferindo o valor do botId): Para mais informações sobre ação Requisição HTTP consulte este link. 2.4. Considerações Finais Portanto, para que o seu bot esteja apto a realizar o registro de lead é necessário: Salvar as informações desejadas ao longo do fluxo conversacional. Configurar a ação de definição de contato. Definir uma ação de Requisição HTTP que irá enviar as informações do contato à HubSpot. Lembrando que caso tenha optado por configurar a definição de contato globalmente, necessariamente deverá haver a seguinte a ordem nas ações globais: primeiro é criada a ação de Definição de contato e após isto é definida a ação de Requisição HTTP, como mostrado a seguir (em Configuração >> Ações Globais): Caso tenha optado pela definição de contato localmente, em ações globais somente haverá a ação de Requisição HTTP em ações de saída, uma vez que a definição de contato está sendo feito localmente nos blocos. 3. Registro de lead na HubSpot A seguir estão descritas algumas orientações sobre o funcionamento e validação do registro de lead no lado da HubSpot. 3.1. Validando o registro de lead Uma vez que todas as configurações descritas acima tenham sido realizadas corretamente, quando os usuários interagirem com o bot, o registro do lead deverá ser criado com sucesso na HubSpot na seção de contatos, como demonstrado abaixo: 3.2. Propriedades do contato As propriedades padrão do contato do Blip, a saber: nome, e-mail, cidade, telefone e gênero já existem na HubSpot. Desta forma será feito um mapeamento direto destas propriedades já existentes. 3.2.1. Propriedades customizadas As propriedades customizadas (extras) do Contato do Blip e que ainda não existem na HubSpot, serão automaticamente criadas como novas propriedades do contato. Importante: Todas as propriedades customizadas (extras) do Contato do Blip, são entendidas, necessariamente, como texto (string). Sendo assim, as propriedades criadas na HubSpot pela primeira vez, por meio do extras do Contato do Blip, serão criadas como tipo string. A fim de verificar estas propriedades na HubSpot, bem como todas as outras, siga os passos: Clique no contato desejado e em Ações -> Exibir todas as propriedades Após isto basta selecionar a opção Informações de Contato e procurar pela propriedade desejada. 3.2.2. Propriedades já existentes na HubSpot Se uma propriedade do contato já existe na HubSpot e deseja-se preencher esta propriedade com informações obtidas no fluxo conversacional do seu bot é necessário primeiramente saber o nome interno desta propriedade na HubSpot. Para isto: Clique em configurações (símbolo de engrenagem) e em seguida selecione propriedades. Ao clicar na propriedade desejada, uma nova tela se abrirá, onde será possível clicar no símbolo </> onde será mostrado o nome interno da propriedade, como exibido abaixo. É este o nome interno da propriedade que deve ser copiado e utilizado na definição de contato (na propriedade extras) caso seja necessário, como exemplificado abaixo: Importante: Como já citado anteriormente, todos os extras do contato do Blip são entendidos como texto (string). Sendo assim, para poder utilizar uma propriedade já previamente criada na HubSpot, ela precisa ser do tipo string (texto), caso contrário esta propriedade não será preenchida no momento da integração. Exemplo: Se um campo, chamado idade, já existe na HubSpot, ele precisa ser do tipo string, para que o Blip consiga preencher seu valor com sucesso. Em outras palavras, as propriedades já existentes na Hubspot precisam ser do tipo texto, mesmo que o campo espere receber número ou outro tipo que não é expressamente texto (string).
