Benutzerdefinierte CRM-Feldzuordnung (Salesforce, Zendesk, Kustomer)

Damit Metadaten aus CRM-Einträgen schnell analysiert werden können, können die Web- und Mobile-SDKs der CCAI Platform sowie die Apps API (Chat) Daten in benutzerdefinierte CRM-Felder übertragen.

Mit der benutzerdefinierten Feldzuordnung können Sie Kundendaten-Schlüssel der CCAI Platform (Portal-UI: Benutzerdefiniertes Datenfeldlabel) CRM-Feldern oder -Attributen zuordnen, sodass die zugeordneten Werte automatisch in den entsprechenden CRM-Eintrag geschrieben werden.

Benutzerdefinierte Datenschlüssel können von folgenden Quellen bereitgestellt werden:

  • CCAI Platform Web- und Mobile-SDKs oder

  • Apps API (Chat) mit dem Endpunkt Benutzerdefinierte Daten in einem Chat senden.

Beispiel für Mobile SDK API

In den folgenden Abschnitten finden Sie ein Beispiel für das mobile SDK.

Daten vom SDK zum Server

{
    custom_data: { # same format with previous custom data from SDK
        data_name: {
            value: value,
            type: string,
            label: "Data Name",
        },
        device: { # example
            value: "iOS",
            type: "string",
            label: "Device Type"}
    }
}

Daten vom Server zum CRM-Adapter

{
    key: {
        crm_field: "crm custom field name",
        type: "text", # text / checkbox ...,
        value: "value"
    },
    device: { # example
        crm_field: "device",
        type: "text", 
        value: "iOS"
    }
}

API-Endpunkt

Auf die Zuordnung benutzerdefinierter CRM-Felder kann über eine API zugegriffen werden. Die folgenden Endpunkte sind verfügbar:

  • Alle Felder abrufen: HTTP-POST oder -GET: /crm_custom_fields

  • Bestimmtes Feld aktualisieren oder löschen: HTTP PUT oder DELETE /crm_custom_fields/:id

Beispiel für die Apps API (Chat) (ohne SDK)

Kunden, die die Apps API direkt (ohne CCAI Platform Web oder Mobile SDKs) verwenden, können weiterhin die benutzerdefinierte Feldzuordnung für Chat-Interaktionen verwenden, indem sie benutzerdefinierte Daten für eine vorhandene Chatsitzung senden.

  • Endpunkt: POST /apps/api/v1/chats/:id/custom_data

Anfragetext (ungesichert/unsigniert)

{
  "signed": false,
  "data": {
    "orderId": {
      "label": "Order ID",
      "value": "12345"
    },
    "customerTier": {
      "label": "Customer Tier",
      "value": "gold"
    }
  }
}

Anfragetext (gesichertes/signiertes JWT)

{
  "signed": true,
  "signed_data": "<JWT>"
}

JWT-Nutzlastform (Beispiel)

{
  "custom_data": {
    "orderId": { "label": "Order ID", "value": "12345" },
    "customerTier": { "label": "Customer Tier", "value": "gold" }
  },
  "exp": 1734567890,
  "iat": 1734560000
}

Benutzerdefinierte Feldzuordnung auf Apps API-Nutzlasten anwenden

Legen Sie im CCAI Platform-Portal das Label für benutzerdefiniertes Datenfeld (benutzerdefinierter Datenschlüssel) auf den Schlüssel auf oberster Ebene unter dem Apps API-Nutzlastobjekt data fest (z. B. orderId oder customerTier) und ordnen Sie es dem ausgewählten CRM-Feld oder der ausgewählten CRM-Property zu.

Hier sind zwei Beispiele:

  • Maps nach Schlüssel: orderId, customerTier
  • Keine Zuordnung nach verschachteltem Label: "label": "Order ID" ist Anzeigetext und wird nicht für die Zuordnung verwendet.

Reservierte Schlüssel (Kunden-Flags)

Möglicherweise werden reservierte Schlüssel wie die folgenden angezeigt:

  • reserved_verified_customer

  • reserved_bad_actor

  • reserved_repeat_customer

Diese Schlüssel werden hauptsächlich für das Verhalten von Kunden-Flags verwendet. Um Verwirrung zu vermeiden, sollten Sie reserved_*-Schlüssel nur dann als benutzerdefinierte CRM-Felder zuordnen, wenn Sie einen bestimmten Berichtsbedarf haben. Bevorzugen Sie die Zuordnung geschäftsspezifischer Schlüssel (z. B. orderId, customerTier usw.) für die Zuordnung benutzerdefinierter CRM-Felder.

Schritte zum Konfigurieren der benutzerdefinierten CRM-Feldzuordnung

  1. Erstellen Sie das benutzerdefinierte Feld und die Werte in Ihrem CRM.

  2. Weisen Sie den Kontakten in Ihrem CRM die neuen Werte zu.

  3. Konfigurieren Sie die Einstellung im CCAI Platform-Portal.

  4. Test.

Zendesk-Konfiguration

In den folgenden Abschnitten wird beschrieben, wie Sie Feldzuordnungen für Zendesk CRM konfigurieren.

