> 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/zoom-workplace/zoom-phone/third-party-integrations/zoom-and-mitel-phone-system-integration-field-guide.md).

# Guía de campo de Integraciones de Zoom y del sistema de telefonía de Mitel

### Descripción general

Zoom y Mitel se unen para mejorar tu sistema de VoIP. Con esta solución de Integraciones para el sistema de telefonía — o PSI — puedes obtener lo mejor de ambos mundos: la potencia de colaboración de Zoom Workplace y las capacidades de llamadas de tu sistema Mitel existente, todo desde las apps de escritorio y móviles de Zoom Workplace.

Si ya estás usando Zoom Workplace, pensando en empezar con Zoom Workplace o añadiendo más funciones de Zoom Workplace y tienes una configuración Mitel compatible, esta solución de Integraciones encaja muy bien.

Aquí tienes la idea: tu pestaña Zoom Phone se convierte en un softphone SIP (protocolo de iniciación de sesión) que se conecta directamente a la plataforma de llamadas de Mitel. Si te estás Conectando a través de internet, usa el OpenScape Controlador de borde de sesión, o SBC, de Mitel. También usarás Mitel CloudLink para facilitar los inicios de sesión y administrar a los usuarios de forma más fluida entre Zoom y Mitel.

Solo un aviso: necesitarás tener todos los componentes adecuados de Zoom y Mitel en su lugar para que esta solución de Integraciones funcione correctamente.

#### <mark style="color:azul;">Funciones de PSI de Zoom y Mitel</mark>

Esta solución de Integraciones aporta toda una gama de funciones a tu implementación actual de Mitel. Estas son solo algunas de las que puedes aprovechar:

* Realizar y recibir llamadas
* Gestionar varias llamadas a la vez
* Poner llamadas En espera o iniciar una conferencia
* Transferir llamadas (en frío o en caliente)
* Acceso al correo de voz
* Ver el historial de llamada y los registros
* Configurar el desvío de llamada
* Usar el modo No molestar
* Sincronizar contactos corporativos
* Convertir una llamada telefónica en una reunión de Zoom
* Ver el estado de presencia entre Zoom Apps (limitado con teléfonos Mitel)
* Saltar de chat a una llamada PSI

#### <mark style="color:azul;">Requisitos de alto nivel</mark>

Las siguientes secciones describen los requisitos de alto nivel para esta Integraciones.

<mark style="color:azul;">**Aspectos específicos de Zoom**</mark>

Para poner las cosas en marcha del lado de Zoom, necesitarás:

* Un propietario de cuenta o un Rol, función de administrador para gestionar usuarios, el PSI y Zoom Phone
* Una licencia compatible por usuario, como:
  * Zoom Workplace Comercial/Comercial+
  * Zoom Workplace Essentials/Empresarial/Empresarial+/Empresarial Premier
  * Licencias heredadas de reunión (ENH/EAH)
  * Cualquier plan con Zoom Phone Pro
