> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/es/servicios-comerciales/zoom-contact-center/expert-insights/integrate-engagement-data.md).

# Integrar datos de interacción

Escrito por Justin Steinberg

### Resumen

Zoom centro de contacto genera datos valiosos de interacción durante cada interacción con el cliente, incluidas grabaciones de llamadas, transcripciones, notas del agente y disposiciones. Siga leyendo para aprender cómo almacenar los datos de interacción en sistemas externos (por ejemplo, CRM y otros sistemas de registro) para crear una vista unificada del cliente, habilitar un coaching eficaz para agentes o cumplir los requisitos de cumplimiento al usar Zoom centro de contacto.

Desglosaremos los diferentes métodos de Integraciones para ayudarle. Seleccione el mejor enfoque según cómo sus agentes puedan trabajar con mayor eficiencia.

El mejor método depende principalmente de un factor clave: **la aplicación en la que los agentes gestionan sus interacciones**. Estas son las dos opciones que analizaremos:

1. Agentes que usan el Conector CRM CTI de ZCC listo para usar dentro del CRM.
2. Agentes que trabajan en la aplicación Zoom Workplace, lo que requiere una solución personalizada con API y webhooks de ZCC.

***

### Integración del Conector CRM CTI listo para usar

Este es el método más sencillo. Si sus agentes usan un Conector CRM CTI de ZCC, la mayoría de los datos de interacción se pueden sincronizar automáticamente entre la plataforma Zoom y el CRM correspondiente.

#### <mark style="color:azul;">Cómo funciona</mark>

El Conector CTI incrusta la interfaz del agente de ZCC directamente en el CRM. Cuando finaliza una interacción, datos como grabaciones, transcripciones, notas y disposiciones se guardan automáticamente dentro de Zoom y se vinculan al registro relevante (por ejemplo, un ticket o un contacto) en su CRM.

#### <mark style="color:azul;">Requisitos de configuración</mark>

La funcionalidad que permite la sincronización de datos entre Zoom y el CRM viene "lista para usar", pero requiere activación dentro del portal del administrador de ZCC.

Complete los siguientes pasos:

{% stepper %}
{% step %}
**Habilitar en el portal del administrador de ZCC**

