# Website-Webkomponente

## Wichtige Schritte

### **Schritt 1: Integrationsmodus wählen**

<div><figure><img src="/files/c9b278282d02d85b009edf3808f9bacf7e268d9b" alt=""><figcaption><p>Privater Modus</p></figcaption></figure> <figure><img src="/files/3e3ce1119be88159df9227a160594972964ba07e" alt=""><figcaption><p>Öffentlicher Modus</p></figcaption></figure></div>

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

&#x20;

### **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.

&#x20;

### **Schritt 3: Webkomponente konfigurieren**

<pre><code><strong>&#x3C;blockbrain-main 
</strong>  orgId="your-org-id"
  issuer="https://your-blockbrain-domain.com" 
  uid="your-webcomponent-bot-uid" 
  userUid="optional-user-id">
&#x3C;/blockbrain-main>
</code></pre>

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

<pre><code><strong>&#x3C;blockbrain-main 
</strong>  orgId="your-org-id"
  issuer="https://your-blockbrain-domain.com" 
  uid="your-webcomponent-bot-uid" 
&#x3C;/blockbrain-main>
</code></pre>

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

&#x20;

## Öffentlicher Modus

### **Schritt 5: Öffentlichen Modus verwenden**

<pre><code><strong>&#x3C;blockbrain-main 
</strong>  orgId="your-org-id"
  uid="your-webcomponent-bot-uid" 
  userUid="optional-user-id">
&#x3C;/blockbrain-main>
</code></pre>

* 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

{% embed url="<https://drive.google.com/file/d/17ShFDF5fo68n6PTK7lRI25jkmszpI8G-/view?usp=sharing>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.en.theblockbrain.ai/de/fur-administratoren/webkomponenten/website-webkomponente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.