Website-Webkomponente

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

Wichtige Schritte

Schritt 1: Integrationsmodus wählen

Privater Modus

Öffentlicher Modus

• Entscheiden Sie sich zwischen zwei Integrationsmodi:

  • Öffentlicher Modus: Keine Authentifizierung erforderlich; alle Nutzer können mit der Benutzeroberfläche chatten.

  • Privater Modus: Erfordert eine Benutzerauthentifizierung; Nutzer müssen sich anmelden, um auf ihren Gesprächsverlauf zuzugreifen.

• Kontaktieren Sie Ihren Blockbrain Key Account Manager dass Sie ein Webcomponent auf 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>

• Stellen Sie sicher, dass Sie die folgenden Informationen bereithalten:

  • Organisations-ID: Erhalten Sie diese von Ihrem Blockbrain Key Account oder Teammitglied.

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

  • Webcomponent Bot UID: Die ID einer Bot-Zuordnung, die im Admin-Bereich Ihres Blockbrain erstellt wurde. Muss von einem Admin hinzugefügt werden.

Schritt 3: Webkomponente konfigurieren

<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: Fügen Sie Ihre Organisations-ID ein – aus dem Blockbrain-Team erhalten.

  • Issuer: Fügen Sie die Issuer-URL ein - https://your-blockbrain-domain.com.

  • UID: Webcomponent Bot UID – z. B. CompanyGPT.

  • User UID: Für private und eingeschränkte Bots nicht relevant, für öffentliche Bots optional.

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 Issuer enthalten ist in der Konfiguration.

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

• Testen Sie die Anmeldefunktion:

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

  • Stellen Sie sicher, 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 zum öffentlichen Modus zu wechseln, entfernen Sie den Issuer 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 verwendet werden, um Nutzer zu unterscheiden.

• Testen Sie die öffentliche Chat-Funktion, um zu bestätigen, dass sie ohne Authentifizierung funktioniert.

Video