Inicia sesión en el portal del administrador de Zoom como administrador. En el [Centro de administración](https://zoom.com/account), ve a Gestión de CX → Centro de contacto → Integraciones → [Aplicaciones](https://zoom.com/cci/index/admin#/admin-integrations).

Busque la Integraciones de CRM correspondiente y habilite la configuración adecuada para permitir el almacenamiento de datos en su CRM.
{% endstep %}

{% step %}
**Permisos de CRM**

Consulta y sigue las [guías de configuración de la integración de CRM](https://support.zoom.com/) para verificar que el usuario de integración de CRM tenga los permisos de escritura necesarios para todos los objetos pertinentes.
{% endstep %}
{% endstepper %}

#### <mark style="color:azul;">Plataformas CRM compatibles</mark>

Esta funcionalidad es accesible a través del Conector CRM CTI de ZCC cuando los agentes usan los siguientes CRM:

* Salesforce
* Zendesk
* ServiceNow
* Microsoft Dynamics
* HubSpot

Con los conectores CRM CTI, no se requiere configuración especial, y las Integraciones guardarán los datos de interacción en el CRM de forma predeterminada.

***

### Integraciones personalizadas mediante API

Si sus agentes usan la aplicación nativa Zoom Workplace o ZCC Smart Embed, necesitará una solución personalizada para transferir los datos de interacción. La forma principal de hacerlo es con las API de Zoom centro de contacto.

Hay dos enfoques principales para acceder a los datos de interacción mediante la API:

* **Sondeo:** Consulta periódicamente la API de Zoom para comprobar si hay nuevos datos de interacción disponibles.
* **Webhooks:** Recibe una notificación en tiempo real de Zoom en cuanto haya una transcripción lista.

También hay un tercer enfoque: **Integración de eventos de flujo**, que funciona con ciertos tipos de datos.

#### <mark style="color:azul;">Consultando periódicamente las API de Zoom centro de contacto</mark>

Para descargar los datos de interacción, debe consultar los puntos de conexión de la API de ZCC adecuados. Es importante tener en cuenta que los distintos tipos de datos provienen de distintas API, por lo que probablemente deberá crear lógica de sondeo para cada punto de conexión relevante.

Muchas API relacionadas con la interacción dentro de Reports V2 (análisis de CX) ahora admiten el filtrado por hora de finalización con `end_time_from` y `end_time_to`. Prefiere estos parámetros cuando estén disponibles para que tus trabajos de sondeo recuperen las interacciones según el momento en que realmente hayan terminado. Esto ayuda a reducir los registros que se pierden, ya que los datos completos de la interacción (incluidos los datos de Report V2) se finalizan al terminar la interacción.

| Para obtener estos datos...                                         | Consulte esta API...                                                                                                                                                                                                                                                                                                                                                                     | Usando este campo... | Notas:                                                                                   |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
| <p>Archivo multimedia de grabación</p><p>(Canal de voz y video)</p> | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/get/contact_center/recordings">Lista de grabaciones</a> o</p><p>Listar grabaciones de Engagement</p>                                                                                                                                                                                                      | `download_url`       | Requiere que la grabación de llamadas esté habilitada para la cola.                      |
| <p>Transcripción de la grabación</p><p>(Canal de voz y video)</p>   | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/GET/contact_center/recordings">Lista de grabaciones</a> o</p><p>Listar grabaciones de Engagement</p>                                                                                                                                                                                                      | `transcript_url`     | Requiere la grabación de llamadas con transcripción habilitada.                          |
| <p>Transcripción</p><p>(Canal de mensajería)</p>                    | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Consigue una interacción</a> o</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Listar datos históricos del registro de interacción</a></p>         | `transcript_url`     | La transcripción está habilitada de forma predeterminada para los canales de mensajería. |
| <p>Disposiciones</p><p>(Todos los canales)</p>                      | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Consigue una interacción</a> o</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Listar datos históricos del registro de interacción</a></p>         | `dispositions`       | Una matriz de objetos de disposición.                                                    |
| <p>Notas</p><p>(Todos los canales)</p>                              | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Consigue una interacción</a> o</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Listar datos históricos del registro de interacción</a></p>         | `notas`              | Una matriz de objetos de nota.                                                           |
| <p>Archivo multimedia de correo de voz</p><p><br><br></p>           | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Enumerar los mensajes de la bandeja de entrada de una cuenta</a> <strong>o</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Listar los mensajes de una bandeja de entrada</a></p> | `download_url`       | Para los correos de voz dejados en una bandeja de entrada del centro de contacto.        |
| Transcripción del correo de voz                                     | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Enumerar los mensajes de la bandeja de entrada de una cuenta</a> <strong>o</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Listar los mensajes de una bandeja de entrada</a></p> | `transcript_url`     | Requiere que la transcripción esté habilitada para la bandeja de entrada.                |

{% hint style="danger" %}
**Advertencia**

Las URL de descarga (`download_url`, `transcript_url`, `playback_url`, etc.) proporcionados por estas API de Zoom son **no** enlaces públicos. Están diseñados para el acceso programático y requieren autenticación de API (por ejemplo, un token de acceso en el encabezado Authorization) para descargar el archivo asociado.

Esto significa:

* No puedes guardar estas URL directamente en un CRM para que un usuario haga clic en ellas. Un usuario que haga clic en el enlace en su navegador no estará autenticado y la descarga fallará.
* El método correcto es que tu servicio de backend use la URL para obtener el archivo. Luego, tu servicio puede almacenar el archivo en tu propio sistema (como Amazon S3, Azure Blob Storage o el almacenamiento de archivos de tu CRM) y proporcionar un enlace seguro a tus usuarios desde allí.
  {% endhint %}

{% hint style="warning" %}
**Atención**

**Retrasos de procesamiento - Grabaciones de voz y video:**

Estos datos no están disponibles en el instante en que termina una llamada. Primero se debe procesar y subir el audio, lo que puede tardar varios minutos en el caso de llamadas largas. Para asegurarte de no perderte ninguna grabación, configura el `query_date_type` parámetro a `recording_end_time` al consultar periódicamente la API de listado de grabaciones. Esto recupera los datos según cuándo terminó el procesamiento, no cuándo terminó la llamada.

Para los trabajos de conciliación centrados en interacciones de Reports V2 (análisis de CX), utiliza ventanas de tiempo solapadas con `end_time_from` y `end_time_to` para proporcionar un margen de seguridad ante retrasos en el procesamiento y problemas transitorios de entrega.
{% endhint %}

Para obtener más información sobre las API del centro de contacto de Zoom, consulta [API del centro de contacto](https://developers.zoom.us/docs/api/contact-center/) documentación.

#### <mark style="color:azul;">Usa webhooks para eventos en tiempo real</mark>

Para un enfoque más inmediato y basado en Evento, puede suscribirse a los webhooks de ZCC. Este es el método más eficiente para Integraciones en tiempo casi real.

**Cómo funciona**

1. Suscríbase a los eventos correspondientes en el Zoom App Marketplace.
2. Cuando ocurre un Evento, Zoom envía una Notificación a la URL de tu webhook (o a tu conexión WebSocket).
3. La carga útil del Evento contiene los datos que necesitas, ya sea directamente o como una URL/ID para una llamada de API de seguimiento.

**Eventos webhook comunes para datos de interacción**

* **Datos de finalización de la interacción listos:** contact\_center.cx\_engagement\_end\_data\_ready (indica que los datos del informe V2 de finalización de la interacción están listos para recuperarse)
* **Grabación de voz/vídeo:** contact\_center.recording\_completed (proporciona un `download_url`)
* **Transcripción de voz/vídeo:** contacto\_center.recording\_transcripción\_completed (proporciona un `transcripción_url`)
* **Transcripción de mensajería:** contacto\_center.engagement\_mensajería\_transcripción\_completed (proporciona un `transcript_url`)
* **Notas:** contact\_center.engagement\_note\_added (proporciona una `nota` campo con los datos de la nota)
* **Disposición:** contacto\_center.engagement\_disposición\_added (proporciona un `disposition_name` campo con los datos de disposición)

**Patrón recomendado: activar la recuperación cuando los datos de interacción estén listos**

Cuando recibas `contact_center.cx_engagement_end_data_ready`, interprétalo como una señal de que los datos del informe de finalización de la interacción V2 están completos para esa interacción. En ese momento, llama a la API de datos del registro de interacciones históricas y a cualquier otra API pertinente para recopilar el conjunto de datos final. En este evento, usa `engagement_id` como clave de búsqueda y, a continuación, obtén los artefactos completos de interacción de los endpoints necesarios.

{% hint style="warning" %}
**Atención**

* **Ten en cuenta que hay varios eventos:** El `note_added` y `disposición_added` Los eventos pueden activarse varias veces durante una misma interacción (por ejemplo, si un agente guarda varias notas o se transfiere una llamada). La lógica de tu aplicación debe poder gestionar esta situación.
* **Incorpore redundancia:** La entrega de eventos no siempre está garantizada al 100 % (por ejemplo, es posible que tu punto de conexión o conexión WebSocket no esté disponible temporalmente).
* **Estrategia de copias de seguridad:** Recomendamos ejecutar un script de reconciliación mediante API de sondeo con `end_time_from` y `end_time_to` Windows para detectar eventos perdidos y cerrar brechas de datos.
  {% endhint %}

Para obtener más información sobre los eventos de webhook/websocket del centro de contacto de Zoom, consulta [Webhooks del centro de contacto](https://developers.zoom.us/docs/api/contact-center/events/) documentación.

#### <mark style="color:azul;">Integraciones de eventos de flujo</mark>

Para ciertos tipos de datos, puede enviar datos directamente a un sistema externo desde el editor de flujo de ZCC usando un script de Evento de JavaScript.

**Datos admitidos y limitaciones:**

* **Disposición:** Se puede acceder a él en todos los tipos de canal de interacción Entrantes mediante el `global_system.Engagement.disposición` variable.
* **Transcripción:** Solo está disponible para las interacciones de mensajería Entrantes (por ejemplo, chat web) que usan el `global_system.Engagement.transcripción` variable.
* **Varios flujos:** Al trabajar con varios Flows en la configuración, especialmente cuando uno de ellos utiliza `RouteTo` Para conectar con otro Flow mediante un widget, es esencial asegurarse de que los mismos scripts de eventos y desencadenadores estén configurados correctamente en todos los Flows.

Este método es más potente en un Flow de mensajería, donde puede combinar tanto la transcripción como la disposición en un solo Evento.

**Pasos de configuración**

Siga estos pasos para Configure su flujo:

{% stepper %}
{% step %}
**Añadir un Script de Evento**

En su Flow de ZCC (por ejemplo, un flujo de chat web), haga clic en el widget Inicio.

Localice Scripts de Evento y Añadir un Script de Evento para eventos, como Interacción cerrada y/o Disposición guardada.

<div align="left"><figure><img src="https://1630984505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-608a0caccf5697f0cda911a59ba832b2f5cf3fd6%2Fimage.png?alt=media" alt="Flow screen showing a welcome message and events."><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Añadir su JavaScript personalizado**

El siguiente ejemplo recupera tanto la disposición como la transcripción y, luego, las envía juntas a una API externa.

```javascript
función asíncrona main () { 
  intentar {
    // Obtener el objeto de disposición de su variable
    const disposición_data = var_get()['global_system.Engagement.disposición'];
    
    // Obtener el objeto de transcripción completo
    const transcripción_data = await req.get(var_get()['global_system.Engagement.transcripción']);

    // Preparar una carga útil con todos los datos que desea enviar
    const payload_to_send = {
      disposición: disposición_data.data.result,
      transcripción: transcripción_data.data.result.transcripción
    };

    // Definir el destino de sus datos
    const external_api_url = '<reemplazar-con-su-api-punto de conexión>';
    
    // Enviar los datos combinados a su sistema externo
  	const response = await req.post(external_api_url, payload_to_send);
    
    // Registrar la respuesta del sistema externo para solucionar problemas
    log.debug("Respuesta de la API externa: " + JSON.stringify(response.data));
    
  } capturar (error) {
    log.debug("Se produjo un error en el script del Evento de transcripción: " + error);
  }
}
```

{% endstep %}
{% endstepper %}

***

### Resumen y recomendaciones

Seleccione el método de Integraciones que mejor se adapte al flujo de trabajo de sus agentes y a sus recursos técnicos.

| Si sus agentes usan...                                     | Entonces su mejor opción es...                                               | Consideraciones clave:                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| El Conector ZCC CTI en un CRM compatible                   | La integración integrada                                                     | <ul><li>La vía más fácil</li><li>No se requiere código</li><li>La Sincronizar de datos de interacción está integrada</li></ul>                                                                                                                                                                       |
| La aplicación de Zoom Workplace o Smart Embed              | Webhooks de API más conciliación de sondeo filtrado por hora de finalización | <ul><li>Usar <code>contact\_center.cx\_engagement\_end\_data\_ready</code> como desencadenante de recuperación</li><li>Luego, concílialo con <code>end\_time\_from</code>/<code>end\_time\_to</code> ventanas</li><li>Mejora la eficiencia al tiempo que reduce las interacciones perdidas</li></ul> |
| Un flujo de mensajería Entrantes (y necesita enviar datos) | Scripts de Evento de flujo                                                   | <ul><li>De nicho, pero potente</li><li>Requiere JavaScript</li><li>Funciona mejor para enviar transcripciones de mensajería y disposiciones</li></ul>                                                                                                                                                |

Al comprender estas diferentes rutas, puede crear una Integraciones sólida y confiable que le ofrezca una vista completa de las interacciones con sus clientes. Combinar la recuperación activada por Evento con la conciliación filtrada por hora de finalización le ayuda a reducir las llamadas innecesarias a la API al tiempo que mejora la integridad.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/es/servicios-comerciales/zoom-contact-center/expert-insights/integrate-engagement-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
