> 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/zoom-cx-agent-desktop-deployment-options.md).

# Opciones de implementación del escritorio del agente

Escrito por Justin Steinberg

<figure><img src="https://1630984505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-293887229ce00b96a3ceaafd7dba2abb0458565f%2Fimage.png?alt=media" alt="A woman smiling, wearing a headset and working at a computer."><figcaption></figcaption></figure>

Zoom CX ofrece varias opciones de implementación del escritorio de agente para satisfacer los requisitos de tipo Comercial de su centro de contacto de Zoom. Las funciones habituales del centro de contacto, como las ventanas emergentes en pantalla y el registro de llamadas, están disponibles en todas las opciones de implementación.

Tanto si necesita una solución sencilla de Integraciones con su CRM, una aplicación web personalizada integrada en el escritorio de agente o Integraciones avanzadas basadas en Eventos mediante Flow Events o API Webhooks, Zoom CX ofrece la flexibilidad necesaria para satisfacer sus necesidades.

Al comprender sus requisitos específicos y aprovechar las herramientas e Integraciones adecuadas, puede crear una experiencia de centro de contacto fluida y eficiente para sus agentes y Clientes.

## Ejemplos de Integraciones

Una pregunta muy frecuente de nuestros Clientes es: «*¿Puede el centro de contacto de Zoom integrarse con mi \[insertar sistema aquí]?*». La respuesta no suele ser un simple sí o no.

Estos son algunos ejemplos de Integraciones de Clientes:

* Necesito que mi agente humano trabaje dentro de otra aplicación
* Necesito que mis agentes humanos dispongan de ventanas emergentes en pantalla y de la función de llamar con un clic en mi CRM
* Necesito que mi IVR de voz consulte una base de datos de mi sistema y proporcione información de autoservicio
* Necesito gestionar pagos con tarjeta de crédito e integrarme con mi sistema bancario
* Necesito que mi chatbot de IA comprenda detalles específicos de mi empresa
* Cuando un agente habla con un cliente, quiero que el sistema del centro de contacto muestre automáticamente información contextual para ayudar al agente

Cada uno de estos ejemplos requiere un enfoque diferente para la integración. Es fundamental comprender los requisitos empresariales para responder preguntas y diseñar el centro de contacto adecuado para su empresa. ¿Qué característica(s) se requieren para su integración?

Zoom CX ofrece cuatro opciones de implementación del escritorio del agente: la aplicación Zoom Workplace, la aplicación web progresiva (PWA), los conectores CTI para CRM y la integración ZCC Smart Embed.

## Características compatibles

En la tabla siguiente se indica la compatibilidad con los canales de cada opción de implementación.

| Opciones de implementación                                | Sistemas operativos compatibles | Canales de ZCC compatibles                                                                                            | AI Companion                    | Asistencia experta de IA                                                       |
| --------------------------------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------ |
| aplicación de escritorio de Zoom Workplace                | Windows, Mac                    | <ul><li>Voz</li><li>Video</li><li>SMS</li><li>Chat web</li><li>Mensajería social</li><li>Correo electrónico</li></ul> | Incluido en todas las licencias | Incluido con la licencia Elite y el add-on AI Expert Assist                    |
| Integraciones CTI de CRM                                  | Web                             | <ul><li>Voz</li><li>Video</li><li>SMS</li><li>Chat web</li><li>Mensajería social</li></ul>                            | En la hoja de ruta              | En la hoja de ruta. Requerirá una licencia del add-on Elite o AI Expert Assist |
| Integración inteligente de Zoom centro de contacto (CCSE) | Web                             | <ul><li>Voz</li><li>Video</li><li>Chat web</li></ul>                                                                  | No disponible                   | No disponible                                                                  |

## Aplicación Zoom Workplace

