Website Web-Komponente

Dieses Tutorial beschreibt die Schritte zur Integration der Blockbrain-Webkomponente in eine Website, entweder im öffentlichen oder privaten Modus, und gewährleistet dabei die ordnungsgemäße Einrichtung und Authentifizierung.

Wichtige Schritte

Schritt 1: Integrationsmodus auswählen

Privater Modus

Öffentlicher Modus

• Entscheiden Sie sich zwischen zwei Integrationsmodi:

  • Privater Modus: Benutzer-Authentifizierung erforderlich; Benutzer müssen sich anmelden, um auf ihren Gesprächsverlauf zugreifen zu können.

  • Öffentlicher Modus: Keine Authentifizierung erforderlich; alle Benutzer können über die Schnittstelle chatten.

• Teilen Sie Ihrem Blockbrain-Key-Account-Manager mit, dass Sie eine Webkomponente zu Ihrer Website hinzufügen möchten.

Schritt 2: Bereiten Sie Ihre Website vor

• Fügen Sie das erforderliche Header-Skript zu Ihrer Website hinzu.

<script 
  type="module"
  src="https://assets.theblockbrain.io/scripts/blocky-chat/blocky-chat.bundle.js"
  async
></script>

• Halten Sie bitte die folgenden Informationen bereit:

  • Organisations-ID: Diese erhalten Sie von Ihrem Blockbrain-Key-Account oder einem Teammitglied.

  • Aussteller-URL: Dies ist die Blockbrain-URL Ihres Unternehmens (z. B. https://demo.kb.theblockbrain.ai/).

  • Webcomponent Bot UID: Die ID eines Bot-Mappings, das im Admin-Bereich Ihres Blockbrain erstellt wurde. Muss von einem Administrator hinzugefügt werden.

Schritt 3: Konfigurieren Sie die Webkomponente

<blockbrain-main 
  orgId="your-org-id"
  issuer="https://your-blockbrain-domain.com" 
  uid="your-webcomponent-bot-uid" 
  userUid="optional-user-id">
</blockbrain-main>

• Richten Sie die Webkomponente mit den folgenden Parametern ein:

  • Organisations-ID: Geben Sie Ihre Organisations-ID ein, die Sie vom Blockbrain-Team erhalten haben.

  • Aussteller: Geben Sie die URL des Ausstellers ein - https://your-blockbrain-domain.com.

  • UID: Webkomponenten-Bot-UID, z. B. CompanyGPT.

  • Benutzer-UID: Nicht relevant für private und eingeschränkte Bots, optional für öffentliche Bots.

Privater Modus

Schritt 4: Authentifizierung einrichten

<blockbrain-main 
  orgId="your-org-id"
  issuer="https://your-blockbrain-domain.com" 
  uid="your-webcomponent-bot-uid" 
</blockbrain-main>

• Wenn Sie den privaten Modus verwenden, stellen Sie sicher, dass der Aussteller in der Konfiguration enthalten ist.

• Entfernen Sie die userUid, die nur für den öffentlichen Modus vorgesehen ist.

• Testen Sie die Anmeldefunktion:

  • Klicken Sie auf die Anmeldeschaltfläche, um die OAuth-Authentifizierung auszulösen.

  • Vergewissern Sie sich, dass Sie auf Ihren Gesprächsverlauf zugreifen können.

Öffentlicher Modus

Schritt 5: Öffentlichen Modus verwenden

<blockbrain-main 
  orgId="your-org-id"
  uid="your-webcomponent-bot-uid" 
  userUid="optional-user-id">
</blockbrain-main>

• Um in den öffentlichen Modus zu wechseln, entfernen Sie den Aussteller aus der Konfiguration.

• Stellen Sie sicher, dass die Organisations-ID und die Unternehmens-UID weiterhin enthalten sind.

• Entfernen Sie die userUid, wenn sie nicht benötigt wird. Sie kann zur Unterscheidung von Benutzern verwendet werden.

• Testen Sie die öffentliche Chat-Funktion, um sicherzustellen, dass sie ohne Authentifizierung funktioniert.

Video