Zum Hauptinhalt springen

Einrichten eines benutzerdefinierten Objekts

So modellieren und speichern Sie externe Daten passend zu Ihrem spezifischen Anwendungsfall mit benutzerdefinierten Objekten.

Verfasst von Beth-Ann Sher

Benutzerdefinierte Objekte machen Intercom anpassbarer, indem sie Ihnen eine flexible Möglichkeit bieten, Ihre externen Daten so zu importieren und zu modellieren, dass sie für Ihr Unternehmen sinnvoll sind, ohne dass technische Ressourcen oder der Aufbau benutzerdefinierter Integrationen erforderlich sind.

Nach der Konfiguration erhalten Sie eine genauere, einheitliche Kundenansicht, die alle Funktionen von Intercom kontextbezogener macht, was zu besseren Kundenerlebnissen und leistungsfähigeren Möglichkeiten für Teammitglieder führt. Mit benutzerdefinierten Objekten können Sie Bots erstellen, die komplexe Anfragen lösen, ausgeklügelte Support-workflows erstellen und Ihren Support-Mitarbeitern Zeit im Inbox sparen.

Zum Beispiel könnte ein E-Commerce-Kunde:

  • Seinen Bestellstatus oder Liefertermin sehen.

  • Mehrere Bestellungen, die mit seinem Konto verknüpft sind, anzeigen und eine auswählen.

  • Eine Bestellung stornieren.

Ein benutzerdefiniertes Objekt erstellen

Erstellen Sie Ihr erstes benutzerdefiniertes Objekt, indem Sie auf „Neues Objekt erstellen“ klicken. Geben Sie dem Objekt einen Namen (z. B. Bestellung) und klicken Sie dann auf „Speichern“.

Hinweis: Der Objektname ist die Bezeichnung, mit der Sie es später in Ihren workflows identifizieren. Er muss ein eindeutiger Name sein und kann nach dem Speichern nicht mehr umbenannt werden.

Dies erstellt ein neues übergeordnetes Objekt mit einigen empfohlenen Standardattributen:

  • ‘external_id’

  • ‘external_created_at’

  • ‘external_updated_at’

Erstellen Sie eigene Attribute

Sie können eigene Attribute hinzufügen, indem Sie auf „+ Attribut erstellen“ klicken:

Wählen Sie das Format für dieses Attribut. Sie können wählen aus:

  • Text - Um einfache Informationen anzuzeigen, wie z. B. ob eine Bestellung „storniert“ oder „offen“ ist.

  • Zahl - Um einen numerischen Wert wie eine Bestell-ID anzuzeigen.

  • Dezimalzahl - Um einen numerischen Wert mit Dezimalstellen wie den Bestellpreis anzuzeigen.

  • Liste - Um mehrere Werte anzuzeigen.

  • Boolesch - Um einen Wert anzuzeigen, der entweder wahr oder falsch ist.

  • Datum - Um ein Datum anzuzeigen.

  • Referenz - Um dieses Objekt mit einem anderen Standard- oder benutzerdefinierten Objekt zu verknüpfen.

Geben Sie dem Attribut einen eindeutigen Namen und beschreiben Sie, was es tut. In diesem Beispiel verwenden wir das boolesche Format, um anzugeben, ob eine Bestellung versandt wurde:

Hinweis: Der Attributname ist ein eindeutiger Bezeichner und kann nach dem Speichern nicht mehr umbenannt werden.

Sie können weiterhin verschiedene Attributtypen erstellen und speichern, die dann unter dem benutzerdefinierten Objekt angezeigt werden:

Ein benutzerdefiniertes Objekt mit einem anderen Objekt verknüpfen

Um das benutzerdefinierte Objekt in Ihren Bot-Flows zu verwenden und Kunden automatisch Objektdaten zur Auswahl anzubieten, müssen Sie eine Referenz zwischen Ihrem benutzerdefinierten Objekt und Ihren anderen Datenobjekten (People und Conversation) erstellen. Erfahren Sie hier, wie Sie Referenzen für benutzerdefinierte Objekte einrichten.

Erstellen Sie eine Referenz zwischen Objekten, indem Sie erneut auf „+ Attribut erstellen“ klicken:

Wählen Sie im Dropdown-Menü den Formattyp ‚Referenz‘ aus:

Wählen Sie das zu verknüpfende Objekt aus der Liste aus. Hinweis: Dies umfasst Standardobjekte wie ‚People‘ und ‚Conversation‘ sowie andere benutzerdefinierte Objekte.

  • Erstellen Sie ein neues Referenzattribut:

    • Benennen Sie die Referenz

    • Option: Mehrere Personen referenzieren zulassen = Aus

    • Option: Mehrere Personen referenzieren zulassen = Ein

    • Hinweis: Standardmäßig ist ‚hat viele‘ aktiviert

Wichtig: Die Richtung einer Referenz kann wichtig sein. Referenzattribute können auch auf die Objekte People und Conversation auf die gleiche Weise wie oben beschrieben hinzugefügt werden. Gehen Sie dazu in den Einstellungen zu diesen Datenobjekten und erstellen Sie die Attribute.

  • People

  • Conversation

  • Benutzerdefiniertes Objekt

Ein benutzerdefiniertes Objekt mit Datenwerten füllen

Als Nächstes müssen Sie Ihr benutzerdefiniertes Objekt mit Daten füllen. Dies kann derzeit nur über die Verwendung eines Datenconnectors erfolgen, um Daten aus einem externen System über eine GET-Anfrage abzurufen.
Das Befüllen über den Messenger-JS-Snippet ist derzeit nicht verfügbar.

Verwendung eines Datenconnectors

Datenconnectors können verwendet werden, um ein Array von Objekten von einem Endpunkt zurückzugeben und dann die Antwortdaten einem benutzerdefinierten Objekt zuzuordnen. Erfahren Sie hier, wie Sie Datenconnectors einrichten.

API-Abrufbeschränkungen

Hinweis: Attribute, die über workflows oder Datenconnectors gesetzt werden, können in der Benutzeroberfläche angezeigt werden, sind jedoch in API-Antworten nicht verfügbar, es sei denn, der Datenconnector ist so zugeordnet, dass die Daten im richtigen Conversation-Referenzattribut gespeichert werden.

  1. Überprüfen Sie die Zuordnungen der Datenconnectors.

  2. Überprüfen Sie die Einstellungen der Referenzattribute (einzeln vs. mehrfach).

  3. Bestätigen Sie API-Berechtigungen und Token-Bereiche.

Was kommt als Nächstes?

Verwenden Sie dieses benutzerdefinierte Objekt in Ihren Workflows, um Kunden kontextbezogenen Support zu bieten. Kunden können basierend auf den gespeicherten Objektdaten Antwortschaltflächen im Bot-Flow sehen und auswählen.

Hat dies deine Frage beantwortet?