YouTube ChannelSchedule a CallSubscribe for Updates

Chat

Übersicht

Das Avonni Chat-Komponente bringt Echtzeit-Messaging in Ihre Lightning-Seiten. Verwenden Sie sie für interne Zusammenarbeit, Kundenkommunikation oder jeden Workflow, bei dem verschachtelte Unterhaltungen in Salesforce Mehrwert schaffen.

Schnellstart: Erstellen Sie einen Case-Chat in 2 Minuten

Möchten Sie die Komponente sofort in Aktion sehen? Befolgen Sie diese 7 Schritte, um der Case-Datensatzseite eine funktionale Case-Kommentar-Historie hinzuzufügen.

1

Erstellen Sie eine neue Komponente

  • Öffnen Sie die Avonni Dynamic Components App.

  • Klicken Sie auf die Neu Schaltfläche, um eine neue Komponente zu erstellen.

  • Name: Geben Sie einen Namen ein (z. B. „Case Chat History“).

  • Zielseiten-Objekt: Wählen Sie Case.

2

Fügen Sie die Komponente zur Leinwand hinzu

  • Aus der Komponentenbibliothek (linke Seitenleiste) suchen Sie nach Chat.

  • Ziehen Sie die Chat Komponente auf die Hauptleinwand

3

Konfigurieren Sie die Datenquelle zur Abfrage

Wir müssen die CaseComment-Datensätze aus Salesforce abrufen.

  • Wählen Sie die Chat Komponente auf der Leinwand aus.

  • Stellen Sie im Eigenschaftenbereich (rechts) Datenquelle ein auf Abfrage.

  • Objekt: Wählen Sie CaseComment.

  • Filter:

    • Klicken Sie Filter hinzufügen.

    • Feld: ParentId.

    • Operator: Gleich.

    • Wert: {!$Component.RecordId}.

    • Warum: Dadurch stellen wir sicher, dass nur Kommentare für den aktuell angezeigten Case geladen werden.

  • Sortieren nach: CreatedDate ASC (Älteste zu Neueste).

4

Mappen Sie die Abfragefelder

Verbinden Sie die von Ihrer Abfrage zurückgegebenen Felder mit den Attributen der Chat-Komponente.

  • Scrollen Sie nach unten zum Datenzuordnungen Abschnitt.

  • Inhalt: Wählen Sie Body.

    • Hinweis: Dies ordnet den eigentlichen Text des Kommentars der Nachrichtenblase zu.

  • Datum: Wählen Sie CreatedDate.

Überprüfen Sie die Vorschau: Die Leinwand sollte nun die Konversationshistorie für den Kontextdatensatz anzeigen. Ist die Vorschau leer, stellen Sie sicher, dass der Vorschau-Kontext im Debug-Bereich auf einen Case gesetzt ist.

5

Konfigurieren Sie den Publisher

Richten Sie das Eingabefeld für neue Nachrichten ein.

  • Scrollen Sie zum Publisher Abschnitt.

  • Modus: Einstellen auf Rich.

  • Schaltflächenbeschriftung: Ändern Sie „Senden“ zu Kommentar posten.

  • Platzhalter: Geben Sie ein Antwort eingeben....

6

Fügen Sie die „Speichern“-Logik hinzu (Interaktion)

Machen Sie die Schaltfläche „Kommentar posten“ funktionsfähig.

  • Klicken Sie auf die Interaktionen Registerkarte im Eigenschaftenbereich.

  • Klicken Sie Interaktion hinzufügen.

    • Auslöser: Wählen Sie Beim Veröffentlichen einer Nachricht.

    • Aktion: Wählen Sie Datensatzdaten manuell eingeben.

    • Objekt: Wählen Sie CaseComment.

  • Feldzuordnungen:

    • ParentId: {$Component.RecordId} (Verknüpft den Kommentar mit diesem Case).

    • CommentBody: Nachricht: Inhalt (Erfasst den von Ihnen eingegebenen Text).

    • Erstellungsdatum: Nachricht:Datum

7

Speichern und aktivieren

  • Klicken Sie Speichern.

  • Verwenden Sie die Bereitstellen Schaltfläche, um diese dynamische Komponente zu Ihrer tatsächlichen Salesforce Case Lightning-Seite hinzuzufügen

Konfiguration

Wählen Sie die Chat-Komponente auf der Leinwand aus, um ihre Eigenschaften im Eigenschaftenbereich aufzurufen. Die Konfiguration umfasst die Definition, woher die Nachrichten stammen, wie sich der Publisher verhält und wie neue Nachrichten verarbeitet werden.

Verbindung zu Nachrichtendaten (Datenquelle)

