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.
# Búsqueda de contactos completados y en curso en Amazon Connect
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Connect Customer administración o en el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Este tema está dirigido a los administradores y gerentes de centros de contacto que necesiten buscar contactos en el sitio web de Connect Customer administración. Para obtener APIs información sobre cómo buscar contactos mediante programación, consulte. [APIs para buscar contactos](#apis-search-contacts)
**Topics**
+ [Cosas importantes que debe saber](#important-contact-search)
+ [Características de búsqueda clave](#key-search-features)
+ [Administración de quién puede buscar contactos y acceder a información detallada](#required-permissions-search-contacts)
+ [Cómo buscar un contacto.](#how-to-search-contacts)
+ [Campos adicionales: agregar columnas a los resultados de la búsqueda](#additional-fields)
+ [Descarga de los resultados de la búsqueda](#download-search-results)
+ [APIs para buscar contactos](#apis-search-contacts)
+ [Búsqueda de contactos en curso en Amazon Connect](search-in-progress-contacts.md)
+ [Búsqueda de contactos en Amazon Connect mediante atributos de contacto personalizados o atributos de segmentos de contactos](search-custom-attributes.md)
## Cosas importantes que debe saber
+ Puede buscar contactos de hace dos años como máximo.
+ Puede buscar contactos completados y en curso. En el caso de los contactos gestionados por agentes, un contacto solo se marca como completado después de que el agente haya completado After Contact Work (ACW).
+ La capacidad de buscar contactos en curso varía según el canal (consulte [Modelo de datos de eventos de contacto](contact-events.md#contact-events-data-model) como referencia):
+ **Voz**
+ Puede buscar las llamadas en cola en curso después de que estén en cola, conectadas a un agente o desconectadas.
+ En el caso de otros contactos de voz, solo puede buscarlos después de que estén conectados a un agente o se hayan desconectado. Los contactos de voz en curso que están en cola (con la excepción de las llamadas rellamadas) no se muestran en la página de búsqueda de **contactos**.
+ **Chat**: puede buscar contactos cuando estén conectados al sistema, estén en cola, estén conectados a un agente o desconectados.
+ **Tareas** y **Correo electrónico**: puede buscar todos los que estén en curso una vez iniciados.
+ Los resultados de búsqueda de una consulta determinada están limitados a los primeros 10 000 resultados devueltos.
+ No puedes buscar varios contactos IDs al mismo tiempo.
## Características de búsqueda clave
+ [Búsqueda por atributos de contacto personalizados](search-custom-attributes.md) (atributos definidos por el usuario).
+ [Búsqueda de contactos en curso](search-in-progress-contacts.md) o completados mediante el filtro **Estado de contacto**.
+ Búsqueda de un intervalo de tiempo de hasta ocho semanas. En el filtro de intervalo temporal, puede especificar el **Tipo de marca temporal**. De este modo, podrá especificar el intervalo de tiempo. Puede elegir entre marcas temporales iniciadas, conectadas al agente, desconectadas y programadas.
**importante**
El filtro de marca temporal de la búsqueda de contactos tiene el tipo de marca temporal establecido a “Iniciado” de forma predeterminada. Antes de que se incorporara la selección del tipo de marca temporal, el tipo de marca temporal que utilizaba el filtro de intervalo de tiempo era “Desconectado”.
Las búsquedas guardadas en Búsqueda de contactos creadas antes del lanzamiento de la posibilidad de buscar contactos en curso (se lanzó en septiembre de 2023) se han actualizado con los filtros Estado del contacto = “Completado” y Tipo de marca temporal = “Desconectado”. Estas selecciones estaban implícitas antes del lanzamiento de los contactos en curso.
+ Seleccione varios filtros para ver los nombres de los agentes, las colas de contactos y el nombre del flujo inicial del contacto.
+ Filtre por jerarquía de agentes. Puede aplicar filtros progresivamente para desglosar los niveles jerárquicos de los agentes.
**nota**
Al seleccionar varios valores en cualquier nivel jerárquico, no podrá filtrar los siguientes niveles jerárquicos.
+ Filtre los contactos por canal y subtipo de canal, como los SMS.
+ Filtre para buscar contactos de correo electrónico mediante la dirección de correo electrónico (Para, De y CC) y el asunto del correo electrónico. La búsqueda por asunto del correo electrónico no distingue entre mayúsculas y minúsculas. Además, la búsqueda de un subconjunto de palabras en el asunto de un correo electrónico proporciona resultados de búsqueda. Por ejemplo, si escribe **consulta**, Amazon Connect devuelve los correos electrónicos con el asunto **Consulta del cliente**.
+ Filtros para el [análisis de conversaciones](analyze-conversations.md). Puedes buscar contactos que tengan habilitada la analítica conversacional. Por ejemplo, la analítica **conversacional: la interacción entre voz y agente devuelve los contactos en los que la interacción entre el agente ha sido analizada mediante la analítica** conversacional. Puede hacerlo [search for Contact categories](search-conversations.md#contact-category-search)especificando el nombre completo de la categoría. Elija buscar con **Coincida con cualquiera**, **Coincida con todo** o **Coincida con ninguna**. Por ejemplo, puedes buscar contactos con la «categoría A» y la «categoría B», o con cualquiera de las dos categorías.
Puedes consultar la lista completa de filtros [here](search-conversations.md)de análisis conversacional. Puede aplicar estos filtros solo si su organización ha habilitado Contact Lens.
En el cuadro desplegable **Agregar filtro**, los filtros de Contact Lens tienen **CL** al lado. Puede aplicar estos filtros solo si su organización ha habilitado Contact Lens.
Si desea eliminar los filtros de Contact Lens de la lista desplegable de un usuario, elimine los siguientes permisos de su perfil de seguridad:
+ **Buscar contactos por conversación**: controla el acceso a las puntuaciones de opinión, el tiempo sin conversación y las búsquedas por categorías.
+ **Buscar contactos por palabras clave**: controla el acceso a la búsqueda de palabras clave.
+ **Contact Lens: análisis de las conversaciones**: en la página **Datos de contacto**, se muestran gráficos que resumen el análisis de conversaciones.
+ Filtros para grabaciones. Con el filtro de **grabación**, puede filtrar los contactos con una grabación de pantalla (vídeo) o una grabación de audio (voz).
+ Filtro por región activa. Busque los contactos por la región de AWS en la que se gestionaron. Este filtro está disponible para las instancias de Amazon Connect que utilizan resiliencia global, en las que los contactos pueden gestionarse en una región de AWS diferente a la región en la que ha iniciado sesión.
**importante**
Es posible que algunas funciones de Amazon Connect no estén disponibles al acceder a los datos de contacto entre regiones. Para obtener información completa, consulte la[Configuración de Resiliencia global de Amazon Connect](setup-connect-global-resiliency.md).
+ Filtros para [Voice ID](voice-id.md). Puede buscar la autenticación de Voice ID y el estado de detección de fraude de los contactos, si su organización ha habilitado Voice ID. Para acceder a esta funcionalidad, en su perfil de seguridad, necesita el permiso **Análisis y optimización**, **ID de voz: atributos y búsqueda** - **Ver**.
En la siguiente imagen se muestran los filtros disponibles para buscar Voice ID: **Resultado de la autenticación**, **Resultado de la detección de fraude** y **Acciones del hablante**.
## Administración de quién puede buscar contactos y acceder a información detallada
Para que los usuarios puedan buscar contactos en Amazon Connect o acceder a información de contacto detallada, deben estar asignados al perfil de **CallCenterManager**seguridad o disponer de los siguientes permisos de **análisis y optimización**:
+ Se requiere al menos uno de los siguientes permisos para ver los contactos en las páginas **Búsqueda de contactos** y **Datos de contacto**:
+ **Búsqueda de contactos - Ver**: permite a un usuario acceder a todos los contactos de las páginas **Búsqueda de contactos** y **Datos de contacto**.
+ **Ver mis contactos - Ver**: en las páginas **Búsqueda de contactos** y **Datos de contacto**, permite a los agentes ver solo los contactos que han gestionado.
+ **Restringir acceso a los contactos** (opcional): administrar el acceso de un usuario a los resultados de la página **Búsqueda de contacto** en función de su grupo jerárquico de agentes. Por ejemplo:
+ Los agentes que tienen el valor AgentGroup -1 solo pueden ver los registros de contactos de los contactos gestionados por los agentes de ese grupo jerárquico y de los grupos que estén por debajo de ellos. (Si tienen permisos para **Conversaciones grabadas**, también podrán escuchar las grabaciones de las llamadas y ver las transcripciones).
+ Los agentes asignados a AgentGroup -2 solo pueden acceder a los registros de contactos de los contactos gestionados por su grupo y de los grupos que estén por debajo de ellos.
+ Los gerentes y otras personas que estén en grupos de nivel superior pueden ver los registros de contactos de los contactos gestionados por todos los grupos inferiores a ellos, como AgentGroup -1 y 2.
Para este permiso, **Todos** = **Ver**, ya que **Ver** es la única acción concedida.
Para obtener más información acerca de los grupos de jerarquía, consulte [Organización de los agentes en equipos y grupos para la elaboración de informes y el acceso mediante la creación de jerarquías](agent-hierarchy.md).
**importante**
Al eliminar un nivel jerárquico, se rompe el enlace con los contactos existentes. Esta acción no se puede revertir.
Cuando cambie el grupo de jerarquía de un usuario, es posible que los resultados de la búsqueda de contactos tarden un par de minutos en reflejar sus nuevos permisos.
En la siguiente tabla se muestran los permisos típicos y los contactos que se pueden ver en las páginas **Búsqueda de contactos** y **Datos de contacto**.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/contact-search.html)
**importante**
No recomendamos asignar permisos en ninguna otra combinación que no sea la que se muestra en la tabla anterior.
+ **Contact Lens: análisis de las conversaciones**: en la página **Datos de contacto** de un contacto, puede ver gráficos que resumen los análisis de conversaciones, como tendencia de la opinión del cliente, opinión y tiempo sin conversación.
+ **Grabaciones de llamadas (redactadas) - Acceso**: si su organización utiliza Contact Lens, puede asignar este permiso para que los agentes accedan solo a las grabaciones de llamadas de agentes en las que se haya editado información confidencial.
+ **Transcripciones de contactos (redactadas) - Acceder**: si su organización utiliza Contact Lens, puede asignar este permiso para que los agentes accedan solo a las transcripciones de contactos en las que se haya editado información confidencial.
+ **Grabaciones de llamadas (sin editar) - Acceso**: utilice este permiso para administrar quién puede acceder a las grabaciones en las páginas **Búsqueda de contactos** y **Datos de contacto**. Si lo desea, puede utilizar **Restringir acceso a los contactos** para asegurarse de que solo tienen acceso a la información detallada de los contactos gestionados por su grupo jerárquico.
+ **Transcripciones de contactos (sin redactar) - Acceso:** utilice este permiso para administrar quién puede ver las conversaciones de chat y correo electrónico sin redactar y las transcripciones de voz sin redactar producidas por Contact Lens en las páginas de **búsqueda de contactos** y **detalles de contacto**. Si lo desea, puede utilizar **Restringir acceso a los contactos** para asegurarse de que solo tienen acceso a la información detallada de los contactos gestionados por su grupo jerárquico.
+ **Formularios de evaluación: realizar evaluaciones**: permite a los usuarios [buscar](search-evaluations.md) evaluaciones por formulario de evaluación, puntuación, fecha o intervalo de la última actualización, evaluador y estado.
+ **ID de voz: atributos y búsqueda**: si su organización usa Voice ID, los usuarios con este permiso pueden buscar y ver los resultados de Voice ID en la página de **Datos de contacto**.
+ Permiso **Usuarios - Ver**: debe tener este permiso para utilizar el filtro **Agente** en la página **Búsqueda de contactos**.
De forma predeterminada, los perfiles de **administración** y **CallCenterManager**seguridad de Amazon Connect tienen estos permisos.
Para obtener información acerca de cómo agregar más permisos a un perfil de seguridad existente, consulte [Actualización de los perfiles de seguridad predeterminados en Amazon Connect](update-security-profiles.md).
## Cómo buscar un contacto.
1. Inicie sesión en Amazon Connect con una cuenta de usuario que tenga [permisos para obtener acceso a las grabaciones de contacto](#required-permissions-search-contacts).
1. En Amazon Connect, elija **Análisis y optimización** y **Búsqueda de contacto**.
1. Utilice los filtros de la página para acotar la búsqueda. Para la fecha, puede buscar hasta ocho semanas a la vez.
**sugerencia**
Para ver si se ha grabado una conversación, debe estar asignado a un perfil que tenga los permisos **Manager monitor (Monitorización de Manager)** . Si se grabó una conversación, el resultado de búsqueda lo indicará de forma predeterminada con un icono en la columna **Recording (Grabación)** . No verá este icono si no tiene permiso para revisar las grabaciones.
## Campos adicionales: agregar columnas a los resultados de la búsqueda
Utilice las opciones de **Campos adicionales** para agregar columnas en los resultados de la búsqueda. Estas opciones no se utilizan para filtrar la búsqueda.
Por ejemplo, si desea incluir columnas para **Nombre del agente** y **Perfil de enrutamiento** en la salida de búsqueda, elija esas columnas aquí.
**sugerencia**
La opción **Se ha transferido fuera** indica si el contacto se transfirió a un número externo. Para saber la fecha y la hora (en formato UTC) en que se conectó la transferencia, consulte `TransferCompletedTimestamp` en [ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord).
## Descarga de los resultados de la búsqueda
Puede descargar hasta 3000 resultados de búsqueda a la vez.
## APIs para buscar contactos
Utilice lo siguiente APIs para buscar contactos mediante programación:
+ [SearchContacts](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html)
+ [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)
+ [DescribeContactEvaluation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContactEvaluation.html)