Bloque de flujo: Establecer atributos de contacto - Amazon Connect

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.

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

Chat

Tarea

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. Está configurado para establecer un atributo definido por el usuario en el contacto actual con la clave greetingPlayedy el valor true.

La página de propiedades del bloque Establecer atributos de contacto.

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 V2, pueden acceder a los GetMetricData atributos. API

  • 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. RelatedContactId

  • 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 ante el agente en elCCP.

    • No GetContactAttributes API pueden 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 ver la JSON sintaxis de cada atributo, consulteLista de atributos de contacto disponibles y su JSONPath referencia.

  • 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 de un espacio de nombres diferente, como hacer referencia a un atributo externo, debe especificar la JSONPath sintaxis del atributo.

  • Para usar los atributos de contacto para acceder a otros recursos, defina un atributo definido por el usuario en su flujo y use el nombre del recurso de Amazon (ARN) del recurso al que desea acceder como valor del 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 una línea de comandos de Amazon Connect en una función de Lambda, defina un atributo definido por el usuario en el valor de la ARN línea de comandos y, a continuación, acceda a ese atributo desde la función 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 para bots de Amazon Lex, utiliza $.Lex.Slots. slotName, slotNamesustituyéndolo por el nombre de la ranura del 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 los atributos. 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.

    La página de propiedades de Establecer atributos de contacto, Valor 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.

Un bloque Establecer atributos de contacto configurado.

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.

Escenarios

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