Sie können die Chat-Historie entweder mit der Manuelle oder Abfrage Methode auffüllen.

Option A: Manuelle Datenquelle

Verwenden Sie dies für statische Anzeigen oder Prototyping.

  1. Datenquelle auswählen: Wählen Sie Manuell.

  2. Konfigurieren Sie Ressourcen: Ressourcen repräsentieren die Personen oder Entitäten, die am Chat beteiligt sind.

    • Beschriftung: Der Anzeigename der Person/des Benutzers.

    • Avatar-Quelle: URL für das Benutzerbild.

    • Avatar-Ersatzsymbol: Ein Icon-Name (z. B. standard:user) zur Anzeige, wenn kein Bild verfügbar ist.

    • Avatar-Initialen: Text zum Anzeigen (z. B. „JD“), falls kein Bild vorhanden ist.

  3. Nachrichten konfigurieren: Erstellen Sie die spezifischen Nachrichtenblasen.

    • Autor: Der Name oder die ID der Ressource, die die Nachricht gesendet hat.

    • Typ: Explizit setzen als eingehend (empfangen) oder ausgehend (gesendet).

    • Datum: Der Zeitstempel der Nachricht.

    • Inhalt: Der eigentliche Textkörper der Nachricht.

Option B: Abfrage-Datenquelle

Verwenden Sie dies, um Datensätze dynamisch aus Salesforce abzurufen (z. B. alle zu einem Case gehörenden Kommentare).

  1. Datenquelle auswählen: Wählen Sie Abfrage.

  2. Abfrage definieren: Wählen Sie das Objekt (z. B. CaseComment) und setzen Sie Filter (z. B. ParentId gleich recordId) um die korrekten Datensätze abzurufen.

  3. Datenzuordnungen: Ordnen Sie die Felder Ihrer Abfrage der Chat-Anzeige zu.

    • Inhalt: Wählen Sie das Feld aus, das den Nachrichteninhalt enthält (z. B. CommentBody).

    • Datum: Wählen Sie das Feld aus, das den Zeitstempel enthält (z. B. CreatedDate).

Allgemeine Einstellungen

Diese Einstellungen steuern das Gesamtverhalten der Chat-Komponente, einschließlich wie Nachrichten zugeordnet und angezeigt werden.

Einstellung
Beschreibung
Beispiel

Aktuelle Ressourcen-ID

ID des Nachrichtenautors; bestimmt Positionierung gesendet vs. empfangen. Standardmäßig auf den aktuellen Benutzer gesetzt, wenn leer.

{!$User.Id}

Nur lesen

Verbirgt den Publisher; Benutzer können ansehen, aber nicht senden

falase

Deaktiviert

Graut die Komponente aus; verhindert jegliche Interaktion

false

Nachrichten-Datumsformat

Wie Zeitstempel in Nachrichten angezeigt werden

"MMM d, yyyy h:mm a" → "15. Jan. 2025 2:30 PM"

Publisher-Einstellungen

Passen Sie den Eingabebereich an, in dem Benutzer neue Nachrichten eingeben.

Einstellung
Beschreibung
Beispiel

Modus

ID des Nachrichtenautors; bestimmt Positionierung gesendet vs. empfangen. Standardmäßig auf den aktuellen Benutzer gesetzt, wenn leer.

{!$User.Id}

Platzhalter

Verbirgt den Publisher; Benutzer können ansehen, aber nicht senden

false

Beschriftung der Veröffentlichungs-Schaltfläche

Graut die Komponente aus; verhindert jegliche Interaktion

false

Maximale Länge

Wie Zeitstempel in Nachrichten angezeigt werden

"MMM d, yyyy h:mm a" → "15. Jan. 2025 2:30 PM"

Minimale Länge

Erforderliche Zeichen vor dem Senden

10

Zeichenanzahl anzeigen

Zeichenzähler anzeigen

Wahr

Symbolleistenposition

Wo die Formatierungswerkzeuge erscheinen

Oben

Kategorien

Wählen Sie aus, welche Formatierungswerkzeug-Gruppen in der Rich-Mode-Symbolleiste erscheinen:

  • Schriftart: Schriftfamilie- und Größenoptionen.

  • Text: Fett, kursiv, unterstrichen, durchgestrichen.

  • Body: Listen, Ausrichtung, Einzüge.

  • Formatierung entfernen: Alle Formatierungen des ausgewählten Textes löschen.

  • Überschrift: Überschriftenebenen-Optionen.

  • Farbe: Textfarbwähler.

  • Markierungsfarbe: Hintergrund-Markierungsfarbwähler.

Gesperrte Wörter