* Zoom Phone configurado y activo para su Organización
* [**Asignación automática de teléfono**](#disable-the-automatic-phone-license-assignment-for-zoom-workplace) desactivado para licencias de Zoom Workplace
* versión 6.3.6 o superior de la aplicación Zoom Workplace

<mark style="color:azul;">**Especificaciones de Mitel**</mark>

Por parte de Mitel, esto es lo que necesitarás:

**Compatibilidad de hardware de PBX:**

* OpenScape Voice (OSV)
* OpenScape 4k (OS4k)
* Mitel CloudLink
* MiVoice Comercial (MiVB)

**Aplicaciones y plataformas compatibles:**

* Aplicación de administración de Mitel
* Plataforma OpenScape 4000 (para OS4k)
* Plataforma de gestión común de OpenScape (para OSV)
* Portal de gestión SBC de OpenScape (para OSV y OS4k)
* OpenScape SBC (para registro externo con OSV/OS4k)

**Licencias:**

* Mitel ZoomPSI o Hybrid
* Licencia para teletrabajador

Hay algunas cosas importantes que debes saber antes de comenzar el proceso de Integraciones:

* La aplicación Zoom Workplace utiliza el [puertos estándar de Firewall y rangos de IP](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060548).
* Las IP y los puertos de señalización/medios del teléfono están determinados por la configuración de Mitel y pueden diferir de los estándares. Póngase en contacto con Mitel o con su socio de Mitel si necesita información adicional.
* Debe tener una licencia Teleworker para las aplicaciones de escritorio y móviles de Zoom Workplace: dos licencias por usuario. Estas son esenciales para Conectando de vuelta al PBX de Mitel.

### Arquitectura

#### <mark style="color:azul;">Arquitectura de Integraciones Estándar</mark>

<div data-with-frame="true"><figure><img src="/files/a90fd1538e2f595c63b6af6d725b1027be3634ad" alt=""><figcaption></figcaption></figure></div>

Conexiones clave:

* **nube de Zoom a Mitel CloudLink**: API REST sobre TLS
* **Conexión de Zoom Workplace**: TLS a los centros de datos de Zoom
* **Dispositivo del usuario a Mitel**: señalización/medios telefónicos sobre TLS
* **Mitel CloudLink a PBX**: protocolos propietarios

#### Configuración híbrida

<div data-with-frame="true"><figure><img src="/files/77787eb44a5092376ef7ab2e4ea48a93ad5e9905" alt=""><figcaption></figcaption></figure></div>

Las organizaciones ejecutan simultáneamente Zoom Phone y las Integraciones de Mitel. Los usuarios con licencias de Zoom Phone se conectan a Zoom Phone SBC, mientras que los usuarios con las Integraciones de Mitel se conectan a Mitel SBC. Con un troncal BYOP Conectando ambos, los usuarios pueden marcar extensiones entre diferentes sistemas.

#### <mark style="color:azul;">Descripción general de la arquitectura técnica</mark>

**Conexión de Mitel CloudLink**

CloudLink es una plataforma basada en la nube que conecta su PBX local con soluciones en la nube. Zoom aprovecha CloudLink para el acceso a la API en la nube a los componentes de Mitel PBX, creando una única interfaz en lugar de necesitar “hablar” el lenguaje único de cada PBX.

{% hint style="success" %}
**Ejemplo**

Al activar No molestar, Zoom envía un comando de API a CloudLink, que lo interpreta para el Mitel PBX específico (OS4K vs. MiVoice Comercial manejan esto de manera diferente).
{% endhint %}

**Sincronización de la nube de Zoom con CloudLink**

Establece una comunicación segura a través de **Zoom Apps** de ambos **Zoom** y **CloudLink**. Cuando instala estas aplicaciones, un administrador debe iniciar sesión en ambos sistemas para crear una conexión OAuth segura.

Una vez conectado, Zoom extrae los detalles de inicio de sesión del teléfono del usuario a través de TLS:

* SIP "Nombre de usuario" (a menudo el número de teléfono)
* Credenciales SIP (solo hash seguro)
* Direcciones IP de registro (SBC y SBC de respaldo, o PBX interno)

**Proceso de registro de la aplicación**

1. La nube de Zoom transmite las credenciales de inicio de sesión a la aplicación Zoom Workplace del usuario a través de TLS
2. Zoom Workplace activa la pestaña Teléfono
3. La aplicación Zoom Workplace se conecta directamente al SBC o PBX de Mitel mediante TLS (sin pasar por proxy a través de la nube de Zoom)

**Adicional** **Flujos**

* Funciones: La aplicación Zoom Workplace se comunica directamente con Mitel CloudLink mediante API REST sobre TLS para registros de llamada, mensajes de voz y el estado de No molestar
* Push móvil: Mitel SBC envía notificaciones push a la nube de Zoom, que las reenvía a Dispositivos móviles
* Adaptación de red: Los usuarios remotos se conectan a través de CloudLink y Mitel SBC. Los escritorios en el sitio se conectan directamente a Mitel PBX. Los Dispositivos móviles usan la ruta externa segura.

### Configure la integración

La configuración de Integraciones entre Zoom y Mitel es sencilla, y el trabajo del lado de Zoom promedia alrededor de 45 minutos, con una parte mayor del lado de Mitel. Comuníquese con Mitel o con su socio de Mitel si tiene preguntas adicionales o necesita información sobre los tiempos.

Cualquier administrador que realice estos pasos necesitará el **Integraciones del sistema de telefonía** Permiso para completar todos los pasos.

#### <mark style="color:azul;">Complete la configuración inicial de Zoom Phone</mark>

Si es un cliente nuevo y aún no ha configurado Zoom Phone, siga nuestro documento de soporte sobre [Introducción a Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060257#h_5ae26a3a-290c-4a8d-b3b0-6384ed267b13). De lo contrario, continúe con el siguiente paso.

#### <mark style="color:azul;">Deshabilitar la asignación automática de la licencia telefónica para Zoom Workplace</mark>

Para Deshabilitar la asignación automática de licencia de Zoom Phone para todos los usuarios de la cuenta:

1. Iniciar sesión en el [portal web de Zoom](https://zoom.us/profile) como administrador.
2. En el menú de navegación de la izquierda, haga clic en **Gestión de la cuenta**, luego **Configuración de la cuenta**.
3. Haz clic en el **Zoom Phone** pestaña.
4. En **General**, haga clic en el **Activar automáticamente a los usuarios de Zoom Phone** Alternar para Deshabilitarlo.
5. Si aparece un cuadro de diálogo de Verificación, haga clic en **Deshabilitar** para verificar el Cambie.

#### <mark style="color:azul;">Añadir usuarios a Zoom</mark>

Puede Añadir usuarios individualmente, con un archivo CSV, o mediante SSO (Inicio de sesión único) siguiendo los pasos de nuestro documento de Soporte sobre [Administrar usuarios](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061789#h_8b193526-997c-4385-955b-ffddda0b0404). Si va a Invitar a un usuario existente a Unirse a su cuenta de Zoom, Más información sobre el proceso de [Añadir usuarios existentes a una cuenta de pago](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063202), como gestionar cualquier saldo restante y los datos que se transferirán a su cuenta.

#### <mark style="color:azul;">Asignar licencias a usuarios</mark>

Puedes Asignar licencias de productos de Zoom individualmente o en bloque. Más información está Disponible sobre cómo [Asignar licencias de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911) en el artículo vinculado.

#### <mark style="color:azul;">Instala la aplicación Mitel desde Zoom App Marketplace</mark>

Para conectar Zoom con Mitel CloudLink, siga los pasos a continuación:

1. Iniciar sesión en el [portal web de Zoom](https://zoom.us/profile) como administrador.
2. En el menú de navegación izquierdo, debajo de **Avanzado** haz clic en **Aplicación Marketplace**.
3. Use el cuadro de búsqueda para encontrar el **Aplicación Mitel PSI** y selecciónelo. Haga clic **Añadir**.
4. Haga clic **Crear Conector**.
5. Haga clic **Conectar** para confirmar que desea conectar el Conector de terceros de Mitel a su cuenta de Zoom. Se abrirá una ventana del navegador, redirigiéndole a Mitel CloudLink.
6. Iniciar sesión en Mitel CloudLink. La comunicación entre Zoom y CloudLink de Mitel ya se ha completado.

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

Mitel también tiene una tienda de aplicaciones para CloudLink donde se puede agregar Zoom para ser redirigido a Zoom para finalizar.
{% endhint %}

#### <mark style="color:azul;">Configure la Configuración de Integraciones telefónicas</mark>

Para Habilitar a los usuarios de la aplicación móvil de Zoom Workplace para realizar llamadas a través de un sistema local de Mitel, siga los pasos a continuación:

1. Iniciar sesión en el [portal web de Zoom](https://zoom.us/profile) como administrador.
2. En el menú de navegación de la izquierda, haga clic en **Gestión de la cuenta**, luego **Integraciones del sistema de telefonía**.
3. Haz clic en el **Configuración** pestaña.
4. Para integrar las llamadas en la aplicación móvil de Zoom Workplace, Seleccione el **Permitir usar el sistema de telefonía integrado para realizar una llamada en el cliente móvil de Zoom** Alternar.
5. Si aparece un cuadro de diálogo de Verificación, haga clic en **Habilitar** o **Deshabilitar** para verificar el Cambie.

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

* Asegúrese de que esta configuración esté siempre habilitada.
* Si esta opción está activada y los usuarios están en la lista de Integraciones del sistema de telefonía, estos usuarios pueden usar un sistema local de Mitel para realizar una llamada a través de la aplicación móvil de Zoom Workplace.
  {% endhint %}

#### <mark style="color:azul;">Añadir usuarios de Zoom a Mitel PSI</mark>

Puede seleccionar añadir usuarios manualmente o en lote mediante CSV. Consulte los pasos para [agregando usuarios de Zoom a las Integraciones de Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurdfim2r8) en nuestro artículo de soporte vinculado.

#### <mark style="color:azul;">Verifique las Integraciones Zoom-Mitel en la aplicación Zoom Workplace</mark>

Para verificar que las Integraciones estén configuradas correctamente, inicie sesión en la aplicación Zoom Workplace (de escritorio o móvil) y haga clic en la **Teléfono** pestaña. Asegúrese de que pueda ver el ID de llamada (extensión de Mitel) y de que no haya mensajes de error. Si hay errores, la columna de estado proporciona información relevante:

| Estado                            | Descripción                                                                                                                 |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Credenciales SIP pendientes**   | A la espera de que CloudLink autorice al usuario.                                                                           |
| **Inactivo**                      | La credencial SIP ya se ha sincronizado con Zoom, pero el usuario aún no se ha registrado con la aplicación Zoom Workplace. |
| **Registrado**                    | La aplicación Zoom Workplace se ha registrado correctamente en el servidor SIP.                                             |
| **Códigos de error SIP (varios)** | Esto proporcionará códigos de error SIP comunes y una descripción general para ayudar a solucionar el problema de registro. |

#### <mark style="color:azul;">Configure Administración de usuarios de Mitel</mark>

Use las referencias en nuestra [Configuración de PSI de Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) guía para obtener información inicial. Contacte con Mitel o con su socio de Mitel para preguntas o información adicional.

#### <mark style="color:azul;">Consideraciones de seguridad</mark>

Nuestra [Configuración de PSI de Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) guía incluye algunas consideraciones de seguridad para su Organización. Contacte con Mitel o con su socio de Mitel para preguntas o información adicional.

#### <mark style="color:azul;">Administrar contactos externos (contactos que no son de Zoom)</mark>

Los propietarios de la cuenta y los administradores pueden crear un directorio compartido de contactos externos. Hay más información en nuestra[ Configuración de PSI de Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) guía. Contacte con Mitel o con su socio de Mitel para preguntas o información adicional.

#### <mark style="color:azul;">Traiga su propio PBX (BYOP)</mark>

BYOP le permite crear un troncal SIP entre Zoom Phone y Mitel para marcar por extensión. Combine y mezcle: algunas oficinas usan Zoom Phone mientras que otras usan las Integraciones de Mitel. Con un troncal BYOP, los usuarios marcan extensiones entre sistemas.

<div data-with-frame="true"><figure><img src="/files/6093bf185e83c8f79f8780d98c2000bd7433a420" alt=""><figcaption></figcaption></figure></div>

Esta configuración requiere reglas adicionales de firewall y usa TLS mutuo. Consulte nuestro sitio de Soporte para conocer los requisitos. Hemos coescrito documentos de soporte con Mitel para OpenScape SBC y MiVoice Border Gateway, que están Disponible en nuestra página de hardware compatible de Zoom Phone.

#### <mark style="color:azul;">Soporte para teléfonos de escritorio Mitel en Zoom Phone</mark>

Los usuarios de Zoom Phone pueden usar teléfonos de escritorio Mitel que se registran directamente en Zoom Phone. Para obtener una lista de modelos compatibles, consulte el [listado de hardware certificado de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060242).

### Preguntas frecuentes

#### <mark style="color:azul;">Es posible que se requieran actualizaciones de licencia o de software, según la configuración de su sistema Mitel</mark>

Cada configuración de Mitel es diferente, así que lo que necesita depende de su configuración específica. Su socio de Mitel puede evaluar rápidamente su sistema y decirle si necesita actualizaciones de licencia (como licencias de teletrabajador) o actualizaciones de software para que todo sea compatible. Vale la pena hacer una comprobación rápida, ya que los requisitos varían mucho entre implementaciones.

#### <mark style="color:azul;">Mitel CloudLink es necesario para que funcione esta Integraciones</mark>

Sí, CloudLink es clave. Ayuda a mantener todo en Sincronizar entre Zoom y su sistema Mitel, como la información del usuario y las credenciales de inicio de sesión. También simplifica la Administración de usuarios.

#### <mark style="color:azul;">Sí, esta integración funciona junto con las implementaciones de Zoom Phone</mark>

Puede combinar y mezclar: algunas oficinas pueden usar Zoom Phone sin integrar mientras que otras usan las Integraciones de Mitel. Con un troncal BYOC/BYOP que los conecte, los usuarios incluso pueden marcar extensiones entre diferentes sistemas. Use lo que funcione mejor para cada ubicación.

#### <mark style="color:azul;">Puede usar tanto un teléfono de escritorio Mitel como la aplicación Zoom Workplace</mark>

La aplicación Zoom Workplace funciona junto con su teléfono de escritorio existente, no en lugar de él. Ambos pueden sonar cuando alguien llama a su extensión, así que puede responder el que le resulte más conveniente. Su sistema Mitel trata a Zoom Phone como otro teléfono en su escritorio.

#### <mark style="color:azul;">Zoom se conecta a Mitel a través de CloudLink</mark>

CloudLink es el puente que hace que Zoom y Mitel se comuniquen entre sí. Se encarga de tres cosas principales: verificar que los usuarios sean quienes dicen ser, mantener sincronizada la información de los usuarios entre ambos sistemas y pasar de forma segura las credenciales de inicio de sesión que Zoom necesita para conectarse a su sistema Mitel. Sin CloudLink actuando como traductor, estos dos sistemas no podrían trabajar juntos; eso es lo que hace posible la integración.

#### <mark style="color:azul;">No puede enviar mensajes SMS a través de esta integración</mark>

SMS no es compatible en este momento porque la aplicación Zoom Workplace, esencialmente, actúa como un softphone que se conecta a su sistema Mitel solo para llamadas de voz. SMS funciona con tecnología completamente diferente que su sistema Mitel maneja por separado. Piénselo así: Zoom está usando las funciones de llamada de su sistema Mitel, pero SMS vive en otra parte de ese sistema a la que no se puede acceder mediante esta integración. Tendrá que seguir utilizando sus herramientas actuales de SMS de Mitel por ahora, aunque esto podría cambiar en futuras actualizaciones.

#### <mark style="color:azul;">La herramienta de conectividad de red no funcionará con teléfonos Mitel</mark>

La herramienta de conectividad de red de Zoom no puede probar las conexiones de su teléfono Mitel porque está diseñada para comprobar los propios servidores de Zoom, no su sistema Mitel. Cuando usa esta Integraciones, sus llamadas pasan por la red de Mitel (ya sea directamente a su PBX o a través de los servidores de Mitel), por lo que la herramienta de pruebas de Zoom simplemente no puede ver ni probar esas rutas. Es como intentar usar la herramienta de diagnóstico de un coche en una marca diferente: simplemente hablan idiomas distintos. Sin embargo, la herramienta seguirá funcionando bien para probar sus conexiones habituales de reunión de Zoom.

#### <mark style="color:azul;">Los usuarios de Zoom no pueden ver la presencia de los usuarios que solo tienen teléfonos de escritorio Mitel</mark>

Sus teléfonos de escritorio Mitel tradicionales no comparten con Zoom si alguien está Disponible o en una llamada. Las Integraciones funcionan muy bien para mostrar presencia entre usuarios de la aplicación Zoom Workplace, pero esos teléfonos de escritorio de la vieja escuela operan en su propio mundo y no pueden compartir su estado con el sistema de Zoom. Está en la hoja de ruta para mejorar esto, pero por ahora solo verá presencia de las personas que realmente usan la aplicación Zoom Workplace.

#### <mark style="color:azul;">Actualmente, no hay funciones de Zoom AI Disponible con las Integraciones Mitel PSI</mark>

Sus llamadas pasan por el sistema de Mitel, no por la nube de Zoom donde vive la Zoom AI, así que Zoom AI no puede acceder a sus conversaciones. Eso significa que no hay transcripción automática del correo de voz, resúmenes de llamadas ni otras funciones de Zoom AI que obtendría con Zoom Phone sin integrar. Las llamadas omiten por completo el procesamiento de Zoom AI. Las futuras actualizaciones podrían cambiar esto, pero por ahora tendrá que usar las herramientas de Zoom AI que ofrezca su sistema Mitel.

#### <mark style="color:azul;">Si algo no funciona después de la configuración, revisa tu Configuración de Integraciones de teléfono en Zoom</mark>

Cuando las llamadas no funcionan, revisa el estado de Sincronizar en la pestaña de Usuarios integrados en la Configuración de Integraciones del sistema de telefonía en el portal del administrador. Los fallos de sincronización suelen significar que CloudLink no está pasando las credenciales correctamente — ahí es cuando querrás revisar tus registros de CloudLink para ver qué está mal.

#### <mark style="color:azul;">Eres responsable de los certificados de tu Dispositivo</mark>

Como te estás Conectando a tu propio sistema Mitel (no a los servidores de Zoom), debes instalar los certificados de seguridad de tu empresa en cada Dispositivo que usará esta configuración de Integraciones. Piensa en los certificados como llaves digitales — Zoom gestiona sus propias llaves para un Zoom Phone no integrado, pero con esta configuración de Integraciones, estás usando tus propias «llaves» para conectarte a tu propio sistema. Tu equipo de TI necesita asegurarse de que cada portátil, teléfono y Tableta tenga instalados los certificados correctos o no podrán establecer conexiones seguras con tu sistema Mitel.

#### <mark style="color:azul;">Conectando es fácil, ya sea en el sitio o en la red corporativa</mark>

El sistema adapta cómo se conecta según dónde estés. Si estás trabajando desde casa o en una cafetería, tus aplicaciones móviles y de escritorio se conectarán a través de CloudLink y del Controlador de borde de sesión de Mitel para mayor seguridad. Pero si estás en la oficina en la red de tu empresa, tu escritorio puede conectarse directamente al PBX de Mitel para llamadas más rápidas y eficientes. Los Dispositivos móviles siempre usan la ruta externa segura para mantener la coherencia y la seguridad, independientemente de la Ubicación.

#### <mark style="color:azul;">Solo los Propietarios de cuenta o administradores pueden Añadir la aplicación Mitel PSI a Zoom</mark>

Aunque la aplicación Mitel PSI no utiliza privilegios de Propietario o administrador después de la instalación, sí los requiere para la configuración inicial. **Ten en cuenta:** si el Propietario o administrador que originalmente añadió la aplicación deja la cuenta, la configuración de Integraciones dejará de funcionar. Para restaurar la funcionalidad, otro administrador o el nuevo Propietario deberá volver a autorizar la aplicación.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://library.zoom.com/technical-library/es/zoom-workplace/zoom-phone/third-party-integrations/zoom-and-mitel-phone-system-integration-field-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