Nuestro escritorio de agente predeterminado es la interfaz Estándar integrada en la aplicación Zoom Workplace, la misma aplicación que ya conoces y utilizas para unirte a Zoom Meetings o hacer llamadas de Zoom Phone. Los agentes con la licencia del centro de contacto de Zoom tendrán acceso a la pestaña del centro de contacto (que se muestra a continuación), donde gestionarán sus interacciones del centro de contacto de Zoom.

{% hint style="info" %}
**Nota**

Para obtener más información sobre cómo configurar la información del centro de contacto, consulta [Soporte de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058394).
{% endhint %}

<figure><img src="https://media.zoom.com/images/assets/wpapp.png/Zz0wM2E5YWZhNjU0YzYxMWVmYmYzOGVlMmZlM2E4NDQ4Yg==" alt="Contact Center tab in Zoom Workplace application"><figcaption></figcaption></figure>

### **Ventanas emergentes en la pantalla del navegador**

Puedes usar el [URL de inicio](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058616\&ampDeviceId=178f00fc-724f-4a48-8bc8-2e79500f8f07\&ampSessionId=1745602375311) Característica de la aplicación para construir una URL web dinámica a partir de datos variables, que luego se abre en el navegador del sistema del equipo del agente. La ventana emergente de URL puede incluir variables estándar, como el número de teléfono de quien llama, pero también puede incluir datos personalizados recopilados por el Flow/IVR, como números de caso o de ticket.

<figure><img src="https://media.zoom.com/images/assets/Browser-screen-popup.png/Zz1jMGQ0Y2I0MjU0YzYxMWVmYTdkNzQyMjc2NTZiOWM0Mg==" alt="Custom URL screen pops"><figcaption></figcaption></figure>

### **Zoom Apps**

Puedes aprovechar el marco de aplicaciones de Zoom para integrar aplicaciones web en el escritorio del agente de Zoom Contact Center. Las Zoom Apps se muestran a los agentes en el lado derecho de una interacción según la configuración administrativa de cada cola. Esto permite que cada cola controle qué Zoom Apps se muestran al agente.

El marco de aplicaciones de Zoom admite tanto aplicaciones públicas, como la aplicación PCI Pal que se muestra a continuación, como aplicaciones privadas. Las aplicaciones privadas suelen estar destinadas a casos de uso internos y solo están disponibles para la cuenta de Zoom para la que se creó la aplicación. Si cuenta con los recursos para crear su propia aplicación web (HTML, CSS o JavaScript), puede integrarla sin problemas en la aplicación Zoom Workplace.

<figure><img src="https://media.zoom.com/images/assets/Zoom+Apps.png/Zz1iNGJhMGExZTU0YzgxMWVmYTEzMTM2ZTI5YjBmM2E2Mw==" alt="Zoom App Framework with PCI Pal"><figcaption></figcaption></figure>

El SDK de JavaScript de Zoom Apps admite tanto eventos como API, lo que permite que tu aplicación reciba actualizaciones de participación y realice votaciones para obtener datos.

