Identificação do visitante

Produtos suportados

Requer um dos seguintes produtos ou superior.

Marketing HubProfessional

Sales HubProfessional

Service HubProfessional

Content HubProfessional

​

Exemplo de fluxo de integração

• Defina as propriedades hsConversationsSettings fora da função isConversationsAPIReady.
• Além disso, o hsConversationsSettings precisa ser definido antes da chamada; caso contrário, você poderá enfrentar uma condição que poderá interferir no carregamento do widget.

window.hsConversationsSettings = {
  loadImmediately: false,
};

curl --request POST \
  --url 'https://api.hubspot.com/conversations/v3/visitor-identification/tokens/create \
--data '{
  "email": "gob@bluth.com",
  "firstName": "Gob",
  "lastName": "Bluth"
}'

window.hsConversationsSettings = {
  identificationEmail: 'visitor-email@example.com',
  identificationToken: '<TOKEN FROM STEP 1>',
};

window.HubSpotConversations.widget.load();

​

Verifique a integração

• Se você adicionou o widget de chat a uma ou mais páginas públicas, bem como atrás de um sistema de autenticação:
  • Navegue até uma página onde o widget de chat não deveria identificar visitantes e inicie uma conversa.
  • No HubSpot, abra a caixa de entrada e verifique se o chat que acabou de chegar pertence a um Visitante desconhecido. Se não for esse o caso, tente seguir estas etapas em uma janela de navegação privada:
    • Navegue até uma página onde o widget de chat deve identificar os visitantes por meio da API de identificação do visitante e inicie uma conversa.
    • No HubSpot, abra a caixa de entrada e verifique se o chat está atribuído corretamente ao contato com o qual você está conectado. Você deverá ver um selo ao lado do nome do contato, indicando que esse contato foi identificado com sucesso pela API.

• Se você adicionou o widget de chat apenas a páginas protegidas por um sistema de autenticação e tem acesso a diversas contas de usuário de teste:
  • Faça login no HubSpot como o primeiro usuário de teste, navegue até uma página onde o widget de chat é carregado e inicie uma conversa.
  • Saia do HubSpot e faça login novamente como o segundo usuário de teste. Navegue até uma página onde o widget de chat é carregado e inicie uma conversa.
  • No HubSpot, abra a caixa de entrada e verifique se os chats recebidos eram da primeira e da segunda contas de teste, respectivamente, e se você vê o selo ao lado dos nomes dos contatos de ambos os registros.

​

Introdução ao SDK do widget de chat

<script type="text/javascript">
  function onConversationsAPIReady() {
    console.log(`HubSpot Conversations API: ${window.HubSpotConversations}`);
  }
  /*
    configure window.hsConversationsSettings if needed.
  */
  window.hsConversationsSettings = {};
  /*
   If external API methods are already available, use them.
  */
  if (window.HubSpotConversations) {
    onConversationsAPIReady();
  } else {
    /*
      Otherwise, callbacks can be added to the hsConversationsOnReady on the window object.
      These callbacks will be called once the external API has been initialized.
    */
    window.hsConversationsOnReady = [onConversationsAPIReady];
  }
</script>

​

Referência do SDK

if (window.HubSpotConversations) {
  console.log('The api is ready already');
} else {
  window.hsConversationsOnReady = [
    () => {
      console.log('Now the api is ready');
    },
  ];
}

window.hsConversationsSettings = {
  loadImmediately: false,
  identificationEmail: 'visitor-email@example.com',
  identificationToken: '<TOKEN FROM STEP 1>',
};