Benutzerdefiniertes Feld für Nutzer (Kontakt) erstellen

  1. Melden Sie sich als Administrator in Zendesk an.

  2. Klicken Sie auf , um die Admin-Optionen aufzurufen.

  3. Wählen Sie Nutzerfelder aus.

  4. Wählen Sie den Feldtyp aus, den Sie erstellen möchten.

    Feldtyp auswählen

  5. Fügen Sie in der Ansicht eines KI-Agenten einen Feldtitel und einen Namen hinzu.

    Der Feldschlüssel wird automatisch ausgefüllt.

  6. Klicken Sie auf Feld erstellen.

Dieses neue Feld wird jetzt in der Liste Aktive Felder und in der linken Spalte angezeigt, wenn Sie einen Nutzer aufrufen.

Anzeige aktiver Felder

Benutzerdefiniertes Feld für Ticket erstellen

  1. Melden Sie sich als Administrator in Zendesk an.

  2. Klicken Sie auf das Symbol , um die Admin-Optionen aufzurufen.

  3. Wählen Sie Ticketfelder aus.

  4. Klicken Sie auf den Button Benutzerdefiniertes Feld hinzufügen.

  5. Wählen Sie den gewünschten Feldtyp aus, indem Sie auf Auswählen klicken.

  6. Fügen Sie einen Feldtitel hinzu. Der Feldtitel wird in der Ansicht des KI-Agenten angezeigt.

    Wir empfehlen, denselben Wert wie für crm_field aus der API zu verwenden.

    Anzeige des Feldtitels

  7. Klicken Sie auf den Button Feld hinzufügen.

Dieses neue Feld wird jetzt in der Liste Aktive Felder angezeigt. Wenn Sie ein Ticket aufrufen, wird es in der linken Spalte angezeigt.

Salesforce-Konfiguration

  1. Gehen Sie zu Einrichtung.

  2. Wählen Sie Object Manager (Objektmanager) aus.

  3. Wählen Sie das Objekt aus, an das Sie benutzerdefinierte Felder anhängen möchten (Fall oder CCAI Platform-Sitzung).

  4. Klicken Sie auf Fields & Relationships (Felder und Beziehungen).

  5. Klicken Sie auf Neu.

  6. Wählen Sie als Datentyp Text aus.

  7. Geben Sie unter Feldbezeichnung einen Namen für das Feld ein.

  8. Geben Sie unter Länge den Wert 255 ein.

    Der Feldname sollte automatisch ausgefüllt werden, nachdem Sie das Feldlabel eingegeben haben.

    Anzeige des Feldlabels

    Sie können die restlichen Variablen auf ihren Standardwerten belassen.

  9. Klicken Sie auf Weiter.

  10. Setzen Sie das Häkchen bei Sichtbar für alle Profile, die auf das Objekt (Fall oder CCAI Platform-Sitzung) zugreifen.

  11. Klicken Sie auf Weiter.

  12. Klicken Sie auf Speichern.

  13. Dadurch gelangen Sie zurück zur Ansicht Fields & Relationships. Suchen Sie das Feld, das Sie gerade erstellt haben, und notieren Sie sich den Feldnamen.

    Ansicht „Felder und Beziehungen“

  14. Der Feldname ist der Name, den Sie auf der Seite „Benutzerdefinierte Feldzuordnung“ der CCAI Platform in das Feld CRM-Feldlabel eingeben.

Das folgende Beispiel zeigt, wie ein neues Feld aussieht, wenn es richtig eingerichtet und für das Fallobjekt verwendet wird:

Anzeige des neuen Felds

Kustomer-Konfiguration

Weitere Informationen zum Einrichten benutzerdefinierter Felder finden Sie in der Kustomer-Hilfe.

CCAI Platform-Konfiguration

In den folgenden Abschnitten werden die Änderungen beschrieben, die im CCAI Platform-Portal erforderlich sind, um die Feldzuordnung für Kustomer CRM zu konfigurieren:

  1. Rufen Sie im CCAI Platform-Portal Einstellungen > Betriebsverwaltung auf.

  2. Gehen Sie zum Bereich CRM Custom Field Mapping (Zuordnung benutzerdefinierter CRM-Felder) und klicken Sie auf View All (Alle ansehen).

  3. Klicken Sie auf den Link + CRM-Feldzuordnung hinzufügen.

    • Titel der Feldzuordnung: CCAI Platform-Name für diese benutzerdefinierte Feldzuordnung, die im CCAI Platform-Portal verwendet wird.

    • CRM-Feldlabel: Label des CRM-Felds in Ihrem CRM-System, dem Sie die Daten zuordnen.

    • Benutzerdefiniertes Datenfeldlabel: Benutzerdefiniertes Datenfeldlabel, von dem Sie die Zuordnung vornehmen.

    • SDK-Beispiele: data_name, device (aus dem custom_data object)

    • Beispiele für die Apps API (Chat): orderId, customerTier (aus dem Datenobjekt der Apps API-Anfrage).

  4. Klicken Sie auf Speichern.