Definieren Sie Wörter, die nicht in veröffentlichten Nachrichten enthalten sein dürfen. Wenn Benutzer versuchen, Nachrichten mit gesperrten Wörtern zu senden, wird die Veröffentlichungsaktion verhindert.

Echtzeit-Updates (Platform Events)

Standardmäßig aktualisiert die Chat-Komponente, wenn Sie eine Nachricht posten. Wenn jedoch ein Kollege oder Kunde eine Antwort postet, während Sie den Bildschirm ansehen, würden Sie diese normalerweise erst nach einem Seiten-Refresh sehen.

Platform Events lösen dieses Problem. Sie ermöglichen der Chat-Komponente, auf Änderungen „zuzuhören“ und sofort zu aktualisieren, wenn eine neue Nachricht in der Datenbank erstellt wird.

So aktivieren Sie Echtzeit-Chat

Standardmäßig aktualisiert sich der Chat nur, wenn Sie eine Nachricht posten oder die Seite aktualisieren. Um ein Live-"Instant-Messaging"-Erlebnis zu schaffen, bei dem Antworten anderer sofort erscheinen, können Sie Platform Events.

Dies wird in den Datenquelle Einstellungen konfiguriert:

  1. Datenquelle auf setzen Abfrage.

  2. Erweitern Sie Erweiterte Optionen und suchen Sie Abfrage-Aktualisierung EMP.

  3. Kanalname: Geben Sie den API-Namen Ihres Platform Events ein (z. B. Chat_Notification__e).

  4. Schlüsselfeldname: Geben Sie den API-Namen des Feldes ein, das die Datensatz-ID enthält (z. B. RecordId__c).

Brauchen Sie Hilfe bei der Einrichtung? Für die Nutzung dieser Funktion müssen ein Platform Event und ein Trigger-Flow in Salesforce erstellt werden. 👉 Lesen Sie die vollständige Einrichtungsanleitung: So konfigurieren Sie Echtzeit-Updates

Interaktionskonfiguration

Standardmäßig zeigt die Chat-Komponente Daten an. Um sie funktionsfähig zu machen (d. h. tatsächlich eine Nachricht zu speichern, wenn der Benutzer auf „Senden“ klickt), müssen Sie eine Interaktion konfigurieren.

Szenario: Erstellen eines Datensatzes beim Veröffentlichen

  1. Navigieren Sie zur Registerkarte Interaktionen im Eigenschaftenbereich.

  2. Fügen Sie eine neue Interaktion mit dem Auslöser hinzu „Neue Nachricht veröffentlichen".

  3. Aktion: Wählen Sie Datensatz erstellen.

  4. Wählen: Datensatzdaten manuell eingeben.

  5. Objekt: Wählen Sie das Objekt, in dem Nachrichten gespeichert werden sollen (z. B. CaseComment, FeedItem, oder ein benutzerdefiniertes Chat_Log__c Objekt).

  6. Feldzuordnungen: Ordnen Sie die Daten der Chat-Komponente Ihrem Salesforce-Objekt zu.

    • Beispiel (Case Comment):

      • ParentId: Zuordnen zu {!Record.Id} (um es mit dem aktuellen Datensatz zu verknüpfen).

      • CommentBody: Zuordnen zum Chat-Komponenten-Attribut Wert (dies trägt den Text, den der Benutzer gerade eingegeben hat).

      • IsPublished: Setzen Sie einen konstanten Wert von true.

Hinweis: Sobald der Datensatz über die Interaktion erstellt wurde, wird die Chat-Abfrage (falls konfiguriert) automatisch aktualisiert, um die neue Nachricht in der Timeline anzuzeigen

Beispiel

Projektdiskussionsprotokoll

Ziel: Erstellen Sie eine Chat-Oberfläche auf einem benutzerdefinierten „Projekt“-Objekt. Dadurch kann das Projektteam Updates diskutieren und diese Nachrichten in einem benutzerdefinierten „Project Update“-Objekt speichern.

1

Erstellen Sie die Komponente

  • Öffnen Sie die Avonni Dynamic Components App.

  • Klicken Sie Neu.

  • Name: Geben Sie „Project Team Chat“ ein.

  • Zielseitenname: Wählen Sie Ihr benutzerdefiniertes Objekt (z. B. Project oder Project__c).

    • Warum: Das ist entscheidend. Es teilt der Komponente mit, dass sie im Kontext eines Project-Datensatzes arbeitet und die Verwendung der {!RecordId} Variablen ermöglicht.

2

Komponente zur Leinwand hinzufügen

  • Aus der Komponentenbibliothek (linke Seitenleiste) suchen Sie nach Chat.

  • Ziehen Sie die Chat Komponente auf die Leinwand ziehen.

