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_fieldsBestimmtes 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_customerreserved_bad_actorreserved_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
Erstellen Sie das benutzerdefinierte Feld und die Werte in Ihrem CRM.
Weisen Sie den Kontakten in Ihrem CRM die neuen Werte zu.
Konfigurieren Sie die Einstellung im CCAI Platform-Portal.
Test.
Zendesk-Konfiguration
In den folgenden Abschnitten wird beschrieben, wie Sie Feldzuordnungen für Zendesk CRM konfigurieren.
Benutzerdefiniertes Feld für Nutzer (Kontakt) erstellen
Melden Sie sich als Administrator in Zendesk an.
Klicken Sie auf , um die Admin-Optionen aufzurufen.
Wählen Sie Nutzerfelder aus.
Wählen Sie den Feldtyp aus, den Sie erstellen möchten.

Fügen Sie in der Ansicht eines KI-Agenten einen Feldtitel und einen Namen hinzu.
Der Feldschlüssel wird automatisch ausgefüllt.
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.

Benutzerdefiniertes Feld für Ticket erstellen
Melden Sie sich als Administrator in Zendesk an.
Klicken Sie auf das Symbol , um die Admin-Optionen aufzurufen.
Wählen Sie Ticketfelder aus.
Klicken Sie auf den Button Benutzerdefiniertes Feld hinzufügen.
Wählen Sie den gewünschten Feldtyp aus, indem Sie auf Auswählen klicken.
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.

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
Gehen Sie zu Einrichtung.
Wählen Sie Object Manager (Objektmanager) aus.
Wählen Sie das Objekt aus, an das Sie benutzerdefinierte Felder anhängen möchten (Fall oder CCAI Platform-Sitzung).
Klicken Sie auf Fields & Relationships (Felder und Beziehungen).
Klicken Sie auf Neu.
Wählen Sie als Datentyp Text aus.
Geben Sie unter Feldbezeichnung einen Namen für das Feld ein.
Geben Sie unter Länge den Wert 255 ein.
Der Feldname sollte automatisch ausgefüllt werden, nachdem Sie das Feldlabel eingegeben haben.

Sie können die restlichen Variablen auf ihren Standardwerten belassen.
Klicken Sie auf Weiter.
Setzen Sie das Häkchen bei Sichtbar für alle Profile, die auf das Objekt (Fall oder CCAI Platform-Sitzung) zugreifen.
Klicken Sie auf Weiter.
Klicken Sie auf Speichern.
Dadurch gelangen Sie zurück zur Ansicht Fields & Relationships. Suchen Sie das Feld, das Sie gerade erstellt haben, und notieren Sie sich den Feldnamen.

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:

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:
Rufen Sie im CCAI Platform-Portal Einstellungen > Betriebsverwaltung auf.
Gehen Sie zum Bereich CRM Custom Field Mapping (Zuordnung benutzerdefinierter CRM-Felder) und klicken Sie auf View All (Alle ansehen).
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 demcustom_data object)Beispiele für die Apps API (Chat):
orderId,customerTier(aus dem Datenobjekt der Apps API-Anfrage).
Klicken Sie auf Speichern.