Besucheridentifikation

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.

Marketing HubProfessional

Sales HubProfessional

Service HubProfessional

Content HubProfessional

​

Beispiel für einen Integrationsprozess

• Legen Sie die Eigenschaften von hsConversationsSettings außerhalb der isConversationsAPIReady-Funktion fest.
• Außerdem müssen die hsConversationsSettings vor dem Aufruf festgelegt werden, da es sonst zu einer Race Condition kommen kann, die das Laden des Widgets behindert.

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

​

Die Integration verifizieren

• Wenn Sie das Chat-Widget für eine oder mehrere öffentlichen Seiten sowie hinter einem Authentifizierungssystem hinzugefügt haben:
  • Gehen Sie zu einer Seite, auf der das Chat-Widget keine Besucher identifiziert und eine Konversation startet.
  • Öffnen Sie in HubSpot das Postfach und verifizieren Sie, dass der gerade eingegangene Chat in die Kategorie Unbekannter Besucher fällt. Wenn dies nicht der Fall ist, versuchen Sie, diese Schritte in einem privaten Browserfenster durchzuführen.
    • Gehen Sie zu einer Seite, auf der das Chat-Widget Besucher über die API für die Besucheridentifikation identifiziert und eine Konversation startet.
    • Öffnen Sie in HubSpot das Postfach und verifizieren Sie, dass der Chat korrekt dem Kontakt zugeordnet ist, unter dem Sie angemeldet sind. Sie sollten neben dem Namen des Kontakts ein Abzeichen sehen, das angibt, dass dieser Kontakt über diese API erfolgreich identifiziert wurde.

• Wenn Sie das Chat-Widget nur für Seiten hinter einem Authentifizierungssystem hinzugefügt haben und Zugriff auf mehrere Testbenutzer-Accounts haben:
  • Melden Sie sich als erster Testbenutzer bei HubSpot an, gehen Sie dann zu einer Seite, auf der das Chat-Widget geladen wird, und starten Sie eine Konversation.
  • Melden Sie sich von HubSpot ab und als zweiter Testbenutzer wieder an. Gehen Sie zu einer Seite, auf der das Chat-Widget geladen wird, und beginnen Sie eine Konversation.
  • Öfnnen Sie dann in HubSpot das Postfach und verifizieren Sie, ob die eingegangenen Chats vom ersten bzw. zweitenTest-Account stammen und ob Sie das Abzeichen neben den Kontaktnamen für beide Datensätze sehen.

​

Chat-Widget SDK-Primer

<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>

​

SDK-Referenz

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