---
title: "Einen Rollenspiel-Agenten in Salesforce einbetten"
url: "https://help.outdoo.ai/de/article/einen-rollenspiel-agenten-in-salesforce-einbetten"
language: "de"
last_updated: "2026-10-23T02:58:48.434Z"
---

# Einen Rollenspiel-Agenten in Salesforce einbetten

Erfahren Sie, wie Sie einen Rollenspiel-Agenten über eine Visualforce-Seite in eine Salesforce-Lightning-Seite einbetten und freigeben.

Sie können einen einzelnen Rollenspiel-Agenten direkt als Übungsbereich in eine Salesforce-Lightning-Seite einfügen. Teammitglieder öffnen den Datensatz, an dem sie gerade arbeiten, und üben ein Gespräch, einen Chat oder eine Videositzung mit dem Agenten, ohne Salesforce zu verlassen oder den Tab zu wechseln.

Technisch ist das ein einfaches, abgeschottetes `<iframe>`, das auf einen Agenten verweist. Wenn Sie nicht in Salesforce, sondern in eine Website, ein SCM-Tool, ein LMS/LXP oder ein Dokumentations- bzw. Wiki-Tool einbetten möchten, lesen Sie [Einen Rollenspiel-Agenten überall einbetten](https://help.outdoo.ai/de/article/einen-rollenspiel-agenten-uberall-einbetten).

Das ist etwas anderes als [Salesforce und Outdoo AI](https://help.outdoo.ai/de/article/salesforce-und-outdoo-ai), womit Meeting-Notizen und Gesprächsdaten in Salesforce-Datensätze synchronisiert werden. Die Integration und diese Einbettung lassen sich zusammen nutzen, doch die Einrichtung der einen richtet nicht automatisch die andere ein.

## Bevor Sie beginnen

-   Um einen Embed-Code zu erzeugen, brauchen Sie ein Berechtigungsprofil, in dem **Manage agents** und **Embed agents** aktiviert sind.

-   Der Agent muss **veröffentlicht und aktiv** sein. Entwürfe und Agenten, die noch erstellt werden, lassen sich nicht einbetten.

-   Der Agent muss ein **Agent mit einer einzigen Persona** sein. Multi-Persona-Agenten werden in der Einbettung noch nicht unterstützt.

-   Am Agenten darf **kein Workflow- bzw. Bildschirmaufnahme-Schritt** hängen. Die Workflow-Aufnahme benötigt die Erweiterung Outdoo Workflow Training, die nicht in einem iframe laufen kann.

-   AI Roleplays muss im Tarif Ihres Workspace enthalten sein.

-   In Salesforce brauchen Sie **Systemadministrator-Zugriff auf Setup**, um eine Visualforce-Seite zu erstellen, Trusted URLs zu ändern und die Lightning-Seite zu bearbeiten.

Erfüllt ein Agent die ersten vier Bedingungen nicht, erscheint die Option **Embed Agent** nicht in seinem Menü.

## Schritt 1: Den Embed-Code abrufen

![Liste Roleplay Agents mit dem Drei-Punkte-Menü unter Actions für einen Agenten](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6a7d8b3cce8c9574340e66d6_roleplay-agents-roleplay-agents-list-4.avif)

*Öffnen Sie in der Spalte Actions das •••-Menü eines Agenten, um Embed Agent zu finden.*

-   Öffnen Sie **Practice > Roleplay Agents**.

-   Suchen Sie den Agenten, öffnen Sie sein **•••**\-Menü und wählen Sie **Embed Agent**.

![Aktionsmenü einer Rollenspiel-Agenten-Zeile mit hervorgehobener Option Embed Agent](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a7f170acccc7ef77494_salesforce-embed-embed-salesforce-dropdown.avif)

*Das •••-Menü mit hervorgehobenem Embed Agent.*

-   Legen Sie optional **Width** und **Height** fest (Standard: 100 % / 100 %).

-   Klicken Sie auf **Copy iFrame HTML**.

![Fenster Embed agent mit Größenfeldern und kopierbarem iframe-HTML-Code](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a82170acccc7ef7753d_salesforce-embed-embed-salesforce-iframe-popup.avif)

*Das Fenster Embed agent mit dem erzeugten iframe-HTML.*

Der kopierte Code sieht so aus:

```html
<iframe src="https://app.outdoo.ai/embed/roleplay/agent/<botId>"
  allow="camera *; microphone *; display-capture *; autoplay *; fullscreen *"
  width="100%"
  height="100%"
  style="min-width: 375px; min-height: 650px; border: 0">
</iframe>
```

Lassen Sie das Attribut `allow` genau so, wie es erzeugt wurde. Gesprächs- und Video-Agenten brauchen Zugriff auf Kamera und Mikrofon, und ohne dieses Attribut blockiert der Browser die Sitzung.

## Schritt 2: Eine Visualforce-Seite erstellen

-   Öffnen Sie in Salesforce unter **Setup** den Bereich **Custom Code → Visualforce Pages** und klicken Sie auf **New**.

![Liste Visualforce Pages in Salesforce Setup mit der Seite Outdoo_Roleplay_Embed](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a8e9597cc994ca078ce_salesforce-embed-visualforce-list-page.avif)

*Die Liste Visualforce Pages in Setup.*

-   Geben Sie eine Bezeichnung ein und fügen Sie das iframe-HTML aus Schritt 1 in das Feld **Markup** ein. Speichern Sie.

![Markup-Editor einer Salesforce-Visualforce-Seite mit eingefügtem iframe-Code von Outdoo AI](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a8ca33823e5630ef915_salesforce-embed-visualforce-embed-on-salesforce.avif)

*Das iframe-HTML im Feld Markup der Visualforce-Seite.*

-   Öffnen Sie die gerade erstellte Seite und klicken Sie auf **Security**. Fügen Sie die Profile hinzu, die Zugriff erhalten sollen, und speichern Sie.

## Schritt 3: Kamera und Mikrofon über die CSP von Salesforce freigeben

Salesforce blockiert standardmäßig den Zugriff auf Kamera und Mikrofon sowie Frames von anderen Ursprüngen. Zwei Einstellungen müssen Outdoo AI daher ausdrücklich zulassen.

-   Öffnen Sie **Setup → Security → Trusted URLs** und klicken Sie auf **New Trusted URL**.

-   Legen Sie fest:

-   **URL**: Ihre Outdoo AI-Domain (zum Beispiel `https://app.outdoo.ai`)

-   **CSP Context**: Visualforce Pages

-   **CSP Directives**: `connect-src` und `frame-src`

-   **Grant access to**: Camera und Microphone (überspringen Sie das, wenn Sie nur einen reinen Chat-Agenten einbetten)

-   Speichern Sie.

![Seite Trusted URLs in Salesforce Setup mit CSP-Kontext Visualforce Pages und erteilten Berechtigungen für Kamera und Mikrofon](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a89a15d3878a173bc70_salesforce-embed-trusted-urls.avif)

*Die Trusted URL mit dem CSP-Kontext Visualforce Pages und Zugriff auf Kamera und Mikrofon.*

-   Öffnen Sie **Setup → Security → Session Settings** und aktivieren Sie den HTTP-Header **Permissions Policy**. Setzen Sie den Zugriff auf Kamera und Mikrofon auf **Trusted URLs** (oder **Always**).

-   Speichern Sie.

![Seite Session Settings in Salesforce Setup mit aktiviertem Permissions-Policy-Header und Kamera/Mikrofon auf Trusted URLs Only](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a861e1c791262dc6ffa_salesforce-embed-session-settings.avif)

*Session Settings mit aktiviertem Permissions-Policy-Header.*

## Schritt 4: Den Agenten zu einer Lightning-Seite hinzufügen

-   Öffnen Sie die Lightning-Seite im **App Builder** (über das Zahnradsymbol auf der Seite oder **Setup → Edit Page**).

![Setup-Menü einer Salesforce-Datensatzseite mit ausgewähltem Edit Page zum Öffnen des Lightning App Builder](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a7df50e78f04787fbe4_salesforce-embed-edit-page.avif)

*Edit Page im Setup-Menü der Datensatzseite öffnen.*

-   Ziehen Sie eine **Visualforce**\-Komponente auf die Seite.

-   Wählen Sie die Visualforce-Seite aus, die Sie in Schritt 2 erstellt haben.

-   Klicken Sie auf **Save** und dann auf **Activate**.

![Salesforce Lightning App Builder mit einer Visualforce-Komponente auf einer Datensatzseite, die den eingebetteten Rollenspiel-Agenten von Outdoo AI anzeigt](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a7bf50e78f04787fa9c_salesforce-embed-add-visualforce-component.avif)

*Die Visualforce-Komponente auf der Lightning-Seite mit dem eingebetteten Agenten.*

Nach der Aktivierung erscheint der Agentenbereich direkt auf der Datensatzseite:

![Eingebetteter Tab Outdoo AI Roleplay in einer Salesforce-Datensatzseite mit Agenten-Persona, Unternehmensdetails und Schaltfläche Start Call](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6abb7a8454ba684cf4936c8a_salesforce-embed-final-roleplay-screen-salesforce.avif)

*Die fertige Einbettung in einem echten Salesforce-Datensatz.*

## Anmeldung im eingebetteten Bereich

Wenn ein Teammitglied den Bereich zum ersten Mal öffnet, sieht es statt des Agenten einen Anmeldebildschirm:

-   **Sign In with Outdoo AI** meldet es an, ohne den Salesforce-Tab zu verlassen.

-   **Open Sign-In Page in a New Tab** ist eine Ausweichlösung für Identitätsanbieter, die das Laden von Anmeldeseiten in einem iframe blockieren. Nach der Anmeldung dort kann das Teammitglied zum Salesforce-Tab zurückkehren.

Nach der Anmeldung sieht das Teammitglied nur diesen einen Agenten, ohne Navigation zum Rest von Outdoo AI. Je nach Kanalkonfiguration des Agenten kann es ein Gespräch, einen Chat oder eine Videositzung starten. Nach dem Ende der Sitzung bleibt es im selben Bereich und kann eine weitere Runde starten oder sich abmelden.

## Fehlerbehebung

**Ein Hinweis meldet, dass der Zugriff auf Kamera oder Mikrofon blockiert ist.** Der Header Permissions Policy in den Session Settings ist noch nicht aktiviert, oder die Trusted URL hat keinen Zugriff auf Kamera und Mikrofon. Laden Sie die Lightning-Seite neu, nachdem Sie beide Einstellungen gespeichert haben, denn Änderungen greifen in einem bereits geöffneten Tab nicht immer. Teammitglieder können auf **Use New Tab for Now** klicken, um denselben Agenten außerhalb des iframe zu öffnen, bis das Problem behoben ist.

**Der Anmeldebildschirm wiederholt sich oder bleibt leer.** Der Identitätsanbieter verweigert die Anzeige seiner Anmeldeseite in einem Frame. Verwenden Sie stattdessen **Open Sign-In Page in a New Tab**.

**„Agent cannot be embedded“ im eingebetteten Bereich.** Der Agent ist ein Multi-Persona-Agent, oder an ihm hängt ein Workflow- bzw. Bildschirmaufnahme-Schritt. Beides wird in der Einbettung noch nicht unterstützt.

**„Access denied“ im eingebetteten Bereich.** Der Agent wurde nicht mit dem angemeldeten Teammitglied geteilt, oder es ist kein Mitglied des Workspace, zu dem der Agent gehört.

Wir hoffen, dieser Artikel war hilfreich. Bei Fragen schreiben Sie uns bitte an support@outdoo.ai

## Verwandte Artikel

-   [Einen Rollenspiel-Agenten überall einbetten](https://help.outdoo.ai/de/article/einen-rollenspiel-agenten-uberall-einbetten)

-   [Salesforce und Outdoo AI](https://help.outdoo.ai/de/article/salesforce-und-outdoo-ai)

-   [Einen Rollenspiel-Agenten mit Vorlagen erstellen](https://help.outdoo.ai/de/article/einen-rollenspiel-agenten-mit-vorlagen-erstellen)

-   [Gesprächstypen im Rollenspiel](https://help.outdoo.ai/de/article/gesprachstypen-im-rollenspiel)