Bloque de flujo: Establecer atributos de contacto

Descripción

Almacena pares de clave-valor como atributos de contacto. Establezca un valor al que se haga referencia más adelante en un flujo.

Por ejemplo, cree un saludo personalizado para los clientes dirigidos a una cola basada en el tipo de cuenta del cliente. También puede definir un atributo para un nombre de empresa o de líneas de negocios para incluir en las cadenas de texto a voz que se dicen a un cliente.

El bloque Establecer atributos de contacto es útil, por ejemplo, para copiar atributos recuperados de orígenes externos a atributos definidos por el usuario.

Para obtener más información sobre los atributos de contacto, consulte Uso de los atributos de contacto de Amazon Connect.

Canales compatibles

En la siguiente tabla se enumera cómo enruta este bloque a un contacto que está utilizando el canal especificado.

Canal	¿Se admite?
Voz	Sí
Chat	Sí
Tarea	Sí

Tipos de flujo

Puede utilizar este bloque en los siguientes tipos de flujo:

• Todos los flujos

Propiedades

En la siguiente imagen se muestra la página Propiedades del bloque Establecer atributos de contacto. Se ha configurado para establecer un atributo definido por el usuario en el Contacto actual con la clave greetingPlayed y el valor verdadero.

Puede elegir establecer los atributos en:

• Contacto actual: los atributos se establecen en el contacto en el que se ejecuta este flujo. Otras áreas de Amazon Connect, como otros flujos, módulos, Lambdas, registros de contactos y la API GetMetricData V2, pueden acceder a los atributos.

• Contacto relacionado: los atributos están asociados a un contacto nuevo que contiene una copia de las propiedades del contacto original.

  En el registro de contactos, este es el RelatedContact identificador.

• Flujo: los atributos de flujo están restringidos al flujo en el que se configuran.

  Los atributos de flujo son útiles en situaciones en las que no desea que los datos persistan durante todo el contacto, por ejemplo, cuando necesita utilizar información confidencial como el número de la tarjeta de crédito del cliente para realizar un análisis de datos de Lambda.

  • Los atributos de flujo son variables temporales que se almacenan localmente y que solo se utilizan en el flujo. No son visibles en ningún lugar fuera del flujo, ni siquiera cuando el contacto se transfiere a otro flujo.

  • Pueden tener un tamaño máximo de 32 KB (el tamaño máximo de la sección de atributos del registro de contactos).

  • No se pasan a una Lambda a menos que se configuren explícitamente como parámetros: en el bloque Invocar función de AWS Lambda, elija Agregar un parámetro.

  • No se transfieren a los módulos. Puede establecer un atributo de flujo en un módulo, pero no saldrá de él.

  • No aparecen en el registro de contacto.

  • No aparecen para el agente del CCP.

  • La API GetContactAttributes no puede exponerlos.

  • Si tiene habilitado el registro en el flujo, la clave y el valor aparecerán en el registro de CloudWatch.

Cómo hacer referencia a los atributos

• Para conocer la sintaxis JSON de cada atributo, consulte Lista de atributos de contacto disponibles y su referencia de JSONPath.

• Para hacer referencia a atributos que contienen caracteres especiales en su nombre, como espacios, coloque corchetes y comillas simples alrededor del nombre de atributo. Por ejemplo: $.Attributes.['user attribute name'].

• Para hacer referencia a atributos en el mismo espacio de nombres, como, por ejemplo, un atributo del sistema, se utiliza el nombre de atributo o el nombre especificado como Clave de destino.

• Para hacer referencia a valores en un espacio de nombres diferente, como, por ejemplo, hacer referencia a un atributo externo, debe especificar al atributo la sintaxis de JSONPath.

• Para utilizar atributos de contacto para obtener acceso a otros recursos, establezca un atributo definido por el usuario en su flujo y utilice el nombre de recurso de Amazon (ARN) del recurso al que desea obtener acceso como el valor para el atributo.

Ejemplos de Lambda

• Para hacer referencia al nombre de un cliente desde una búsqueda de funciones de Lambda, utilice $.External. AttributeKey, AttributeKey sustituyéndolo por la clave (o nombre) del atributo devuelto por la función Lambda.

• Para utilizar un mensaje de Amazon Connect en una función de Lambda, establezca un atributo definido por el usuario al ARN del mensaje y, a continuación, obtenga acceso a dicho atributo desde la función de Lambda.

Ejemplos de Amazon Lex

• Para hacer referencia a un atributo de un bot de Amazon Lex, se utiliza el formato $.Lex. y, a continuación, se incluye la parte del bot de Amazon Lex a la que se va a hacer referencia, como $.Lex. IntentName.

• Para hacer referencia a la entrada del cliente a una ranura de bot de Amazon Lex, utilice $.Lex.Slots.slotName y reemplace slotName por el nombre de la ranura en el bot.

¿Qué ocurre cuando los atributos superan los 32 KB?

Los atributos pueden tener un tamaño máximo de 32 KB, que es el tamaño máximo de la sección de atributos del registro de contactos. Cuando los atributos de un contacto superan los 32 KB, el contacto se redirige a la rama de errores. Como medida de mitigación, considere las siguientes opciones:

• Elimine los atributos innecesarios estableciendo sus valores en vacíos.

• Si los atributos solo se utilizan en un flujo y no es necesario hacer referencia a ellos fuera de ese flujo (por ejemplo, mediante una Lambda u otro flujo), utilice los atributos de flujo. De esta forma, no se transfieren innecesariamente los 32 KB de información de un flujo a otro.

Sugerencias de configuración

• Cuando utilice una clave de destino definida por el usuario, puede asignarle el nombre que desee, pero no incluya los caracteres $ ni . (punto). No están permitidos porque ambos se utilizan para definir las rutas de atributos en JSONPath.

• Puede utilizar el bloque Establecer atributo de contacto para establecer el atributo de idioma necesario para un bot de Amazon Lex V2. (Su atributo de idioma en Amazon Connect debe coincidir con el modelo de idioma utilizado para crear su bot de Amazon Lex V2). En la siguiente imagen se muestra un atributo de idioma establecido a español.

  

  O puede utilizar el bloque Establecer voz para establecer el atributo de idioma necesario para un bot de Amazon Lex V2.

Para obtener más información sobre cómo usar los atributos de conecto, consulte Uso de los atributos de contacto de Amazon Connect.

Bloque configurado

En la siguiente imagen se muestra un ejemplo del aspecto de este bloque cuando está configurado. Tiene dos ramificaciones: Correcto y Error.

Flujos de ejemplo

Amazon Connect incluye un conjunto de flujos de muestra. Para obtener instrucciones que expliquen cómo acceder a los flujos de muestra en el diseñador de flujos, consulte Flujos de ejemplo. A continuación se describen en los siguientes temas los flujos de muestra que incluyen este bloque.

• Flujo de entrada de ejemplo (experiencia de primer contacto)

Escenarios

Consulte estos temas para conocer los escenarios en los que se utiliza este bloque:

• Cómo hacer referencia a atributos de contacto