3

Mit der Datenquelle verbinden

Wir müssen das benutzerdefinierte Objekt abfragen, in dem Nachrichten gespeichert werden.

  • Datenquelle: Abfrage.

  • Objekt: Project_Update__c (Benutzerdefiniertes Objekt).

  • Filter: Project__c gleich {!RecordId}.

    • Warum: Filtert die Liste, sodass nur Updates angezeigt werden, die sich auf den aktuellen Project-Datensatz beziehen.

  • Sortieren nach: CreatedDate ASC.

4

Daten zuordnen

Im Gegensatz zu Standardobjekten erfordern benutzerdefinierte Objekte eine explizite Zuordnung, damit Name und Bild des Benutzers korrekt angezeigt werden.

  • Inhalt: Message_Body__c (Rich-Text-Bereich-Feld)

  • Datum: CreatedDate

  • Autorname: CreatedBy.Name

  • Autor-Avatar: CreatedBy.SmallPhotoUrl

    • Warum: Dies ruft dynamisch das Salesforce-Profilbild des Benutzers ab, der das Update gepostet hat

5

Konfigurieren Sie den Publisher

Richten Sie die Eingabe so ein, dass reichhaltige Formatierung möglich ist, hilfreich für Projektstatusberichte.

  • Modus: Rich

  • Platzhalter: „Teilen Sie ein Projekt-Update...“

  • Schaltflächenbeschriftung: „Update posten"

  • Gesperrte Wörter: (Optional) Fügen Sie bei Bedarf sensible interne Projekt-Codenamen hinzu.

6

Fügen Sie die „Speichern“-Logik hinzu (Interaktion)

Konfigurieren Sie die Komponente so, dass beim Klicken der Schaltfläche ein neues Project_Update__c Datensatz erstellt wird.

  • Interaktionsauslöser: Neue Nachricht veröffentlichen

  • Aktion: Datensatz erstellen

  • Wählen: Erstellen Datensatzdaten manuell eingeben.

  • Zielobjekt: Project_Update__c

  • Feldzuordnungen:

    1. Project__c: Zuordnen zu {$Component.RecordId}

      • Kontext: Verknüpft das Update mit dem spezifischen Project.

    2. Message_Body__c: Zuordnen zu Nachricht: Inhalt

      • Kontext: Speichert den eingegebenen Inhalt.

    3. Erstellungsdatum: Nachricht: Datum

7

Echtzeit-Updates (optional)

Damit Nachrichten für alle Teammitglieder sofort erscheinen:

  1. Kanalname: Chat_Notification__e (Vorausgesetzt, Sie haben ein Platform Event erstellt).

  2. Schlüsselfeldname: RecordId__c.

Wichtige Überlegungen

  • Datenmodell-Planung: Für den Abfragemodus stellen Sie sicher, dass Ihre Salesforce-Objekte die notwendigen Felder zum Speichern von Nachrichteninhalt, Zeitstempeln und Autoreninformationen sowie Lookup-Beziehungen zu übergeordneten Datensätzen haben.

  • Ressourcenidentifikation: Die aktuelle Ressourcen-ID bestimmt die Positionierung der Nachricht. Für kundenorientierte Implementierungen überlegen Sie, wie Sie externe Teilnehmer gegenüber internen Benutzern identifizieren.

  • Zeichenbegrenzungen: Legen Sie geeignete maximale Längen basierend auf den Feldgrenzen Ihres Zielobjekts fest, um Datenkürzungen zu verhindern.

  • Gesperrte Wörter: Überprüfen und aktualisieren Sie regelmäßig Ihre Liste gesperrter Wörter, um Kommunikationsstandards aufrechtzuerhalten, ohne übermäßig restriktiv zu sein.

  • Leistung: Für Konversationen mit umfangreicher Historie verwenden Sie Abfragefilter, um die Anzahl der anfänglich geladenen Nachrichten zu begrenzen, oder ziehen Sie Paginierungsstrategien für sehr aktive Threads in Betracht.

Zusammenfassung

Die Avonni Chat-Komponente verwandelt Ihre Lightning-Seiten in kollaborative Kommunikationszentren. Egal, ob Sie interne Team-Tools oder kundenorientierte Oberflächen erstellen — die Kombination aus flexiblen Datenquellen, umfangreichen Veröffentlichungsoptionen und aktionsfähigen Interaktionen ermöglicht es Ihnen, ausgefeilte Messaging-Erlebnisse zu schaffen, die sich direkt in Ihr Salesforce-Datenmodell integrieren — ganz ohne Code.

Zuletzt aktualisiert

War das hilfreich?