{% hint style="info" %}
Para obtener más información, consulta [Zoom Apps en el sitio para desarrolladores de Zoom](https://developers.zoom.us/docs/contact-center/apps/?optimizely_user_id=efe7866fa2ae9ac46f7e6b8bb8e98da9\&ampDeviceId=178f00fc-724f-4a48-8bc8-2e79500f8f07\&ampSessionId=1745602375311).
{% endhint %}

## Aplicación web progresiva (PWA)

Disponible para los Clientes que prefieren que sus agentes inicien sesión en el centro de contacto de Zoom mediante un navegador web, como Chrome, el cliente web ofrece Características similares a las de la aplicación Zoom Workplace.

{% hint style="info" %}
**Nota**

Para obtener más información sobre la aplicación web progresiva, consulta la [Blog de Zoom](https://www.zoom.com/en/blog/how-to-use-zoom-on-a-chromebook/).
{% endhint %}

<div data-full-width="false"><figure><img src="https://media.zoom.com/images/assets/Progressive+Web+App/Zz1iY2E0YmJhZTU0ZDAxMWVmYWZiMzdlNGQxM2VlNzY4ZA==" alt="Browser-based Zoom Contact Center"><figcaption></figcaption></figure></div>

## Conectores CTI para CRM

Si prefieres que tus agentes trabajen integrados en tu CRM, puedes aprovechar los conectores CTI de ZCC para CRM, compatibles con los siguientes CRM:

* Salesforce
* Zendesk
* ServiceNow
* Hubspot
* Microsoft Dynamics 365

Si usas una de estas Integraciones, los agentes gestionarán las interacciones dentro del CRM mediante la integración de Zoom con el centro de contacto integrada. La ventana emergente en pantalla y las funciones de registro de llamadas vienen incluidas de forma predeterminada.

{% hint style="info" %}
**Nota**

Para obtener más información sobre los conectores CTI de CRM, consulta [Soporte de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078354).
{% endhint %}

<figure><img src="https://media.zoom.com/images/assets/CRM-Int.png/Zz04YzczZTEzNDU0ZDExMWVmYjk1MmEyZTlmMWU2MmE2YQ==" alt="Zoom Contact Center within SalesForce"><figcaption></figcaption></figure>

El comportamiento predeterminado de las integraciones es abrir una pantalla emergente en función del ID de llamada (canales de voz/SMS) o del correo electrónico (canales de chat web/vídeo), pero puedes configurar que se abra en función de datos adicionales recopilados en el flujo, como un número de caso o de ticket. Veamos esa configuración.

{% hint style="info" %}
**Nota**

Las opciones que se muestran en la pantalla de configuración del canal varían según el CRM y el canal de ZCC que se utilicen.
{% endhint %}

<figure><img src="https://media.zoom.com/images/assets/voice-channel.png/Zz1kMDVlNjhkODU0ZDExMWVmODg5N2IyNTcwYTNhNmUzYw==" alt="Voice Channel Configuration screen"><figcaption></figcaption></figure>

## Integración de Zoom Smart Embed para centro de contacto (CCSE)

Zoom CCSE es una solución flexible que permite a los desarrolladores integrar rápidamente el agente en su propia aplicación web mediante configuraciones de iFrame de HTML. El equipo de desarrollo web añadirá código JavaScript adicional a la aplicación web para recibir los eventos de llamada entrante y llamada conectada, que se pueden usar para activar ventanas emergentes en la pantalla o registrar llamadas en la aplicación web.

<figure><img src="https://media.zoom.com/images/assets/ZCC+Smart+Embed+Integration.png/Zz0xNjkwNjhhNDU0ZDQxMWVmOTRmZjJlODViYTAxOGVmNA==" alt="Phone screen"><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota**

Para obtener más información sobre Smart Embed, consulta la [documentación para desarrolladores](https://developers.zoom.us/docs/contact-center/smart-embed/?optimizely_user_id=efe7866fa2ae9ac46f7e6b8bb8e98da9\&ampDeviceId=178f00fc-724f-4a48-8bc8-2e79500f8f07\&ampSessionId=1745602375311).
{% endhint %}

## Soluciones para socios

Si buscas una solución de agentes que no se mencione más arriba, hay integraciones adicionales disponibles que ofrecen los Socios del programa de proveedores de soluciones innovadoras (ISV) de Zoom. El programa de Socios ISV incluye Soluciones diseñadas para bancos, cooperativas de crédito, aseguradoras, Atención médica y otros sectores.

{% hint style="info" %}
**Nota**

Para obtener más información, consulta [Socios ISV de Zoom para el centro de contacto](https://partner.zoom.us/solutions/?filter-types=ISV\&filter-products=Contact+Center).
{% endhint %}

Las integraciones más sofisticadas del escritorio del agente pueden aprovechar los eventos de Zoom CX Flow o los eventos de la API de Zoom App Marketplace (webhooks/WebSockets). Con estas opciones, la plataforma Zoom CX enviará solicitudes HTTPS a puntos de conexión de API externos en función de los eventos de Zoom Contact Center.

Según los requisitos de tu integración, puedes optar por usar eventos de Flow, eventos de API o ambos.

Puede diseñar Integraciones para mostrar una ventana emergente en pantalla o registrar llamadas al recibir estos eventos. Tanto los eventos de flujo como los eventos de Zoom App Marketplace están disponibles para todas las Opciones de implementación del agente indicadas anteriormente.

| Tipo de evento                                                             | Interacciones admitidas | Tipo de carga útil |
| -------------------------------------------------------------------------- | ----------------------- | ------------------ |
| [Scripts de eventos de flujo ZCX](#flow-event-script)                      | Solo Entrantes          | JSON personalizado |
| [Eventos de API de Zoom App Marketplace](#zoom-app-marketplace-api-events) | Entrantes y Salientes   | JSON corregido     |

Los scripts de eventos de flujo se activan cuando se producen acciones específicas dentro del centro de contacto de Zoom. Cuando se activa ese Evento, el código del script de eventos asociado se ejecuta en el contexto de la interacción, lo que significa que el script tiene acceso a las variables de la interacción.

## Scripts de Evento de flujo

Veamos dos scripts habituales de Evento de Flow.

| Nombre del evento                                             | Desencadenador de Evento                                 |
| ------------------------------------------------------------- | -------------------------------------------------------- |
| [Compromiso aceptado](#engagement-accepted-event-script-code) | Cuando un agente acepta la llamada.                      |
| [Disposición guardada](#disposition-saved-event-script-code)  | El agente guardó una disposición y cerró la interacción. |

{% hint style="info" %}
**Nota**

La lista completa de scripts de Eventos está disponible en el [artículo de Soporte](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059146\&ampDeviceId=178f00fc-724f-4a48-8bc8-2e79500f8f07\&ampSessionId=1745602375311).
{% endhint %}

Veamos un ejemplo de cómo puedes usar los Eventos anteriores para enviar solicitudes HTTP a un sistema externo. Cuando el sistema externo recibe estos Eventos, puede usar los datos para generar registros, mostrar ventanas emergentes en pantalla o para otros fines. Las funciones disponibles dependerán de las capacidades del sistema externo.

### **Configuración de ejemplo**

En el flujo, empezamos configurando los scripts de Eventos en el widget Inicio. En la imagen siguiente, puedes ver que el widget Inicio tiene configurados los dos scripts de Eventos.

<figure><img src="https://media.zoom.com/images/assets/agent-manage/Zz1hN2QxZDBjMDU1NzcxMWVmYmIyYmUyNzgyODUwNDI1OQ==" alt="Event Script Flow example"><figcaption></figcaption></figure>

Para crear el código del script de Evento, debes Añadir un nuevo script de Evento al widget Inicio y, después, escribir el código directamente en el editor de flujos, como se muestra a continuación.

<figure><img src="https://media.zoom.com/images/assets/asset-management.png/Zz1hN2JhYzVlYzU1NzcxMWVmYjE3ZTM2ZTI5YjBmM2E2Mw==" alt="Code sample in Flow editor"><figcaption></figcaption></figure>

Los Eventos Interacción aceptada y Disposición guardada usan código similar. Ambos son bloques de código JavaScript que utilizan la función HTTP integrada para generar una solicitud HTTPS POST de tipo Salientes.

### Código del script del evento de aceptación del compromiso

En este ejemplo de código, incluimos el ID de interacción, el número de teléfono de quien llama, el correo electrónico del agente y el nombre de la cola. El código se ejecuta cuando el agente responde a la interacción y comienza a hablar con el consumidor.

Este es un ejemplo de la cantidad mínima de información necesaria para generar una ventana emergente en pantalla o empezar a registrar la nueva llamada. Cabe mencionar que, si la configuración de ZCC Flow recopila datos sobre la persona que llama en el flujo/IVR, basta con añadir más variables a la `request_body` variable para incluir datos adicionales en esta solicitud HTTP.

{% code overflow="wrap" %}

```javascript
async function main() {
    intentar {
        let request_body = {
            engagementId: var_get()["global_system.Engagement.engagementId"],
            caller_number: var_get()["global_system.Engagement.ANI"],
            agent_correo electrónico: var_get()["global_system.Agent.correo electrónico"],
            queue_name: var_get()["global_system.Engagement.queue"]
        };

        const result = await req.post('https://api.example.com/acceptedcall', request_body);
        let jsonResponseBody = result.data;

        log.debug("Axios jsonResponseBody=" + JSON.stringify(jsonResponseBody));
    } capturar (error) {
        log.debug("Received HTTP error " + error);
    }
}
```

{% endcode %}

### Código de script del Evento Disposición guardada

Para el Evento Disposición guardada, reutilizaremos el código del ejemplo anterior y añadiremos la `disposición` variable. Este código se ejecuta cuando el agente selecciona la disposición de la llamada, lo que ocurre como última acción que realiza el agente en la interacción. Al enviar esta solicitud, el sistema externo puede hacer un seguimiento de que el agente ha completado la disposición de la interacción.

Al igual que con el Evento Interacción aceptada, puedes incluir variables adicionales según tu caso de uso.

{% code overflow="wrap" %}

```javascript
async function main() {
    intentar {
        let request_body = {
            engagementId: var_get()["global_system.Engagement.engagementId"],
            caller_number: var_get()["global_system.Engagement.ANI"],
            agent_correo electrónico: var_get()["global_system.Agent.correo electrónico"],
            queue_name: var_get()["global_system.Engagement.queue"],
            disposición_name: var_get()["global_system.Engagement.disposición"]
        };

        const result = await req.post('https://api.example.com/dispositionedcall', request_body);
        let jsonResponseBody = result.data;

        log.debug("Axios jsonResponseBody=" + JSON.stringify(jsonResponseBody));
    } capturar (error) {
        log.debug("Received HTTP error " + error);
    }
}
```

{% endcode %}

Según tu solución, es posible que los scripts de eventos de Flow sean suficientes, o que necesites algunos de los eventos de la API de Zoom App Marketplace para cubrir todos los casos de uso necesarios de tu Integraciones.

Por ejemplo, puede complementar los dos eventos de flujo anteriores suscribiéndose a los eventos de la API de Zoom App Marketplace para los eventos de poner en espera, reanudar, silenciar y reactivar el audio. Estos eventos adicionales proporcionarían a su aplicación información sobre la frecuencia con la que los agentes ponen las llamadas en espera o silencian el audio.

Ambos scripts de eventos de flujo anteriores, así como los eventos de webhook/WebSocket de Zoom App Marketplace, están disponibles para su solución.

## Eventos de la API de Zoom App Marketplace

Al igual que otros productos de Zoom, Zoom CX tiene eventos de API webhook/WebSocket disponibles en Zoom App Marketplace.

Los eventos permiten hacer un seguimiento de la actividad de los agentes, como los eventos de inicio y cierre de sesión, de suscripción y cancelación de la suscripción a una cola y de cambio de estado. Los eventos de interacción permiten hacer un seguimiento de las interacciones a través del sistema e incluyen eventos como el inicio y la respuesta a una interacción, silenciarla o activar el sonido, el envío de DTMF, el inicio de una transferencia, su finalización y la adición de una nota o una disposición. Al hacer un seguimiento de los eventos de interacción, se obtiene información detallada sobre cada interacción.

Consulta la [sitio para desarrolladores de Zoom](https://developers.zoom.us/docs/api/rest/reference/contact-center/methods/?optimizely_user_id=efe7866fa2ae9ac46f7e6b8bb8e98da9#overview) para obtener más información sobre las API del centro de contacto.


---

# 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/zoom-cx-agent-desktop-deployment-options.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.
