Identificación de visitantes

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.

Marketing HubPro

Sales HubPro

Service HubPro

Content HubPro

​

Ejemplo del flujo de integración

• Define las propiedades de hsConversationsSettings fuera de la función isConversationsAPIReady.
• Además, hsConversationsSettings debe definirse antes de la llamada; de lo contrario, puede producirse una condición de carrera que interfiera con la carga del 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();

​

Verifica la integración

• Si agregaste el widget de chat a una o más páginas públicas, así como detrás de un sistema de autenticación:
  • Navega hasta una página en la que el widget de chat no deba identificar a los visitantes e inicia una conversación.
  • En HubSpot, abre la bandeja de entrada y comprueba que el chat que acaba de entrar pertenece a un Visitante desconocido. Si no es así, realiza una prueba siguiendo estos pasos en una ventana de navegación privada:
    • Ve a una página en la que el widget de chat deba identificar a los visitantes mediante la API de identificación de visitantes e inicia una conversación.
    • En HubSpot, abre la bandeja de entrada y comprueba que el chat se atribuye correctamente al contacto con el que has iniciado sesión. Deberías ver un indicador junto al nombre del contacto, que confirma que se identificó correctamente a través de esta API.

• Si solo has agregado el widget de chat a páginas tras el sistema de autenticación y tienes acceso a varias cuentas de usuario de prueba:
  • Inicia sesión en HubSpot como el primer usuario de prueba, luego ve a una página donde se cargue el widget de chat e inicia una conversación.
  • Cierra sesión en HubSpot, luego vuelve a entrar como el segundo usuario de prueba. Ve a una página donde se cargue el widget de chat y comienza una conversación.
  • En HubSpot, abre la bandeja de entrada y comprueba que los chats que entraron proceden de la primera y segunda cuenta de prueba, respectivamente y que ves el indicador junto a los nombres de contacto de ambos registros.

​

Introducción al SDK del 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>

​

Referencia del 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>',
};