View a markdown version of this page

Detalles de la definición del mapeo de tipos de objetos en los perfiles de clientes de Connect Customer - Amazon Connect Customer

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Detalles de la definición del mapeo de tipos de objetos en los perfiles de clientes de Connect Customer

La definición de asignación de tipo de objeto consta de dos partes: la definición de campo y la definición de clave.

sugerencia

Detalles de la definición de campo

La definición de campo define el origen, el destino y el tipo de campo. Por ejemplo:

"Fields": { "{fieldName}": { "Source": "{source}", "Target": "{target}", "ContentType": "{contentType}" }, ... }, ...
  • Source: puede ser un descriptor de acceso JSON para el campo o una macro Handlebar para generar el valor del campo.

    El objeto de origen que se está analizando se denomina _source, por lo que todos los campos de origen deben ir precedidos de esta cadena. Solo se admite el objeto _source.

    Utilice la solución de macros Handlebar para generar constantes y combinar varios campos de objetos de origen en un solo campo. Esto resulta útil para la indexación.

  • Target: especifica en qué parte de un tipo de objeto estándar deben asignarse los datos de este campo.

    Al rellenar el perfil estándar, puede usar los datos ingeridos de cualquier fuente de datos con aplicaciones creadas sobre los perfiles de los clientes sin tener conocimientos específicos sobre el formato de los datos que se están ingiriendo.

    Este campo es opcional. Puede que desee definir campos con el único propósito de incluirlos en una clave.

    El formato de este campo es siempre un descriptor de acceso JSON. El único objeto de destino admitido es _profile.

  • ContentType: se admiten los valores STRING, NUMBER, PHONE_NUMBER, EMAIL_ADDRESS y NAME. Si no se especifica ContentType se asume STRING.

    ContentType se utiliza para determinar cómo indexar el valor para que los agentes puedan buscarlo. Por ejemplo, si ContentType se establece a PHONE_NUMBER, se procesa un número de teléfono para que los agentes puedan buscarlo en cualquier formato: la cadena “+15551234567” coincide con “(555)-123-4567”.

Detalles de la definición de clave

Una clave contiene uno o más campos que, en conjunto, definen una clave que se puede usar para buscar objetos (o los perfiles a los que pertenecen) mediante la SearchProfiles API. La clave también se puede definir para identificar de forma exclusiva un perfil o identificar de forma exclusiva el objeto en sí.

"Keys": { "{keyName}": [{ "StandardIdentifiers": [...], "FieldNames": [ "{fieldname}", ...] }], ... }, ...

Los nombres de clave son globales para un dominio. Si tiene dos claves con el mismo nombre en dos asignaciones de tipo de objeto diferentes:

  • Esas claves deben ocupar el mismo espacio de nombres.

  • Se pueden utilizar para enlazar potencialmente perfiles entre diferentes objetos. Si coinciden entre los objetos, Perfiles de clientes coloca los dos objetos en el mismo perfil.

Para expresarlo de otra manera: las claves deben tener el mismo nombre de clave en un dominio si, y solo si, el mismo valor significa que están relacionadas. Por ejemplo, un número de teléfono especificado en un tipo de objeto estaría relacionado con el mismo número de teléfono especificado en otro tipo de objeto. Un identificador interno especificado para un objeto importado de Salesforce podría no estar relacionado con otro objeto importado de Marketo, aunque tengan exactamente el mismo valor.

Las definiciones de clave se utilizan de dos formas:

  • En Perfiles de clientes durante la ingesta, se utilizan para averiguar a qué perfil debe asignarse el objeto.

  • Puedes usar la SearchProfiles API para buscar el valor de la clave y encontrar el perfil.

Teclas de búsqueda predeterminadas

Las teclas de búsqueda predeterminadas, como _phone y _email, están predefinidas en las plantillas de objetos de perfil estándar, activo estándar, pedido estándar y caso estándar. Puedes usar las claves de búsqueda predeterminadas como nombre de clave en la SearchProfiles API para encontrar un perfil.