Identification des visiteurs

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.

Marketing HubPro

Sales HubPro

Service HubPro

Content HubPro

​

Exemple de flux d’intégration

• Définissez les propriétés de hsConversationsSettings en dehors de la fonction isConversationsAPIReady.
• En outre, hsConversationsSettings doit être défini avant l’appel. Autrement, vous risquez d’être confronté à une condition de course qui interfère avec le chargement des widgets.

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();

​

Vérifier l’intégration

• Si vous avez ajouté le widget de chat sur une ou plusieurs pages publiques ainsi que derrière un système d’authentification :
  • Accédez à une page où le widget de chat ne doit pas identifier les visiteurs et lancez une conversation.
  • Dans HubSpot, ouvrez la boîte de réception et vérifiez que le chat qui vient d’arriver appartient à un visiteur inconnu. Si ce n’est pas le cas, essayez de suivre ces étapes dans une fenêtre de navigation privée :
    • Accédez à une page où le widget de chat doit identifier les visiteurs via l’API d’identification des visiteurs et lancez une conversation.
    • Dans HubSpot, ouvrez la boîte de réception et vérifiez que le chat est correctement attribué au contact sous lequel vous êtes connecté. Vous devriez voir un badge à côté du nom du contact indiquant que ce contact a été identifié avec succès via cette API.

• Si vous avez ajouté le widget de chat uniquement sur les pages derrière un système d’authentification et que vous avez accès à plusieurs comptes de test :
  • Connectez-vous à HubSpot en tant que premier utilisateur test, puis accédez à une page où le widget de chat se charge et lancez une conversation.
  • Déconnectez-vous de HubSpot et reconnectez-vous en tant que deuxième utilisateur. Accédez à une page où le widget de chat se charge et démarrez une conversation.
  • Dans HubSpot, ouvrez la boîte de réception et vérifiez que les conversations entrantes provenaient respectivement des premier et deuxième comptes de test, et que vous voyez le badge à côté des noms de contact pour les deux fiches d’informations.

​

Principes du kit de développement logiciel pour le 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>

​

Référence pour le kit de développement logiciel

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