Einen AI Trainer in Salesforce einbetten

Erfahren Sie, wie Sie einen einzelnen AI Trainer als Live-Bereich in eine Salesforce-Lightning-Seite einbetten.

Sie können einen einzelnen AI Trainer als Live-Bereich in eine Salesforce-Lightning-Seite einfügen. Teammitglieder öffnen den Datensatz, an dem sie gerade arbeiten, und starten eine Trainer-Sitzung, ohne Salesforce zu verlassen oder den Tab zu wechseln.

Die Einbettung ist ein abgeschottetes <iframe>, das auf einen Trainer zeigt. Was ein Trainer ist, erfahren Sie unter Einführung in den AI Trainer. Wenn Sie stattdessen in ein LMS, ein CMS, eine Website oder einen Blog einbetten möchten, lesen Sie Einen AI Trainer überall einbetten.

Bevor Sie beginnen

Sie brauchen ein Berechtigungsprofil, in dem Embed AI Trainer aktiviert ist. Die Option steht unter Agent Access in Company Settings > People Settings > Permission Profiles und ist standardmäßig ausgeschaltet. Manage Agents ist dafür nicht nötig. Siehe Berechtigungsprofile erstellen und verwalten.

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

Schritt 1: Den Embed-Code abrufen

Öffnen Sie Practice > AI Trainer.

Suchen Sie den Trainer, öffnen Sie sein ⋯-Menü und wählen Sie Embed AI Trainer.

Legen Sie optional Width und Height unter Size (Optional) fest. Lassen Sie die Felder leer, um 100 % Breite und Höhe zu verwenden.

Klicken Sie auf Copy Embed Code.

Der kopierte Code sieht so aus:

<iframe src="https://app.outdoo.ai/embed/roleplay/ai-tutor/[trainerId]"
  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. Sitzungen können Kamera und Mikrofon verwenden, und ohne dieses Attribut blockiert der Browser sie.

Schritt 2: Eine Visualforce-Seite erstellen

Gehen Sie in Salesforce unter Setup zu Custom Code > Visualforce Pages und klicken Sie auf New.

Vergeben Sie ein Label und fügen Sie den Embed-Code aus Schritt 1 in das Feld Markup ein. Speichern Sie.

Öffnen Sie die soeben erstellte Seite und klicken Sie auf Security. Fügen Sie die Profile hinzu, die darauf zugreifen dürfen, und speichern Sie.

Schritt 3: Outdoo AI in der CSP von Salesforce zulassen

Salesforce blockiert standardmäßig Frames aus anderen Domains sowie den Zugriff auf Kamera und Mikrofon. Deshalb müssen zwei Einstellungen Outdoo AI ausdrücklich zulassen.

Gehen Sie zu Setup > Security > Trusted URLs und klicken Sie auf New Trusted URL.

Legen Sie diese Felder fest:

URL: Ihre Outdoo AI-Adresse, zum Beispiel https://app.outdoo.ai.

CSP Context: Visualforce Pages.

CSP Directives: connect-src und frame-src.

Grant access to: Camera and Microphone.

Speichern Sie.

Gehen Sie zu 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.

Schritt 4: Den Trainer einer Lightning-Seite hinzufügen

Öffnen Sie die Lightning-Seite im App Builder. Verwenden Sie das Zahnradsymbol auf der Seite und wählen Sie Edit Page.

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.

Nach der Aktivierung erscheint der Trainer-Bereich auf der Datensatzseite.

Anmeldung innerhalb der Einbettung

Wenn ein Teammitglied den Bereich zum ersten Mal öffnet, sieht es den Bildschirm Sign In to Practice. Mit Sign In with Outdoo AI kann es sich anmelden, ohne den Salesforce-Tab zu verlassen. Blockiert sein Identitätsanbieter Anmeldeseiten innerhalb eines Frames, kann es auf Open Sign In in a New Tab klicken und danach zum Salesforce-Tab zurückkehren. Nach der Anmeldung sieht es nur diesen Trainer, ohne Navigation zum Rest von Outdoo AI. Mit der Schaltfläche Sign Out kann es das Konto wechseln.

Fehlerbehebung

Ein Banner 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 gewährt keinen Zugriff auf Kamera und Mikrofon. Laden Sie die Lightning-Seite neu, nachdem Sie beide Einstellungen gespeichert haben. Teammitglieder können in der Zwischenzeit auf Open in a New Tab klicken, um denselben Trainer außerhalb des Frames zu nutzen.

Der Anmeldebildschirm wiederholt sich oder bleibt leer. Der Identitätsanbieter weigert sich, seine Anmeldeseite innerhalb eines Frames anzuzeigen. Verwenden Sie Open Sign In in a New Tab.

This AI Trainer is still a draft, or isn't active yet. Bitten Sie einen Workspace-Administrator, ihn zu veröffentlichen oder zu aktivieren.

You don't have permission to practice with this AI Trainer. Bitten Sie einen Administrator, den Trainer mit dem Teammitglied zu teilen oder es dem Workspace hinzuzufügen.

Falsches Konto im Bereich. Klicken Sie auf Sign Out, oder auf einem Fehlerbildschirm auf Sign Out and Try Again, und melden Sie sich erneut an.

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