> 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/rincon-del-administrador/account-and-endpoint-management/scim-guide.md).

# Guía de campo de SCIM para Entra ID y Okta

Una guía para crear asignaciones SCIM personalizadas entre Entra ID u Okta y Zoom

## Resumen

La API SCIM2 de Zoom expone un amplio catálogo de atributos de usuario que controlan las licencias, los derechos de producto, los roles, las regiones y la configuración por servicio. Las integraciones de aprovisionamiento listas para usar tanto para Microsoft Entra ID como para Okta asignan solo un pequeño subconjunto de estos — suficiente para crear, actualizar y desactivar usuarios, pero no suficiente para aprovisionar sitios de Zoom Phone, paquetes de centro de contacto, roles de Revenue Accelerator ni ninguna de las docenas de otros atributos que Zoom admite.

Esta guía enseña un método repetible para agregar *cualquier* atributo SCIM de Zoom a la configuración de aprovisionamiento. En lugar de documentar un solo atributo de forma aislada, explica el modelo subyacente para que los administradores puedan buscar un atributo en la referencia de la API SCIM2 de Zoom y configurarlo de forma independiente, sin tener que esperar a que se publique un artículo específico del producto.

### Cómo usar esta guía

Lee primero la introducción, que comienza con [**Comprender los atributos SCIM**](#understanding-scim-attributes) y también las secciones siguientes: requisitos previos, datos del directorio, escenarios de referencia y verificación en Zoom. Estas secciones se aplican independientemente del proveedor de identidad (IdP) que uses. Después, sigue la sección de Microsoft Entra ID o de Okta, según cuál utilices. Cada una de esas secciones abarca todo el proceso, desde el primer paso de configuración hasta la verificación y los ejemplos prácticos, así que no tendrás que alternar entre ellas.

Para consultar los conceptos fundamentales de SSO y SCIM en los que se basa esta guía, consulta la [Guía de campo de SSO](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), el artículo de [Zoom sobre SSO y aprovisionamiento para Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), y el [artículo de SSO de Zoom para Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

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

El aprovisionamiento mal configurado afecta a los usuarios existentes, incluida la eliminación de licencias ya en uso. Valide cada Cambie frente a un único usuario de prueba antes de aplicarlo a una población real.
{% endhint %}

### **Requisitos previos para usar SCIM**

Todo en esta parte se aplica independientemente del proveedor de identidad. Lea esto antes de pasar a sus instrucciones específicas del proveedor de identidad.

#### Requisitos comunes para ambos proveedores de identidad

* cuenta de Zoom Comercial, Educación o Empresarial con una [URL mnemónica](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* privilegios de propietario de cuenta de Zoom o administrador
* [Inicio de sesión único](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) habilitado en la cuenta de Zoom
* Un [dominio asociado verificado](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) en la cuenta de Zoom, que coincida con el dominio de correo electrónico de los usuarios que se aprovisionarán
* El aprovisionamiento SCIM ya está establecido entre el proveedor de identidades y Zoom
* La licencia de Zoom, el plan, el add-on o el objeto de configuración que se asigna ya debe existir y estar Disponible en la cuenta de Zoom

Los requisitos específicos del proveedor de identidad se enumeran al principio de cada sección correspondiente.

#### Limitaciones comunes a ambos proveedores de identidad

* SCIM solo asigna derechos existentes; no puede crear los objetos a los que hace referencia. Consulta la sección [**Antes de intentar el mapeo avanzado, los objetos correspondientes en Zoom deben existir para que SCIM pueda hacer referencia a ellos.**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) a continuación.
* Algunos atributos solo aceptan un valor por usuario. Un plan de llamadas de Zoom Phone es un ejemplo: los paquetes add-on, como Customer Engagement Pack, no se pueden aprovisionar mediante SCIM.
* El `userType` Zoom documenta este atributo como previsto para su obsolescencia.

## **Introducción**

### **Entendiendo los atributos SCIM**

Los administradores que entienden cómo se construye un atributo de Zoom SCIM pueden Configure cualquier atributo que Zoom admita. Los administradores que siguen una receta pueden Configure solo el atributo que esa receta describe. Esta sección cubre la construcción. La asignación de un atributo a una fuente de datos viene después, en las secciones del proveedor de identidades.

#### <mark style="color:azul;">Todo atributo tiene un espacio de nombres, un nombre, un tipo de datos y un valor permitido</mark>

Comencemos con un ejemplo completo y funcional. Aquí está el identificador para asignar un usuario a un sitio de Zoom Phone:

```
urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario:zoomPhoneSite
```

Hay cuatro propiedades de este atributo en juego. Dos de ellas aparecen en la línea anterior. Las otras dos proceden de la referencia de la API y se introducen más adelante en otro lugar del proveedor de identidad. Por ahora, nos centraremos en dos: el **Espacio de nombres** y el **Nombre**.

<table><thead><tr><th width="155.290771484375">Propiedad</th><th>Extraído del ejemplo</th><th>Qué hace</th></tr></thead><tbody><tr><td><strong>Espacio de nombres</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>Le indica a Zoom a qué esquema pertenece la configuración y actúa como la base compartida para casi todos los productos de Zoom y los atributos de licencia. Se pasa a Zoom como la primera mitad del identificador.</td></tr><tr><td><strong>Nombre</strong></td><td><code>zoomPhoneSite</code></td><td>Identifica la configuración específica de Zoom que se está escribiendo — aquí, el sitio de Zoom Phone del usuario. Se pasa a Zoom como la segunda mitad del identificador. Distingue mayúsculas y minúsculas.</td></tr><tr><td><strong>Tipo de datos</strong></td><td><code>string</code></td><td>Indica a tu proveedor de identidad qué tipo de valor contiene el atributo para que se almacene y se formatee correctamente. No se pasa como parte del identificador; se declara por separado como <strong>Tipo</strong> en Entra ID, o <strong>Tipo de datos</strong> en Okta.</td></tr><tr><td><strong>Valor permitido</strong></td><td><code>LON-01</code>, un nombre de sitio de Zoom Phone</td><td>El valor que se aplica realmente al usuario. Texto libre para algunos atributos y un conjunto fijo para otros — <code>Elementos esenciales</code>, <code>Premium</code>, o <code>Elite</code> para Zoom centro de contacto, por ejemplo. Se pasa a Zoom durante el aprovisionamiento y lo proporciona la asignación, no el identificador.</td></tr></tbody></table>

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

Zoom publica más de un espacio de nombres de extensiones de usuario. Los atributos de configuración del producto y de licencias usan `urn:ietf:params:scim:schemas:extension:zoom:1.0:User`, que es el espacio de nombres que se usa en toda esta guía. Campos empresariales estándar, como `department`, `manager` y `costCenter` usar `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. En tercer lugar, `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`, contiene información sobre el tipo de inicio de sesión que se devuelve en las respuestas de la API, en lugar de configurarse durante el aprovisionamiento. Tu proveedor de identidad acepta un atributo creado con el espacio de nombres incorrecto y Zoom lo ignora silenciosamente.
{% endhint %}

#### <mark style="color:azul;">Localice el atributo que necesita en la referencia de la API SCIM2</mark>

El [Referencia de la API de SCIM2](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) es la lista autorizada de todo lo que Zoom acepta durante el aprovisionamiento. Hay dos operaciones importantes: **Crear un usuario** y **Actualizar un usuario**.

Trabaje principalmente desde **Actualizar un usuario**. La creación ocurre una sola vez por persona, pero los cambios de atributos son continuos: un cambio de oficina, un cambio de plan, un cambio de función o la salida de un usuario. Por eso, la mayor parte de lo que hace realmente el aprovisionamiento con el tiempo son actualizaciones. **Actualizar un usuario** también documenta los valores de eliminación que **Crear un usuario** no tiene motivos para incluir, como establecer `zoomPhoneCallingPlan` a `-1` para quitar todos los planes de llamadas de un usuario.

Para encontrar un atributo:

* Abre la referencia de la API SCIM2 y ve a **Actualizar un usuario**.
* En el cuerpo de la solicitud, busca el `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` objeto. Cada atributo que se trata en esta guía aparece en él.
* Busca tu atributo por nombre y graba su **tipo de datos** y su **valores permitidos**.
* Lee la descripción que aparece junto a él. Las descripciones indican comportamientos que no se pueden deducir del nombre del atributo: `zoomPhoneExtNumber` establecido en `0` activa la asignación automática de extensiones, `zoomPhoneCallingPlan` establecido en `-1` elimina todos los planes de llamadas, y `zoomPhoneNumber` debe hacer referencia a un número que ya esté sin asignar en la cuenta de Zoom.

#### <mark style="color:azul;">Ensamblando el identificador: padre, dos puntos, hijo</mark>

Todo lo que aparece dentro de ese `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` el objeto es un **hijo** de ello. El propio objeto es el **principal**. Crear un identificador significa nombrar el elemento principal, añadir dos puntos y, después, el elemento secundario:

```
Padre       urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario
Colon        :
Hijo        zoomPhoneSite

identificador   urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario:zoomPhoneSite
```

Esa es toda la construcción. No hay ninguna tabla de búsqueda que solicitar a Zoom ni nada que generar — el identificador son dos cosas que ya tienes, unidas por dos puntos.

#### <mark style="color:azul;">El padre permanece igual; solo cambia el hijo</mark>

Como el padre es fijo, configurar un segundo, quinto o decimoquinto atributo es la misma acción con un hijo diferente añadido:

```
Base (principal)              urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario

Zoom Phone sitio            urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario:zoomPhoneSite
Número de Zoom Phone          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
extensión de Zoom Phone       urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario:zoomPhoneExtNumber
Zoom Phone plan de llamadas    urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan
```

La misma empresa matriz engloba todos los demás productos de Zoom. Nada acerca de la construcción cambia cuando lo hace el producto:

```
Paquete de centro de contacto     urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomContactCenterPackage
Rol, función de aceleración de ingresos   urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole
Paquete de trabajo           urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:usuario:zoomDocs
```

Por lo tanto, aprendes el padre una vez. A partir de entonces, configurar un nuevo atributo significa consultar solo tres cosas en la referencia de la API: el nombre del hijo, su tipo de datos y sus valores permitidos.

Si puedes ensamblar un padre y un hijo, la parte más difícil de esta configuración ya quedó atrás. Lo que queda es decirle a tu proveedor de identidad de dónde debe provenir cada valor —lo que se cubre en las secciones de Entra ID y Okta que siguen— y decidir qué atributos abordar primero, tratado en la Siguiente sección.

#### <mark style="color:azul;">Dos tipos de mapeo: Básico y avanzado</mark>

No todos los atributos conllevan el mismo riesgo, y vale la pena clasificarlos antes de configurar nada.

Esta guía toma prestados los términos **Básico** y **avanzado** de la [Guía de campo de SSO](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), que establece la misma distinción para la asignación de respuestas SAML. Los términos describen **qué hace Zoom con el valor cuando lo recibe**, no lo difícil que es configurar el atributo. En la práctica, ambos son idénticos: se documentan en el mismo **Actualizar un usuario** cuerpo de la solicitud, ambos se crean con la misma estructura de elemento principal y secundario separada por dos puntos, y ambos se declaran y asignan mediante los mismos pasos en Entra ID y Okta.

* **Asignación básica** escribe texto en el perfil de un usuario. Zoom almacena el valor exactamente como se envía y nunca lo comprueba.
* **Asignación avanzada** realiza una solicitud para la cuenta. Zoom toma el valor y busca un objeto coincidente o una licencia disponible en un plan contratado, y esa búsqueda puede fallar.

<table><thead><tr><th width="199.435791015625"></th><th>Mapeo Básico</th><th>Mapeo avanzado</th></tr></thead><tbody><tr><td><strong>Qué es el valor</strong></td><td>Texto almacenado en el perfil del usuario</td><td>Un puntero a un objeto en Zoom, o un derecho sobre un asiento adquirido</td></tr><tr><td><strong>Ejemplos</strong></td><td><code>department</code>, <code>title</code>, <code>costCenter</code></td><td><code>zoomPhoneSite</code>, <code>zoomContactCenterRole</code>, <code>zoomWorkplace</code></td></tr><tr><td><strong>Padre</strong></td><td>Nivel superior, o la extensión Empresarial</td><td>La extensión de Zoom</td></tr><tr><td><strong>Precondiciones en Zoom</strong></td><td>Ninguno</td><td>El objeto debe existir, o el asiento debe estar libre</td></tr><tr><td><strong>Si el valor es incorrecto</strong></td><td>Aparece texto incorrecto en un perfil</td><td>El atributo es rechazado o ignorado en silencio</td></tr></tbody></table>

La distinción determina dos decisiones prácticas. Determina **qué debes crear primero en Zoom** : nada para la asignación básica y posiblemente mucho para la avanzada; también determina **cuánto cuesta un error**. Un departamento incorrecto es un error estético en un perfil. Un nombre de sitio incorrecto o una licencia sin plazas disponibles deja al usuario sin un teléfono operativo o sin el producto para el que fue contratado, y en una implementación en producción puede quitarle un derecho a alguien que ya lo tenía.

Esa diferencia en la consecuencia es la razón por la que ambos se tratan por separado a continuación.

#### <mark style="color:azul;">Mapeo Básico: información del perfil</mark>

El mapeo Básico rellena los campos descriptivos del perfil de Zoom de un usuario. Zoom almacena cada valor exactamente tal como se envía y nunca lo valida contra un objeto existente, por lo que no hay nada que construir en Zoom de antemano y nada que se rompa si un valor es incorrecto.

**Los campos de identidad principales suelen estar ya asignados.** `userName`, `name.givenName`, `name.familyName`, `displayName` y `emails` estar en el nivel superior del cuerpo de la solicitud, sin ningún elemento principal, y las integraciones de Entra ID y Okta los asignan de forma predeterminada. Verifíquelos en lugar de volver a crearlos. `title`, `phoneNumbers` y `locale` también son de nivel superior, pero puede que haya que añadirlos.

**Los campos Empresarial usan un segundo elemento principal.** La estructura no cambia; solo cambia el elemento principal:

```
Base (principal)         urn:ietf:params:scim:schemas:extension:Empresarial:2.0:usuario

Departamento            urn:ietf:params:scim:schemas:extension:Empresarial:2.0:usuario:departamento
Centro de costos           urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter
Número de empleado       urn:ietf:params:scim:schemas:extension:Empresarial:2.0:usuario:empleadoNumber
Organización          urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Organización
Gerente               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

Poblar el Departamento y el Centro de Costos a través de SCIM ya no requiere asignación de SAML.

{% hint style="info" %}
**Recomendación**

Primero, asigna un atributo básico: `department` es una buena opción y se desarrolla como **Escenario 0** en los escenarios de referencia, y ejecútalo de principio a fin para un único usuario de prueba antes de configurar nada en la extensión de Zoom. Un `department` valor que aparece correctamente en un perfil de Zoom demuestra que la declaración del esquema, la asignación, el ámbito y tu capacidad para leer los registros de aprovisionamiento funcionan. Cada atributo avanzado que se presenta a continuación solo difiere en aquello a lo que apunta, no en la forma de configurarlo.
{% endhint %}

#### <mark style="color:azul;">Asignación avanzada: configuración del producto y derechos</mark>

La asignación avanzada define las cosas que un usuario puede hacer: un sitio de Zoom Phone y un plan de llamadas, un Rol, función y un Paquete de centro de contacto, un paquete de Workplace, un segmento de Revenue Accelerator. Estos atributos residen bajo el elemento padre de la extensión de Zoom que se usa en toda esta guía.

La diferencia importante es que estos valores no se almacenan: se **resuelven**. Zoom toma el valor que envías y busca un objeto coincidente o una licencia disponible. Mientras que la asignación básica escribe texto en un perfil, la asignación avanzada formula una solicitud basada en la configuración y el inventario de la cuenta, y esta puede fallar.

Por eso esta guía dedica una sección completa a las precondiciones. Cada atributo avanzado depende de que algo se haya creado o adquirido primero en el portal web de Zoom, y los modos de fallo son considerablemente menos indulgentes que un título de puesto mal escrito.

#### <mark style="color:azul;">Las tres capas comunes a toda configuración</mark>

Independientemente de cuál sea el atributo o el proveedor de identidad, el trabajo consta de las mismas tres capas. Solo la Ubicación de cada control difiere.

<table><thead><tr><th width="114.4166259765625">Capa</th><th>Propósito</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. Declarar</strong></td><td>Indica al proveedor de identidad que el atributo existe en la aplicación Zoom para que esté disponible como destino de mapeo.</td><td>Etapa 1</td><td>Etapa 1</td></tr><tr><td><strong>2. Mapear</strong></td><td>Define de dónde proviene el valor.</td><td>Etapa 2</td><td>Pasos 2–3</td></tr><tr><td><strong>3. Alcance</strong></td><td>Determine a qué usuarios se aplica la configuración y cuándo se ejecuta.</td><td>Pasos 3–5</td><td>Pasos 4–5</td></tr></tbody></table>

Una vez que se comprende este patrón, añadir un quinto o decimoquinto atributo es una repetición de las mismas tres capas, no un proyecto nuevo.

#### <mark style="color:azul;">Entra y Okta difieren en dónde puede originarse un valor</mark>

Esta es la diferencia arquitectónica más consecuente entre las dos rutas, y explica por qué el mismo requisito Comercial produce configuraciones diferentes entre Entra y Okta.

* **Entra ID solo obtiene valores de los atributos del objeto de usuario.** El valor debe proceder de un campo del usuario: un campo existente del directorio o un atributo de extensión diseñado específicamente para este fin. Si el valor del directorio y el valor de Zoom no son la misma cadena, se necesita una expresión para convertir uno en otro.
* **Okta puede obtener valores del perfil de usuario o de una asignación a un grupo.** Declarar un atributo con **Tipo de atributo: Grupo** permite establecer el valor una sola vez en un grupo y que lo hereden todos sus miembros. Cuando la configuración sigue la estructura organizativa, esto elimina por completo la necesidad de lógica de traducción.

Ninguno de los dos enfoques es universalmente mejor, pero dan lugar a configuraciones diferentes.

### **Requisitos de preconfiguración del lado de Zoom**

#### <mark style="color:azul;">Antes de intentar un mapeo avanzado, los objetos del lado de Zoom deben existir antes de que SCIM pueda hacer referencia a ellos</mark>

SCIM es un mecanismo de asignación, no de creación: conecta un usuario con una configuración que ya existe en la cuenta de Zoom y **no puede** crear esa configuración en nombre del usuario.

Una gran parte de los atributos de asignación avanzada son **referencias**: se espera que el valor que envíe corresponda a un objeto que ya exista en Zoom: un sitio, un rol, una plantilla, un plan comprado, un número o una extensión específicos. Una regla los rige a todos:

> Si un atributo nombra una cosa, esa cosa ya debe existir, debe escribirse exactamente como se envió y — cuando procede de un conjunto finito — debe tener capacidad no utilizada.

Cuando un objeto al que se hace referencia no existe, SCIM no lo crea ni pone la solicitud en cola. El atributo falla directamente, con el error devuelto en el registro de aprovisionamiento, o se descarta en silencio — Zoom acepta la carga útil, no aplica nada e informa de éxito.

Las secciones siguientes desglosan los requisitos previos por producto, con la ruta de navegación y el artículo de Soporte para crear cada uno. Lea las notas a nivel de cuenta y luego la sección de cada producto que piense aprovisionar.

#### <mark style="color:azul;">Los requisitos previos a nivel de cuenta se aplican antes de aprovisionar cualquier producto</mark>

Los requisitos de la cuenta indicados al principio de esta guía —URL mnemónica, SSO, autorización de SCIM y un dominio asociado verificado— son requisitos previos para todos los atributos que se indican a continuación. Configure la seguridad y el SSO en [**Centro de administración**](https://zoom.com/account) → [**Seguridad y confianza**](https://zoom.com/account/setting/security), y gestione los dominios asociados en [**Centro de administración**](https://zoom.com/account) → **Cuenta** → [**Perfil de la cuenta**](https://zoom.com/account); consulte [Configuración de SSO/SCIM de Zoom + Microsoft Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

Conviene señalar explícitamente dos puntos más:

* **Comprar una licencia no es lo mismo que asignarla.** SCIM realiza la asignación, pero la licencia debe existir primero. Consulte [Asignar o quitar licencias de Zoom a usuarios](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **Las licencias deben corresponder exactamente al plan solicitado.** Si ese plan específico no tiene licencias disponibles, enviar un atributo de licencia falla, aunque otro plan de la cuenta tenga capacidad disponible.

#### <mark style="color:azul;">Zoom Phone</mark>

Zoom Phone incluye el mayor conjunto de atributos de referencia porque un usuario de teléfono se ensambla a partir de varias piezas de infraestructura compradas o creadas previamente.

| Atributo                                                                   | Qué debe existir ya                                                                                                                                                                             | Cómo crearlo                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La licencia de Zoom Phone en sí                                            | Un asiento de Zoom Phone Disponible — el derecho previo necesario antes de que se pueda asociar nada de lo siguiente.                                                                           | Compre por adelantado. Consulte [Comprar y asignar licencias de Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `zoomPhoneSite`                                                            | El sitio, nombrado exactamente igual que el valor enviado. Si se omite el atributo, se asigna el sitio principal predeterminado de la cuenta, que existe una vez que se habilita Varios sitios. | [Centro de administración](https://zoom.com/account) → Configuración del producto → Sistema de telefonía → [Información de la empresa](https://zoom.com/pbx/page/telephone/settings#/settings) → **Añadir sitio**, o **Importar** para la creación en bloque. Consulte [Administrar varios sitios](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                                                                    |
| `zoomPhoneNumber`                                                          | El número, comprado o portado a la cuenta y actualmente sin asignar. Un número ya asignado a otro usuario, cola de llamadas o contestador automático no puede reutilizarse.                     | [Centro de administración](https://zoom.com/account) → Configuración del producto → Números → [Números de teléfono](https://zoom.com/cpw/page/phoneNumbers#/number-list). Compre o porte el número aquí y déjelo sin asignar para que SCIM pueda reclamarlo. Consulte [Usar la gestión de números para administrar números de teléfono](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) y [Administrar números de teléfono](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                                                               |
| `zoomPhoneExtNumber` (solo valores específicos)                            | Una extensión de 3 a 6 dígitos que no esté ya en uso. No es necesaria si se envía `0`, lo que delega la asignación a Zoom.                                                                      | [Centro de administración](https://zoom.com/account) → Configuración del producto → Sistema de telefonía → [Usuarios y salas](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → seleccione el objeto que contiene la extensión → **Perfil** → **Número de extensión** → **Editar**. Consulte [Cambiar la Configuración del usuario de teléfono](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                                                                |
| `zoomPhoneCallingPlan`                                                     | El plan de llamadas, comprado y con capacidad Disponible, al que se hace referencia por su código exacto de plan.                                                                               | Comprar por adelantado. Consulte [Comprar y asignar licencias de Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) y [Administrar usuarios de teléfono](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Los códigos de los planes se enumeran en la [referencia de planes de llamadas de Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/), o se devuelven como `type` por la [API para enumerar planes de llamadas](https://developers.zoom.us/docs/api/references/phone-calling-plans/) junto con el número de puestos libres. |
| `zoomPhoneCallingPlanSubscription` (solo cuentas con varias suscripciones) | La suscripción específica de la que el plan debe tomar, cuando la cuenta tiene más de una suscripción para el mismo plan.                                                                       | Planes y Facturación → gestión de suscripciones.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

**El conjunto de extensiones se comparte entre distintos tipos de objetos, no solo entre usuarios.** Las colas de llamadas, los contestadores automáticos, los grupos de líneas compartidas y los teléfonos de área común utilizan extensiones del mismo intervalo. Esta es la causa más frecuente de los errores «extension already in use», ya que la extensión parece libre cuando un administrador solo comprueba la lista de usuarios.

**Un número portado no se puede asignar hasta que se complete la portabilidad.** El número debe estar tanto presente en la cuenta como sin asignar; iniciar una portabilidad no satisface ninguna de las dos condiciones.

**Los sitios son el obstáculo más habitual** porque su creación conlleva requisitos propios. Las direcciones de los sitios se validan con una base de datos de direcciones reales porque sustentan los servicios de llamada de emergencia; las combinaciones inventadas de dirección y código postal se rechazan con un error de validación. Al importar sitios de forma masiva, la columna Contestador automático espera el valor `Yes` en lugar del texto de la etiqueta que se muestra en la interfaz, y el nombre de ID de llamada se aplica principalmente a Estados Unidos y Canadá y puede dejarse en blanco si provoca un error de validación.

#### <mark style="color:azul;">Zoom centro de contacto</mark>

La provisión de centro de contacto se basa en el rol y en plantillas. Los atributos individuales deben resolverse en objetos existentes del centro de contacto, y la plantilla contiene la Configuración que no tiene su propio atributo SCIM dedicado.

| Atributo                        | Qué debe existir ya                                                                                                                                                  | Cómo crearlo                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | El Paquete — `Essentials`, `Premium` o `Elite` — comprado con puestos sin utilizar.                                                                                  | Comprar por adelantado; es posible que para Premium primero sea necesario ponerse en contacto con Soporte de Zoom para comprar Paquetes adicionales. Consulte [Cambiar la Configuración del usuario del centro de contacto de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                                       |
| `zoomContactCenterAddonsPlan`   | El plan add-on, adquirido y con capacidad.                                                                                                                           | comprar por adelantado; plan de cuenta e Información de facturación.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `zoomContactCenterRole`         | El Rol, función, Estándar o personalizado, nombrado exactamente. Omitirlo asigna el Rol, función de Agente predeterminado, que existe predeterminado.                | [Centro de administración](https://zoom.com/account) → Gestión de CX → Centro de contacto → [Roles](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Añadir** → Configure los permisos → **Guardar**. Consulte [Administrar roles del centro de contacto de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                                                                            |
| `zoomContactCenterRegion`       | La región. Omitirla asigna la región principal de la cuenta, que debe configurarse.                                                                                  | [Centro de administración](https://zoom.com/account) → Gestión de CX → Centro de contacto → [Preferencias](https://zoom.com/cci/index/admin#/admin-preferences) → Regiones → **Añadir región** → Introducir un nombre y Seleccione una zona SIP → **Añadir**. Consulte [Gestión de las regiones del centro de contacto de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                                           |
| `zoomContactCenterUserTemplate` | La plantilla de usuario, nombrada exactamente. Las plantillas de tipo Añadir se aplican al crear el usuario; las plantillas de tipo Update se aplican al actualizar. | [Centro de administración](https://zoom.com/account) → Gestión de CX → centro de contacto → Usuarios → [Plantillas](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Añadir plantilla** → Seleccione **Añadir** → Configure roles, paquetes, colas y habilidades → **Añadir**. Consulte [Gestión de la plantilla de Configuración de usuario del centro de contacto de Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

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

Las Características de regiones del centro de contacto deben ser habilitadas por Soporte de Zoom antes de que se puedan crear regiones, y cada usuario pertenece exactamente a una región. Dado que se trata de una solicitud de soporte y no de un Alternar de autoservicio, plantee esto con antelación si se prevé una implementación multirregión.
{% endhint %}

**Las bandejas de entrada, las colas y las habilidades no tienen atributos SCIM.** Para aprovisionarlas, créelas previamente en [Centro de administración](https://zoom.com/account) → Gestión de CX → centro de contacto, vincúlelas a una plantilla de usuario y proceda a Asignar esa plantilla mediante `zoomContactCenterUserTemplate`. Por tanto, se convierten en requisitos previos de la *plantilla* en lugar de requisitos del usuario individual. Esto también hace que la plantilla sea el único objeto que mantener cuando cambian esos requisitos.

<table><thead><tr><th width="123.2821044921875">Objeto</th><th>Cómo crearlo</th></tr></thead><tbody><tr><td>Cola</td><td><a href="https://zoom.com/account">Centro de administración</a> → Gestión de CX → centro de contacto → <a href="https://zoom.com/cci/index/admin#/admin-queues">Colas</a> → <strong>Añadir cola</strong> → nombre, canal, agentes → <strong>Guardar</strong>. Consulte <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">Gestión de las colas del centro de contacto de Zoom</a>.</td></tr><tr><td>Habilidad</td><td><a href="https://zoom.com/account">Centro de administración</a> → Gestión de CX → centro de contacto → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">Habilidades</a> → Seleccione una categoría → <strong>Añadir habilidad</strong> → nombre → <strong>Añadir</strong>. Consulte <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">Gestión de habilidades y categorías de habilidades</a>.</td></tr><tr><td>Bandeja de entrada</td><td><a href="https://zoom.com/account">Centro de administración</a> → Gestión de CX → centro de contacto → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">Bandeja de entrada</a> → <strong>Añadir bandeja de entrada</strong>. Consulte <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">Gestión de las bandejas de entrada del centro de contacto de Zoom</a>.</td></tr></tbody></table>

**Cuando se proporcionan tanto una plantilla como atributos individuales, prevalecen los valores individuales.** Enviar una plantilla junto con `zoomContactCenterRole` significa que el atributo Rol, función anula la configuración de Rol, función de la plantilla, por lo que tanto el Rol, función indicado como la plantilla deben existir.

#### <mark style="color:azul;">Zoom Revenue Accelerator</mark>

| Atributo                                                            | Qué debe existir ya                                                                                    | Cómo crearlo                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` y `zoomRevenueAcceleratorSubscription` | El plan o suscripción ZRA comprado con un asiento Disponible.                                          | comprar por adelantado; plan de cuenta e Información de facturación.                                                                                                                                                                                                                                                                                                                          |
| `zoomRevenueAcceleratorRole`                                        | El Rol, función, estándar o personalizado, por ejemplo `Responsable de Ventas` — con el nombre exacto. | [Centro de administración](https://zoom.com/account) → Usuarios → [Roles](https://zoom.com/role#/) → **Revenue Accelerator** pestaña → **+ Añadir Rol** → nombre y descripción → **Añadir** → Configure permisos → **Guardar cambios**. Consulta [Uso de la Administración de roles de Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                     | El segmento al que pertenece el usuario.                                                               | Configuración del administrador de Revenue Accelerator.                                                                                                                                                                                                                                                                                                                                       |
| `zoomRevenueAcceleratorRegion`                                      | La región; por ejemplo, `US`.                                                                          | Configuración del administrador de Revenue Accelerator.                                                                                                                                                                                                                                                                                                                                       |

#### <mark style="color:azul;">Licencias de Zoom Workplace y roles de la cuenta</mark>

Más allá de los tres productos anteriores, el registro de usuario Estándar lleva referencias de Rol, función y licencia que siguen la misma regla.

| Atributo                                                                                                                                                                                                                                                 | Qué debe existir ya                                                                                                | Cómo crearlo                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `mostrar`)                                                                                                                                                                                                                          | La cuenta, el Rol, función, denominada exactamente. Los roles se referencian mediante SCIM, nunca se crean con él. | [Centro de administración](https://zoom.com/account) → Usuarios → [Roles](https://zoom.com/role#/) → **Añadir Rol, función** → nombre y descripción → Configure permisos. Consulta [Uso de la Administración de roles](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` y otros atributos de licencia o add-on — pizarra, Scheduler, Clips Plus, subtítulos traducidos, Workforce Management (WFM), Quality Management, Gestión del cumplimiento, CX Insights, AI Sales Assist y sus `...Subscription` homólogos | El paquete o add-on correspondiente, adquirido con asientos sin usar.                                              | Planes y facturación → Gestión de planes → editar el plan → aumentar el número de licencias. Consulta [Cómo mejorar tu cuenta y añadir complementos](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                                   |
| `loginType` (`sso` / `workEmail`), en `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                                                                  | SSO configurado en la cuenta, para el tipo de inicio de sesión SSO.                                                | [Centro de administración](https://zoom.com/account) → Seguridad y confianza → [Inicio de sesión único](https://zoom.com/account/sso/saml).                                                                                                                                                         |

Para un atributo de licencia o add-on no hay ningún objeto que nombrar, pero la precondición tiene el mismo efecto: sin un asiento Disponible en ese grupo específico, la asignación falla.

#### <mark style="color:azul;">Atributos sin precondición</mark>

Todos los atributos de asignación básica son válidos, como se explica en **Asignación básica: información del perfil** — Zoom almacena esos valores tal cual y nunca los valida con respecto a un objeto existente. Dos atributos de la extensión de Zoom se comportan de la misma manera:

* **Valores delegados automáticamente** — `zoomPhoneExtNumber` enviado como `0`, donde Zoom asigna la extensión.
* **Atributos personalizados de la cuenta** — el `{customAttribute}` campo, que contiene cualquier cadena que envíes.

**Las referencias predeterminadas** son un caso intermedio: omitir `zoomPhoneSite`, `zoomContactCenterRole`, o `zoomContactCenterRegion` recurre al sitio principal, al Rol de agente predeterminado y a la región principal, respectivamente. Esos valores predeterminados deben existir, y existen de forma predeterminada.

**Los grupos son una excepción parcial.** Cuando está habilitado el aprovisionamiento de grupos, SCIM crea un grupo de Zoom que aún no existe, usando exactamente el nombre del grupo de origen tal como está escrito. No aplica ninguna configuración de producto a ese grupo: el grupo llega con sus miembros y nada más. Las políticas de Zoom Phone, los permisos de llamadas y otros ajustes a nivel de grupo deben configurarse igualmente en [Centro de administración](https://zoom.com/account) → Usuarios → [Grupos](https://zoom.com/account/group#/) cuando aparezca el grupo.

{% hint style="info" %}
**Recomendación**

Trate la implementación del lado de Zoom como una fase previa con su propia aprobación, completada y verificada antes de que comience el trabajo de mapeo de atributos. Los sitios, números, planes, roles y plantillas suelen estar a cargo de un equipo distinto al de la configuración del proveedor de identidad, y descubrir un objeto faltante durante las pruebas de aprovisionamiento cuesta considerablemente más que confirmar su existencia de antemano.
{% endhint %}

### **Preparando los datos de su directorio**

SCIM transmite lo que contenga la fuente. No valida, normaliza ni corrige. Antes de asignar cualquier atributo, confirme tres cosas sobre la fuente prevista:

* **Se completa para todos los usuarios incluidos en el ámbito.** Un campo sin completar no envía nada o envía el valor predeterminado configurado.
* **Sus valores mantienen un formato y uso de mayúsculas y minúsculas coherentes.** La lógica de comparación en ambos proveedores de identidad es exacta.
* **Sus valores coinciden exactamente con los valores esperados por Zoom.** Zoom no realiza coincidencias aproximadas con los nombres de sitios, roles ni valores de planes.

Cuando un campo existente no puede cumplir las tres condiciones, un atributo diseñado deliberadamente para esta Integraciones es más sostenible que reutilizar un campo en el que también escriben otros sistemas.

{% hint style="info" %}
**Recomendación**

Decida la fuente de verdad antes de tocar la configuración del proveedor de identidad. La mayoría de las implementaciones SCIM fallidas son problemas de datos del directorio presentados como problemas de aprovisionamiento.
{% endhint %}

### **Escenarios de referencia**

Se utilizan cuatro escenarios a lo largo de esta guía. Sus requisitos Comerciales y los prerrequisitos del lado de Zoom son idénticos independientemente del proveedor de identidad, por lo que se definen aquí una sola vez. Cada sección específica del proveedor de identidad termina mostrando cómo implementar los cuatro en esa plataforma.

#### <mark style="color:azul;">Escenario 0: Departamento, como un primer mapeo Básico</mark>

El departamento de un usuario debería aparecer en su perfil de Zoom, procedente del directorio. Este es el mapeo Básico recomendado anteriormente como una primera prueba de extremo a extremo, e incluye aquí para que el procedimiento se realice en ambas secciones del proveedor de identidad.

**Requisito previo de Zoom.** Ninguno. Zoom almacena el valor exactamente como se envía y nunca lo valida frente a un objeto existente.

**Atributo.** Ten en cuenta que el elemento principal difiere de los tres escenarios siguientes — `department` se encuentra en la extensión Empresarial, no en la extensión de Zoom.

| Atributo                                                                | Escribe | Notas                                                                                                                                                              |
| ----------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | cadena  | Texto libre. Ambos proveedores de identidad ya incluyen un campo `department`  en el perfil del usuario, por lo que no hace falta ningún atributo de origen nuevo. |

**Por qué empezar aquí.** Que el valor del departamento aparezca correctamente en un perfil de Zoom demuestra que la declaración del esquema, la asignación, el ámbito y tu capacidad para leer los registros de aprovisionamiento funcionan, sin poner en riesgo una licencia ni la configuración de telefonía. Todos los escenarios avanzados que aparecen a continuación solo difieren en el destino al que apunta el atributo.

**Comprueba primero si ya está asignado.** Las asignaciones predeterminadas varían entre Entra ID y Okta, y cambian cuando ambos proveedores actualizan sus integraciones con Zoom. Revisa la lista existente en **Aprovisionamiento** → **Asignaciones** en Entra, o **Asignaciones de atributos de Zoom** con **Mostrar atributos sin asignar** activado en Okta. Si `department` ya está asignado, verifique la asignación en lugar de crear un duplicado; y, si prefiere empezar desde cero, Configure un atributo como `costCenter`, `Organización`, y `employeeNumber` se encuentran bajo el mismo elemento principal y funcionan de forma idéntica.

#### <mark style="color:azul;">Escenario 1: sitio de Zoom Phone y asignación automática de número de extensión</mark>

Los usuarios deben colocarse en el sitio correcto de Zoom Phone según su oficina y recibir un número de extensión sin intervención administrativa.

**Requisito previo en Zoom** Los sitios deben existir previamente. Créelos en [**Centro de administración**](https://zoom.com/account) → **Configuración del producto** → **sistema de telefonía** → [**Información de la empresa**](https://zoom.com/pbx/page/telephone/settings#/settings) → **Añadir sitio**, o de forma masiva mediante **Importar**. Las direcciones del sitio se validan con una base de datos de direcciones reales porque permiten los servicios de llamada de emergencia, por lo que las combinaciones ficticias de direcciones y códigos postales no superarán la validación.

**Atributos.** Ambos utilizan el espacio de nombres `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` seguido del nombre.

| Atributo             | Escribe | Notas                                                                |
| -------------------- | ------- | -------------------------------------------------------------------- |
| `zoomPhoneSite`      | cadena  | Debe coincidir con el nombre del sitio de Zoom carácter por carácter |
| `zoomPhoneExtNumber` | cadena  | `0` activa la asignación automática                                  |

**Por qué importa el valor `0` importa.** Zoom es el único sistema que sabe qué extensiones ya están en uso, incluidas las asignadas a colas de llamadas y recepcionistas automáticas en lugar de a usuarios. Delegar la asignación a Zoom elimina toda una categoría de errores de aprovisionamiento. Obtener las extensiones del directorio en su lugar es adecuado durante una migración, cuando es importante conservar los números de extensión existentes, pero la asignación debería cambiar a `0` una vez completada la migración, para que los futuros miembros no dependan de que los datos del directorio se mantengan indefinidamente.

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

El sitio predeterminado de una cuenta de Zoom Phone suele llamarse exactamente `Sitio principal`, visible en [**Centro de administración**](https://zoom.com/account) → **Configuración del producto** → **sistema de telefonía** → [**Información de la empresa**](https://zoom.com/pbx/page/telephone/settings#/settings). Confirma el nombre de la cuenta específica antes de basarte en él, ya que puede cambiarse.
{% endhint %}

#### <mark style="color:azul;">Escenario 2: plan de llamadas de Zoom Phone que varía según el país</mark>

Una Organización multinacional ha comprado planes de llamadas independientes de Zoom Phone y necesita que cada usuario reciba el plan que coincida con su país.

**Requisito previo de Zoom.** Los planes de llamadas ya deben haberse comprado y estar disponibles en la cuenta. Los valores de los planes se documentan en la [Referencia de planes de llamadas de Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**Atributo.** `zoomPhoneCallingPlan` (cadena).

**Cómo obtener el código de plan correcto.** `zoomPhoneCallingPlan` acepta el código numérico del plan, no el nombre del plan. La forma más fiable de obtenerlo es la [Listar planes de llamadas](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API, que devuelve los de cada plan `name`, su `tipo` — el código que asignas — y su `subscribed` y `Disponible` recuentos de licencias. Por lo tanto, una llamada confirma que el plan existe, te proporciona el valor que debes enviar y verifica que haya capacidad para asignarlo.

El portal web de Zoom solo muestra nombres visibles, nunca códigos, así que un administrador que trabaje únicamente desde el portal debe traducir el nombre visible usando la [referencia de planes de llamadas de Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — donde, por ejemplo, `UNLIMITED_PLAN_US_CA` es `200` y `UNLIMITED_PLAN_GB_IE` es `202`. La referencia enumera nombres de constantes en lugar de la terminología del portal, así que confirma la correspondencia según las características del plan —región y si tiene medición por uso o es ilimitado—, no según el texto exacto.

Por separado, la referencia de la API SCIM2 de Zoom muestra un nombre de plan de facturación como `phone_calling_usca_monthly_unlimited` en su carga útil de ejemplo. Ese identificador se usa para *comprar* una suscripción, no para asignar un plan a un usuario. Si necesitas especificar de qué suscripción se nutre un plan, eso debe indicarse en `zoomPhoneCallingPlanSubscription`.

**Por qué `-1` se usa como alternativa predeterminada.** La referencia de SCIM2 documenta `-1` como el valor que elimina todos los planes de llamadas. Usarlo para los usuarios que no coinciden produce un resultado determinista y visible —no se asigna ningún plan—, en lugar de la ambigüedad que supone no enviar ningún valor. También ofrece una forma clara de retirar los derechos de llamadas sin eliminar al usuario.

#### <mark style="color:azul;">Escenario 3: Paquete de Zoom centro de contacto, Rol, función y región</mark>

Los agentes del centro de contacto deben aprovisionarse con el Paquete ZCC correcto y el Rol, función en el momento de la Incorporación, en lugar de configurarse manualmente después. Este escenario demuestra que el método es agnóstico al producto — no cambia nada del procedimiento, solo los nombres de los atributos y los valores permitidos.

| Atributo                   | Escribe | Valores permitidos                                                                          |
| -------------------------- | ------- | ------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage` | cadena  | `Essentials`, `Premium`, `Elite`                                                            |
| `zoomContactCenterRole`    | cadena  | Cualquier nombre de rol de ZCC. El valor predeterminado es `Agent` si se omite.             |
| `zoomContactCenterRegion`  | cadena  | Cualquier región de ZCC configurada. Valor predeterminado: la región principal si se omite. |

**Sobre la omisión deliberada de atributos.** Salir `zoomContactCenterRegion` sin asignar en implementaciones de una sola región, donde el valor predeterminado documentado por Zoom ya es correcto. Es preferible omitir un atributo cuyo valor predeterminado es adecuado en vez de asignarlo: cada asignación implica una obligación de mantenimiento.

**Nota operativa.** La referencia de SCIM2 también documenta `zoomContactCenterUserTemplate`, que aplica una plantilla de ZCC prediseñada. Las plantillas de tipo de adición se aplican al crear un usuario y las de tipo de actualización, al actualizarlo; cuando en una misma solicitud se proporcionan tanto una plantilla como valores de atributos individuales, prevalecen los valores individuales. Conviene considerar el uso de plantillas cuando la configuración de ZCC es lo bastante compleja como para que mantenerla mediante muchas asignaciones de atributos individuales resulte difícil de gestionar.

### **Verificación del lado de Zoom y errores comunes**

Cada proveedor de identidad tiene su propio registro, cubierto en el paso 6 de cada proveedor de identidad. El registro del lado de Zoom a continuación es idéntico para ambos y es el grabar definitivo de lo que Zoom realmente recibió.

#### <mark style="color:azul;">Los registros de llamada de Zoom App Marketplace Mostrar el intercambio completo de solicitudes y respuestas</mark>

1. Iniciar sesión en el portal web de Zoom como el propietario de cuenta.
2. Ve a la [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Administrar** → **Aplicaciones de la cuenta**.
3. Seleccione la aplicación que representa la conexión del proveedor de identidad. Para Entra, normalmente se denomina **Identidad de Azure** o similar.
4. Abra la **pestaña Registros de llamadas** .
5. Use **Buscar por punto de conexión**, o los filtros de intervalo de fechas, método y estado, para localizar la llamada pertinente.
6. Seleccione la fila para expandirla.
7. Revise `requestBody` para ver exactamente qué se envió, y `response` para ver exactamente qué devolvió Zoom, incluido el ID de usuario de Zoom generado, `httpStatus`, y el conjunto de atributos resultante.

Zoom conserva los 100 registros de solicitudes de API más recientes, por lo que investigue un fallo de inmediato en lugar de hacerlo después de que otra actividad de aprovisionamiento lo haya desplazado.

#### <mark style="color:azul;">Errores comunes de aprovisionamiento y sus causas</mark>

<table><thead><tr><th width="99.69622802734375">Código</th><th>Mensaje</th><th>Causa y resolución</th></tr></thead><tbody><tr><td>400</td><td>La cuenta no ha Habilitar Inicio de sesión único.</td><td>SSO es un requisito previo para SCIM. Habilitar y Configure SSO en la cuenta de Zoom primero.</td></tr><tr><td>400</td><td>El usuario está inactivo o bloqueado.</td><td>El usuario de destino de Zoom no se puede actualizar en su estado actual. Resuelva el estado de la cuenta en el portal web de Zoom.</td></tr><tr><td>403</td><td>La solicitud fue denegada debido a permisos insuficientes: "usuario:Editar".</td><td>Las credenciales detrás de la conexión SCIM carecen del ámbito requerido. Vuelva a autorizar la conexión con una cuenta de Propietario o de administrador.</td></tr><tr><td>404</td><td>El usuario no existe.</td><td>El proveedor de identidad no correlacionó al usuario con un usuario de Zoom existente. Verifique el atributo de coincidencia y el formato del Nombre de usuario.</td></tr><tr><td>409</td><td>El dominio del correo electrónico no coincide con el dominio asociado de la cuenta.</td><td>El dominio del correo electrónico del usuario no está asociado con la cuenta de Zoom. Asocie y verifique el dominio antes del aprovisionamiento.</td></tr><tr><td>409</td><td>No se pueden Añadir usuarios de pago.</td><td>No hay ninguna licencia del tipo solicitado. La capacidad libre en la cuenta está Disponible, o aprovisione al usuario como Básico.</td></tr><tr><td>409</td><td>No se pueden crear más usuarios con [nombre del paquete].</td><td>El paquete específico no tiene plazas restantes. Se aplica a Workplace Comercial Plus, Empresarial Premier, Pro Plus y los equivalentes de Educación.</td></tr><tr><td>429</td><td>Demasiadas solicitudes.</td><td>El aprovisionamiento ha superado los límites de tasa de Zoom. Investigue si persiste entre ciclos.</td></tr></tbody></table>

#### <mark style="color:azul;">Un modo de fallo no produce ningún error en absoluto</mark>

Un valor que Zoom acepta pero que no corresponde a nada — un nombre de sitio con un espacio final, o un nombre de Rol, función renombrado desde entonces en Zoom — puede aceptarse sintácticamente y no aplicarse a nada. Ninguna entrada de registro señala esta ocurrencia. Las variantes específicas de la plataforma del mismo problema se cubren en el Paso 6.

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

Cuando Zoom y el proveedor de identidades no están de acuerdo sobre la configuración de un usuario, trate al proveedor de identidades como la autoridad y corrija allí el valor. Editar directamente en el portal web de Zoom produce un estado que el siguiente Evento de aprovisionamiento sobrescribe, lo que hace que el problema subyacente sea más difícil de diagnosticar.
{% endhint %}

## **Configuración de SCIM con Entra ID**

#### <mark style="color:azul;">Requisitos adicionales para Entra ID</mark>

* Privilegios de administrador de Entra ID con Acceso a Aplicaciones Empresariales
* El dominio de correo electrónico usado por sus usuarios verificado como dominio personalizado en el tenant de Entra ID

#### <mark style="color:azul;">Limitaciones adicionales en Entra ID</mark>

* Las asignaciones de atributos se obtienen exclusivamente de los *atributos del objeto de usuario* de Entra. Los grupos de seguridad no pueden proporcionar directamente un valor a un atributo de Zoom; la pertenencia a un grupo controla el ámbito, no el valor.
* Los ciclos de aprovisionamiento incremental se ejecutan aproximadamente cada 40 minutos. Los cambios no son instantáneos una vez que se habilita el aprovisionamiento.
* El valor `Collaboration` de `userType` no es compatible con Entra ID debido a una limitación específica de Microsoft.

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

La configuración del aprovisionamiento estándar se puede realizar desde `entra.microsoft.com` o desde `portal.azure.com`. Sin embargo, solo se puede acceder al editor de esquemas del paso 1 mediante la URL de Azure Portal con el parámetro `forceSchemaEditorEnabled` añadido. Esta marca no tiene efecto en `entra.microsoft.com`. Use el enlace de Azure Portal del paso 1 para todos los pasos de esta sección y evitar cambiar de portal a mitad de la configuración.
{% endhint %}

### Paso 1: Declare el atributo en el esquema de la aplicación Zoom

Declarar un atributo es una acción única por atributo. Declare cada atributo que tenga intención de usar antes de configurar cualquier asignación, para que todos los destinos estén Disponibles en el Paso 2.

1. Inicie sesión en Azure Portal mediante la URL del editor de esquemas: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. En **Servicios de Azure**, seleccione **Microsoft Entra ID**.
3. En el menú de navegación de la izquierda, en **Administrar**, haga clic en **Aplicaciones empresariales**.
4. En la lista de aplicaciones, haga clic en su aplicación de Zoom.\
   **Nota**: El nombre de la aplicación lo define el administrador de Entra cuando se crea la aplicación. A menudo se denomina **Zoom** o **Zoom SSO**, pero puede variar en su tenant.
5. En el menú de navegación de la izquierda, en **Administrar**, haga clic en **Aprovisionamiento**.\
   **Nota**: Actualmente, Azure presenta uno de dos diseños. En la experiencia anterior, seleccione **Editar asignaciones de atributos** en **Administrar aprovisionamiento**. En la experiencia más reciente, la página se abre en la pestaña **Información general** ; seleccione **Aprovisionamiento** de nuevo en el menú de la izquierda. Ambas rutas conducen al mismo destino.
6. Haz clic en el **Asignaciones** menú desplegable y, a continuación, haz clic **Provisionar usuarios de Microsoft Entra ID**.\
   **Nota**: En los tenants que aún muestran la nomenclatura heredada, esta opción aparece como **Aprovisionar usuarios de Active Directory de Azure**.
7. En la esquina inferior izquierda, Seleccione **Mostrar opciones avanzadas** casilla de verificación.
8. Haz clic **Editar la lista de atributos de Zoom**.
9. Desplácese hasta la primera fila vacía y complete lo siguiente:
   * **Nombre**: Introduce la cadena completa del atributo, por ejemplo `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Tipo**: Seleccione **Cadena** o **Booleano**, que coincide con el tipo de datos documentado en la referencia de la API de SCIM2.
10. Repita el paso 9 para cada atributo adicional.
11. En la esquina superior izquierda, haz clic en **Guardar**.

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

Los nombres de los atributos distinguen entre mayúsculas y minúsculas y deben coincidir exactamente con los de la referencia de la API. `zoomPhoneSite` es válido; `zoomphonesite` y `ZoomPhoneSite` no lo son. El editor de esquemas acepta un atributo con mayúsculas y minúsculas incorrectas sin mostrar ningún error, pero la solicitud falla silenciosamente en la API de Zoom.

Para los atributos documentados como `boolean`, **String** también es válido si la fuente asignada proporciona el texto literal `true` o `false`. Seleccionar **String** suele ser más práctico cuando la fuente es un atributo de extensión de Entra, que almacena texto.
{% endhint %}

### Paso 2: Asignar una fuente de directorio al atributo

Entra ID ofrece tres tipos de asignación, y la elección entre ellos es la decisión más importante en la configuración.

<table><thead><tr><th width="133.376708984375">Tipo de asignación</th><th>Cuándo usar</th><th>Comportamiento</th></tr></thead><tbody><tr><td><strong>Directa</strong></td><td>Un campo de Entra ya contiene el valor exacto que Zoom espera.</td><td>Pasa el valor de origen sin cambios.</td></tr><tr><td><strong>Constante</strong></td><td>Cada usuario dentro del ámbito debe recibir el mismo valor.</td><td>Envía un valor fijo a cada usuario aprovisionado.</td></tr><tr><td><strong>Expresión</strong></td><td>El valor debe derivarse, traducirse o variar según el atributo del usuario.</td><td>Evalúa una expresión sobre los campos de origen y envía el resultado.</td></tr></tbody></table>

**Para crear la asignación:**

1. Volver a **Aprovisionamiento** → **Asignaciones** → **Aprovisionar usuarios de Microsoft Entra ID**.
2. En la esquina inferior izquierda, haga clic en **Añadir nueva asignación**.
3. Configure la asignación según el tipo seleccionado — consulte la guía a continuación.
4. Haga clic en el **Atributo de destino** desplegable y seleccione el atributo declarado en el paso 1.
5. Haga clic en el **Empareja los objetos usando este atributo** menú desplegable y Seleccione **No**.\
   **Nota**: Los atributos personalizados de Zoom son valores de configuración, no claves de coincidencia de identidad. Solo el atributo que relaciona a los usuarios de Entra con los usuarios de Zoom —normalmente `Nombre de usuario` — debe establecerse en **Sí**.
6. Haz clic en el **Aplicar esta asignación** menú desplegable y selector **Siempre**, de modo que el valor se aplique tanto al crear como en las actualizaciones posteriores.
7. Haga clic en **Aceptar**.
8. Repita el proceso para cada atributo y, luego, haga clic en **Guardar** en la parte superior de la página **Asignación de atributos** .

#### <mark style="color:azul;">La asignación directa pasa un campo existente sin transformación</mark>

* **Tipo de asignación**: **Directa**
* **Atributo de origen**: Un campo de Entra cuyo valor ya coincide exactamente con lo que espera Zoom
* **Valor predeterminado si es nulo (opcional)**: Un valor alternativo que se aplica cuando el campo de origen está vacío

La asignación directa es la opción menos propensa a errores y debería preferirse siempre que los datos del directorio lo permitan. Si `physicalDeliveryOfficeName` — aparece como **Ubicación de la oficina** en el perfil de usuario de Entra — ya contiene valores que coinciden exactamente con los nombres de los sitios de Zoom Phone, por lo que asignarlos directamente no requiere ninguna lógica.

{% hint style="info" icon="lightbulb" %}
**Consejo**

Rellenar **Valor predeterminado si es nulo** siempre que la ausencia de un valor de origen pueda provocar un error o un resultado no deseado. Un valor predeterminado de `Sitio principal` La asignación a un sitio garantiza que los usuarios sin una ubicación de oficina se aprovisionen correctamente, en lugar de quedar en un estado indefinido.
{% endhint %}

#### <mark style="color:azul;">El mapeo constante aplica un valor a toda la población dentro del ámbito</mark>

* **Tipo de asignación**: **Constante**
* **Valor constante**: El valor fijo que se debe enviar

La asignación de constantes es adecuada para implementaciones con una sola configuración y también es el mecanismo detrás de varios comportamientos específicos de Zoom. Al establecer `zoomPhoneExtNumber` en una constante de `0` se indica a Zoom que Asignar la siguiente extensión Disponible dentro del sitio del usuario, lo que elimina por completo las colisiones de extensiones.

#### <mark style="color:azul;">El mapeo de expresiones traduce o deriva un valor en el momento del aprovisionamiento</mark>

* **Tipo de asignación**: **Expresión**
* **Expresión**: una instrucción anidada de `IIF()` que evalúa uno o más atributos de origen

El mapeo de expresiones es necesario cuando el valor del directorio y el valor de Zoom no son la misma cadena:

```
IIF([officeLocation]="London","LON-01",
IIF([officeLocation]="Manchester","MAN-01",
"Sitio principal"))
```

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

Las expresiones comparan el texto exactamente tal como está escrito, incluida la distinción entre mayúsculas y minúsculas. `GB` y `gb` son valores diferentes, al igual que `United Kingdom` y `united kingdom`. Si una comparación no coincide, no se genera ningún error: se pasa a la rama predeterminada y se aprovisiona al usuario con una configuración incorrecta sin avisar.
{% endhint %}

Rodee los valores de origen con `ToUpper()` y compare con literales en mayúsculas para neutralizar las inconsistencias en el uso de mayúsculas y minúsculas:

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="REINO UNIDO","202",
"-1"))
```

#### <mark style="color:azul;">El formato del campo de origen varía según cómo se creó el usuario de Entra</mark>

Esta es la causa más común de los mapeos de expresiones que parecen correctos pero se comportan de forma inconsistente en una población.

* **Ubicación de uso** Microsoft exige que siempre contenga un código ISO 3166-1 alfa-2 válido, como `GB`, porque determina la disponibilidad de licencias y características. Este campo es fiable.
* **País o región** no está sujeto a este requisito y su contenido depende del método de creación. Los usuarios creados mediante la interfaz gráfica del portal del administrador de Entra seleccionan un nombre de país completo en un menú desplegable, por lo que el campo suele almacenar `United Kingdom`. Los usuarios creados mediante la importación de CSV o PowerShell suelen tener el valor `GB` ; es una convención, no un requisito.

En cualquier inquilino donde se hayan creado usuarios mediante más de un método, `country` no tendrá un formato uniforme. Estandarice el campo antes de crear la expresión o compruebe explícitamente ambos formatos, como se muestra arriba.

### Paso 3: Introduzca usuarios y grupos en el ámbito de aprovisionamiento

La asignación determina qué usuarios afecta la configuración. Los usuarios fuera del ámbito de asignación de la aplicación no se ven afectados por ningún mapeo, lo que convierte la asignación en el principal control de seguridad durante el despliegue.

1. Vaya a **Microsoft Entra ID** → **Aplicaciones empresariales** → su aplicación de Zoom → **Usuarios y grupos**.
2. Haga clic en **Añadir usuario o grupo**.
3. En **Usuarios y grupos**, seleccione el usuario o grupo de seguridad que corresponda.
4. En **Seleccione un rol**, seleccione el rol adecuado.
5. Haga clic en **Asignar**.

En la práctica, solo importan dos valores de Rol, función. Otras opciones, como **Corp** y **Pro** son denominaciones antiguas que están desapareciendo o están destinadas a situaciones poco frecuentes.

<table><thead><tr><th width="157.5225830078125">Rol, función</th><th>Efecto</th></tr></thead><tbody><tr><td><strong>Básico</strong></td><td>Aprovisiona al usuario sin una licencia de reunión de pago. Seleccione esta opción cuando un atributo personalizado —como un plan de llamadas de Zoom Phone— sea responsable de asignar el derecho de pago.</td></tr><tr><td><strong>Con licencia</strong></td><td>Asigna el plan de licencia <em>predeterminado</em> de la cuenta de Zoom, por ejemplo, Zoom Workplace Empresarial Plus. Esta pantalla no permite elegir un paquete específico; el plan predeterminado se configura en Zoom.</td></tr></tbody></table>

Esta selección de Rol, función se aplica una vez por cada usuario o grupo añadido a la aplicación, independientemente de cuántos atributos personalizados se estén aprovisionando.

**Para aprovisionar grupos de Entra como grupos de Zoom**, algo que está desactivado de modo predeterminado:

1. Vaya a **Aprovisionamiento** → **Asignaciones** y Seleccione **Aprovisionar grupos de Microsoft Entra ID**.
2. Cambie **Habilitado** a **Sí**.
3. Confirme que las asignaciones predeterminadas están configuradas: `displayName` → `displayName`, y `members` → `members`.
4. Haz clic en **Guardar**.
5. Vuelva a **Usuarios y grupos** y confirme que el propio grupo está asignado a la aplicación, no solo sus miembros individuales. El aprovisionamiento de grupos solo procesa los grupos asignados directamente.

{% hint style="warning" %}
**Aviso: lo que SCIM hace y no hace con los grupos**

Si aún no existe un grupo de Zoom con un nombre coincidente, SCIM crea uno utilizando el `displayName` del grupo de Entra exactamente como se ha escrito. El grupo se crea con miembros, pero **sin ninguna configuración de producto**. Un administrador aún debe abrir [**Centro de administración**](https://zoom.com/account) → **Usuarios** → [**Grupos**](https://zoom.com/account/group#/) en el portal web de Zoom y aplicar la Configuración deseada: políticas de Zoom Phone a nivel de grupo, permisos de llamada u otra configuración de producto. SCIM aprovisiona el grupo y sus miembros; no define lo que hace ese grupo dentro de Zoom.
{% endhint %}

### Paso 4: Validar con Aprovisionamiento a petición

**Aprovisionar a petición** se ejecuta independientemente del **Estado de aprovisionamiento** , que se controla mediante un interruptor. Precisamente por eso es la herramienta adecuada para la validación. Todos los pasos hasta este punto, incluido este, se pueden completar mientras el aprovisionamiento permanece desactivado.

1. Vaya a **Aprovisionamiento** → **Información general del aprovisionamiento**.
2. Haga clic en **Aprovisionar a petición**.
3. Busque y seleccione un único usuario de prueba y, a continuación, haga clic en **Aprovisionar**.
4. Revisa el resultado. Entra informa de las cuatro etapas que ejecuta para cada evento de aprovisionamiento: — **Importar**, **Determinar si está dentro del ámbito**, **Emparejar**, y **Aprovisionar** — cada una se puede expandir por separado.
5. Confirme que los valores de atributo mostrados coincidan con lo previsto.
6. Iniciar sesión en el portal web de Zoom y confirme que se aplicó la configuración.

{% hint style="info" %}
**Recomendación**

Valida con un usuario que represente el caso más *difícil* de tu población: un usuario en el extranjero, uno creado mediante un método diferente o uno cuyo campo de origen esté vacío. Una prueba que solo cubra el caso sencillo no revelará los modos de fallo descritos en el paso 2.
{% endhint %}

### Paso 5: Habilitar el aprovisionamiento continuo

Habilitar el aprovisionamiento activa la configuración para cada usuario dentro del ámbito. Complete y verifique primero los pasos del 1 al 4.

1. Ve a **Microsoft Entra ID** → **Aplicaciones empresariales** → tu aplicación de Zoom → **Aprovisionamiento** → **Aprovisionamiento**.
2. Alternar **Estado del aprovisionamiento** a **Activado**.
3. Haz clic en **Guardar**.

El primer ciclo puede tardar aproximadamente hasta 40 minutos. Los ciclos incrementales posteriores se ejecutan en intervalos de aproximadamente 40 minutos. Las nuevas incorporaciones, los cambios de atributos y las desactivaciones se sincronizan según esa programación, en lugar de hacerlo inmediatamente.

### Paso 6: Verificar mediante los registros de aprovisionamiento de Entra

1. Vaya a **Microsoft Entra ID** → **Aplicaciones empresariales** → su aplicación de Zoom → **Supervisión** → **Registros de aprovisionamiento**.
2. Busque o filtre el usuario de prueba y, a continuación, seleccione el evento correspondiente. La vista de detalles se abre con cuatro pestañas: **Pasos**, **Solución de problemas y recomendaciones**, **Propiedades modificadas**, y **Resumen**.
3. Revisa el **Resumen** para confirmar si la acción se realizó correctamente o falló.
4. Si falló, abre **Solución de problemas y recomendaciones**, que muestra la acción intentada, el nombre principal de usuario afectado y —en **Detalles** — el código de error y el mensaje de error completo devueltos por la API de Zoom.

Esto es más fiable que inspeccionar la pantalla de asignación, ya que muestra los valores literales transmitidos en lugar de lo que se pretendía que produjera la asignación. Cuando el registro de Entra no sea concluyente, consulta los registros de llamadas de Zoom App Marketplace descritos en **Verificación de Zoom y errores comunes**, que muestran el intercambio sin procesar de la solicitud y la respuesta.

#### <mark style="color:azul;">Comportamiento de Incorporación y desincorporación en Entra ID</mark>

* El ámbito es el control de seguridad principal. Los usuarios fuera del ámbito de asignación de la aplicación nunca son modificados por ningún mapeo en esta configuración.
* Desactivar a un usuario en Entra, o eliminarlo del ámbito, revierte el aprovisionamiento automáticamente y cierra el ciclo de baja.
* Cada fallo produce una entrada de registro correspondiente — con la salvedad del fallo silencioso mencionada arriba.

### Paso 7: Aplicar los escenarios de referencia en Entra ID

Los escenarios, los requisitos previos y las definiciones de atributos se encuentran en el [**Escenarios de referencia**](#reference-scenarios) sección. Aquí solo se indican las asignaciones de Entra.

**Escenario 0 — Departamento.** En el paso 1, declara `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` como **Cadena**, teniendo cuidado de usar el espacio de nombres empresarial en lugar del de Zoom. Asígnalo como **Directo** de Entra `department` campo. No se necesita **Valor predeterminado si es nulo** : si el campo de origen está vacío, simplemente no se envía nada y no es necesario que exista ningún objeto en Zoom.

**Escenario 1: sitio de Zoom Phone y extensión automática.** Asignar `zoomPhoneSite` como **Directo** desde `physicalDeliveryOfficeName`, con **Valor predeterminado si es nulo** establecido en `Main sitio`. Asignar `zoomPhoneExtNumber` como **Constante** con un valor de `0` a menos que esté migrando una configuración de extensiones existente. Si los valores de ubicación de la oficina no coinciden exactamente con los nombres de los sitios de Zoom, sustituya un **Expresión** mapeo con el formato mostrado en el paso 2.

**Escenario 2 — Plan de llamadas variable según el país.** Como Entra no puede obtener un valor de un grupo, se requiere una expresión. Amplíela con más `IIF()` capas por país, y tenga en cuenta tanto los formatos alfa-2 como los de texto completo, tal como se describe en el paso 2:

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="REINO UNIDO","202",
IIF(ToUpper([country])="US","200",
IIF(ToUpper([country])="UNITED STATES","200",
"-1"))))
```

Cuando el atributo del plan de llamadas asigna el derecho de pago, seleccione **Básico** en lugar de **Con licencia** en el paso 3. Seleccionar **Con licencia** también aplica la licencia predeterminada de la cuenta, lo que quizá no dé el resultado comercial previsto.

**Escenario 3 — Paquete del centro de contacto, función y región.** Asigne `zoomContactCenterPackage` con una **expresión** controlada por un campo de directorio que distingue los niveles de agente, y `zoomContactCenterRole` como **Directo** a partir de un campo que contiene el nombre del rol. Salir `zoomContactCenterRegion` sin asignar en implementaciones de una sola región.

## **Configurando SCIM con Okta**

#### <mark style="color:azul;">Requisitos adicionales para Okta</mark>

* Privilegios de administrador de Okta con Acceso al Editor de perfiles

#### <mark style="color:azul;">Limitaciones adicionales en Okta</mark>

* Cuando un usuario pertenece a varios grupos que proporcionan valores conflictivos para el mismo atributo, solo se transmite el valor del grupo de mayor prioridad. Consulte el Paso 5.

{% hint style="warning" %}
**Atención: Dos perfiles, dos propósitos**

Okta mantiene dos perfiles distintos relevantes en este caso, y comprender la diferencia evita la mayoría de las confusiones iniciales. El **perfil de usuario de Okta** es donde se almacena un valor *almacenado* para una persona del directorio. El **perfil de aplicación de usuario de Zoom** es donde se almacena un valor *enviado* a Zoom, y sus atributos contienen el nombre externo y el espacio de nombres de SCIM. Una configuración por usuario necesita ambos, además de una asignación que los conecte. Una configuración a nivel de grupo solo necesita el atributo del perfil de aplicación, con el valor establecido en la asignación del grupo.
{% endhint %}

### Paso 1: Declare el atributo en el perfil de usuario de la aplicación Zoom

Este es el atributo que realmente transmite un valor a Zoom. Declararlo es una acción única por atributo.

1. Iniciar sesión en la Consola del administrador de Okta.
2. En el menú de navegación de la izquierda, haz clic en **Aplicaciones**, y luego haz clic en **Aplicaciones**.
3. En **ESTADO**, haz clic en **ACTIVO**.
4. Haz clic en **Zoom** aplicación.\
   **Nota**: El administrador de Okta define el nombre de la aplicación al crearla. A menudo se llama **Zoom**, pero puede ser distinto en tu organización.
5. Haz clic en la **pestaña de aprovisionamiento** .
6. En **Asignaciones de atributos de Zoom**, haz clic en **Ir al editor de perfiles**.
7. En **Atributos**, haz clic en **+ Añadir atributo**.
8. Complete lo siguiente:
   * **Tipo de datos**: Seleccione **string** o **boolean**, de acuerdo con la referencia de la API SCIM2.
   * **Nombre para mostrar**: Introducir el nombre del atributo, por ejemplo `zoomPhoneSite`.
   * **Nombre de la variable**: Introducir el mismo nombre.
   * **Nombre externo**: Introduce el nombre del atributo exactamente como lo documenta Zoom, por ejemplo `zoomPhoneSite`.
   * **Espacio de nombres externo**: Introducir `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Descripción** (Opcional): Registra por qué existe el atributo y de dónde provienen sus valores.
   * **Tipo de atributo**: Seleccione **Personal** para un valor por usuario, o **grupo** para un valor heredado mediante la pertenencia a un grupo.
9. Haga clic en **Guardar**, o **Guardar y añadir otro**.

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

El nombre externo y el espacio de nombres externo deben ser correctos. La guía publicada de Zoom especifica que el espacio de nombres externo debe ser el URN completo *incluido* el nombre del atributo; por ejemplo `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — en lugar de usar solo el espacio de nombres. Esto difiere de la convención SCIM genérica. Sigue el formato que se muestra arriba, ya que refleja la configuración que Zoom documenta como funcional.

Los nombres de atributo distinguen entre mayúsculas y minúsculas en todo momento. Un atributo con uso incorrecto de mayúsculas y minúsculas es aceptado por el Editor de perfiles sin error y falla silenciosamente en la API de Zoom.
{% endhint %}

### Paso 2: Cree un atributo de origen en el perfil de usuario de Okta

Complete este paso cuando el valor se mantenga por usuario. Omítalo si el valor es idéntico para cada usuario, o si se proporcionará en su lugar a nivel de grupo.

1. En el menú de navegación de la izquierda, haz clic en **Directorio**, luego haz clic **Editor de perfiles**.
2. Haz clic en el **Usuarios** pestaña.
3. En el **Usuarios** cuadro, en **Filtros**, haz clic en **Todos**.
4. A la derecha de **Okta**, haz clic en el **Usuario** perfil.
5. En **Atributos**, haz clic en **+ Añadir atributo**.
6. Complete lo siguiente:
   * **Tipo de datos**: Haz coincidir el atributo de Zoom declarado en el paso 1.
   * **Nombre para mostrar** y **Nombre de variable**: Introduce un nombre, por ejemplo `zoomPhoneSite`.
   * **Enumeración** (Opcional): Seleccione **Defina una lista enumerada de valores** donde el atributo Zoom solo acepta un conjunto fijo de valores.
   * **Atributo obligatorio** (Opcional): Seleccione **Sí** donde cada usuario dentro del ámbito debe tener un valor.
7. Haz clic en **Guardar**.

{% hint style="info" icon="lightbulb" %}
**Consejo**

Use el mismo nombre para el atributo de perfil de usuario de Okta y el atributo de perfil de aplicación de Zoom. Okta no requiere esto, pero que los nombres coincidan hace que la lista de mapeo sea autoexplicativa y reduce considerablemente el tiempo de resolución de problemas a medida que aumenta el número de atributos.
{% endhint %}

Use la **Enumeración** opción siempre que Zoom documente un conjunto fijo de valores: paquetes del centro de contacto, códigos de paquetes de Workplace y valores de planes de Revenue Accelerator. Restringir el campo en el momento de introducir los datos evita que un error tipográfico provoque un fallo de aprovisionamiento silencioso que se manifieste semanas después como un derecho de acceso ausente.

### Paso 3: Asigne el atributo de origen al atributo de Zoom

1. Ve a **Aplicaciones** → **Aplicaciones** → **activo** → la aplicación de **Zoom** .
2. Haz clic en la **pestaña de aprovisionamiento** .
3. En **Asignaciones de atributos de Zoom**, localice el atributo declarado en el paso 1 y haga clic en el icono de edición situado a su derecha.\
   **Nota**: Si el atributo no está visible, haga clic en **Mostrar atributos sin asignar**.
4. Haga clic en **Valor del atributo** y seleccione **Asignar desde el perfil de Okta**.
5. Haga clic en el menú desplegable de origen, que muestra `login | string` de forma predeterminada y seleccione el atributo del perfil de usuario de Okta creado en el paso 2.
6. Seleccione **Crear y actualizar**.\
   **Nota**: **Crear solo** aplica el valor cuando se aprovisiona por primera vez al usuario de Zoom y nunca más. Selecciónelo deliberadamente para los valores que no deban sobrescribirse después de la asignación inicial; seleccione **Crear y actualizar** en todos los demás casos para que se propaguen los cambios del directorio.
7. Haz clic en **Guardar**.
8. Repita el proceso para cada atributo.

{% hint style="warning" %}
**Atención: Derivar o traducir un valor**

Cuando el valor de Okta y el valor de Zoom no son la misma cadena, el campo **Valor del atributo** también acepta el lenguaje de expresiones de Okta, que admite lógica condicional y funciones de cadena. La sintaxis de las expresiones y las funciones disponibles varían según la versión de Okta; valide cualquier expresión con un único usuario de prueba mediante **Vista previa** antes de aplicarla de forma más amplia y consulte la documentación actual del lenguaje de expresiones de Okta para conocer las funciones admitidas.

Cuando la traducción es sencilla y el conjunto de valores es pequeño, definir el valor de Zoom directamente en el atributo de Okta como una lista enumerada, o usar un atributo de nivel de grupo, como en el paso 5, suele ser más fácil de mantener que una expresión.
{% endhint %}

### Paso 4: Habilitar el aprovisionamiento en la aplicación

Las asignaciones de atributos no tienen efecto hasta que se habiliten las operaciones de aprovisionamiento correspondientes. Habilitar antes de asignar valores en el paso 5.

1. Ve a **Aplicaciones** → **Aplicaciones** → **activo** → la aplicación de **Zoom** .
2. Haz clic en la **pestaña de aprovisionamiento** .
3. En **Aprovisionamiento en la aplicación**, haga clic en **Editar**.
4. Habilite la configuración que se describe a continuación y haga clic en **Guardar**.

| Configuración                       | Efecto                                                                                                                                                                                               |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Crear usuarios**                  | Crea o vincula un usuario en Zoom cuando la aplicación se asigna a un usuario en Okta.                                                                                                               |
| **Actualizar atributos de usuario** | Actualiza los atributos de un usuario en Zoom cuando se asigna la aplicación. Los cambios posteriores en el perfil de usuario de Okta sobrescriben automáticamente el valor correspondiente en Zoom. |
| **Desactivar usuarios**             | Desactiva la cuenta de Zoom cuando se anula la asignación de la aplicación en Okta o cuando se desactiva la cuenta de Okta. Las cuentas se pueden reactivar reasignando la aplicación.               |

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

**Actualizar atributos de usuario** es lo que hace que las asignaciones de atributos personalizados surtan efecto en los usuarios existentes. Sin esta opción, las asignaciones solo se aplican cuando se crea el usuario, y los cambios posteriores en Okta no se reflejarán en Zoom.
{% endhint %}

### Paso 5: Asignar valores a usuarios o grupos

**Para asignar un valor a un usuario individual:**

1. Ve a **Directorio** → **Personas** y haz clic en el nombre del usuario.
2. Haz clic en la **Perfil** pestaña y luego haz clic en **Editar**.
3. Complete el atributo creado en el paso 2 con el valor que Zoom espera.
4. Haz clic en **Guardar**.

El valor se transmite de inmediato. Confirme el resultado en el portal web de Zoom antes de aplicar el mismo cambio más ampliamente.

**Para asignar un valor a un grupo** — el patrón más escalable, en el que la configuración sigue la estructura de la organización:

1. Confirma que el atributo se declaró en el paso 1 con **Tipo de atributo: grupo**. Si se declaró como **Personal**, declara un equivalente a nivel de grupo repitiendo el paso 1 en el perfil **usuario de Zoom** en **Directorio** → **Editor de perfiles** → **Usuarios** → **Todos**, seleccionando **grupo** como tipo de atributo.
2. Ve a **Directorio** → **Grupos** → la pestaña **Todos** y haz clic en **Añadir grupo**.
3. Introducir un **Nombre** y, de forma Opcional, una **Descripción** y, a continuación, haz clic en **Guardar**.
4. Abre el grupo y haz clic en la pestaña **Aplicaciones** .
5. Haz clic en **Asignar aplicación** y, a continuación, haz clic en **Asignar** a la derecha de la aplicación **Zoom** .
6. Rellene los atributos a nivel de grupo con los valores que deben aplicarse a cada Miembro.
7. Haz clic en **Guardar y volver** y, a continuación, haz clic en **Listo**.
8. Haz clic en la pestaña **Personas** del grupo y, a continuación, haz clic en **Asignar personas**.
9. Busque usuarios por nombre de pila, dirección de correo electrónico principal o Nombre de usuario, y haga clic en el botón Añadir junto a cada uno.
10. Haz clic en **Listo**.

Los Miembros heredan automáticamente los valores de atributos del grupo. Los usuarios añadidos más tarde los heredan al incorporarse, lo que hace que este patrón sea duradero para la Incorporación continua en lugar de un ejercicio de migración puntual.

#### <mark style="color:azul;">La prioridad del grupo resuelve los valores en conflicto cuando un usuario pertenece a varios grupos</mark>

Donde un usuario es Miembro de más de un grupo que proporciona un valor para el mismo atributo, Okta transmite el valor del grupo de mayor prioridad.

1. Ve a **Aplicaciones** → **Aplicaciones** → **activo** → la aplicación de **Zoom** .
2. Haz clic en la **pestaña Asignaciones** .
3. En **Filtros**, haz clic en **Grupos**.
4. Arrastra y suelta los grupos en el orden deseado.

{% hint style="info" %}
**Recomendación**

Ordene los grupos de lo más específico a lo más general, para que un grupo de alcance limitado — un sitio o Rol, función concretos — tenga prioridad sobre uno amplio y genérico. Revertir este orden hace que el grupo general anule a todos los específicos, lo que normalmente se manifiesta como que toda una población reciba la misma configuración no deseada.
{% endhint %}

### Paso 6: Verifique usando el Registro del sistema de Okta

1. Ve a **Informes** → **Registro del sistema**.
2. Filtra por el usuario de destino o por la aplicación Zoom, y reduce el intervalo de tiempo al intento de aprovisionamiento.
3. Abra el Evento relevante y revise el detalle, que incluye el resultado y cualquier error devuelto por la aplicación descendente.

Los errores de aprovisionamiento sin resolver también aparecen en la aplicación Zoom **Aprovisionamiento** pestaña. Cuando el registro de Okta no sea concluyente, pasa a los registros de llamadas de Zoom App Marketplace descritos en **Verificación del lado de Zoom y errores comunes**, que muestran el intercambio sin procesar de la solicitud y la respuesta.

{% hint style="warning" %}
**Atención: la falla silenciosa específica de Okta**

Un atributo declarado en el perfil de usuario de Zoom, pero que nunca se asigna, o se asigna sin **Actualizar los atributos del usuario** habilitada en el paso 4, no transmite nada y sigue apareciendo en la lista de asignaciones. No se genera ningún error. Si un valor no llega a Zoom y el registro del sistema no muestra ningún evento correspondiente, comprueba la asignación y la configuración de aprovisionamiento antes de seguir investigando.
{% endhint %}

#### <mark style="color:azul;">Comportamiento de Incorporación y baja en Okta</mark>

* El alcance es el principal control de seguridad. Ningún usuario al que no se le asigne la aplicación de Zoom en Okta es modificado por ningún mapeo en esta configuración.
* Con **Desactivar usuarios** habilitada, quitar la asignación de la aplicación o desactivar la cuenta de Okta desactiva automáticamente la cuenta de Zoom.
* Volver a asignar la aplicación reactiva una cuenta de Zoom previamente desactivada, lo que convierte la pertenencia al grupo en un mecanismo viable para gestionar a quienes se van y a quienes regresan.

### Paso 7: Aplica los escenarios de referencia en Okta

Los escenarios, los requisitos previos y las definiciones de atributos se encuentran en la sección [**Escenarios de referencia**](#reference-scenarios) . Aquí solo se proporciona la configuración de Okta.

**Escenario 0 — Departamento.** En el paso 1, declara el atributo con **Nombre para mostrar** y **Nombre de variable** `department`, **Nombre externo** `department` y **Espacio de nombres externo** `urn:ietf:params:scim:schemas:extension:Empresarial:2.0:usuario`. Usa **Tipo de atributo: Personal**. El perfil de usuario base de Okta ya incluye un `department` atributo, por lo que se puede omitir el paso 2; asígnalo directamente en el paso 3, seleccionando **Crear y actualizar**.

{% hint style="warning" %}
**Atención: formato de espacio de nombres para atributos de extensión Empresarial**

La ADVERTENCIA del Paso 1 describe la convención de Zoom de añadir el nombre del atributo al espacio de nombres External. Esa orientación está documentada para los atributos de la extensión de Zoom. `department` pertenece a la extensión empresarial estándar de SCIM, donde el comportamiento habitual de Okta es mantener el espacio de nombres y el nombre externo en campos separados, como se muestra arriba. Si el valor no llega a Zoom, prueba la forma concatenada — `urn:ietf:params:scim:schemas:extension:Empresarial:2.0:usuario:department` — y confirma qué formulario se completó correctamente en el registro de llamadas de Marketplace.
{% endhint %}

**Alternativas si `department` ya está asignado.** Cualquiera de los siguientes se comporta de forma idéntica, depende del mismo elemento principal y no tiene precondiciones: sustituye el nombre del atributo en ambos **Nombre externo** y el espacio de nombres, y proceda a Añadir un atributo de origen correspondiente en el paso 2 si el perfil de Okta aún no lo contiene:

| Atributo         | Notas                                                                                                                                                                                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `costCenter`     | Campo Comercial, varía entre usuarios, por lo que un valor incorrecto es visible                                                                                                                                                                   |
| `Organización`   | A menudo es idéntico en todos los usuarios, lo que hace que un error sea más difícil de detectar                                                                                                                                                   |
| `employeeNumber` | A menudo ya está asignado como un campo de identidad — compruébelo antes de declararlo                                                                                                                                                             |
| `pronouns`       | Se encuentra en la extensión de **Zoom** en lugar de en la extensión Empresarial, por lo que utiliza el mismo espacio de nombres que todos los demás escenarios de esta guía y evita por completo la cuestión del formato mencionada anteriormente |

**Escenario 1: sitio de Zoom Phone y extensión automática.** Declare `zoomPhoneSite` con **Tipo de atributo: grupo** y establezca su valor en el grupo de Okta de cada sitio. Así, la pertenencia al grupo determina directamente el sitio y no se necesita lógica de traducción. Declare `zoomPhoneExtNumber` como atributo personal con un valor predeterminado de `0` salvo que esté migrando una configuración de extensiones ya existente.

**Escenario 2: plan de llamadas variable según el país.** Declare `zoomPhoneCallingPlan` con **Tipo de atributo: grupo** y cree un grupo por cada región del plan de llamadas, estableciendo el valor del plan en la asignación de la aplicación Zoom de cada grupo. Los usuarios heredan el plan correcto por su pertenencia al grupo y el valor almacenado en Okta es exactamente el que espera Zoom. Esto también permite ver y auditar la configuración desde la pestaña **Asignaciones** y hace que siga funcionando pese a las incoherencias en la forma en que se cumplimentaron los datos del directorio subyacente. Un grupo que contenga `-1` ofrece una forma clara de retirar los derechos de llamadas sin eliminar al usuario.

**Escenario 3: Paquete, Rol, función y región del centro de contacto.** Declare `zoomContactCenterPackage` como atributo enumerado limitado a los tres valores permitidos, de modo que nunca se pueda introducir un Paquete no válido. Declare `zoomContactCenterRole` como atributo de nivel de grupo, ya que el Rol, función, suele corresponder a la estructura del equipo. Deje `zoomContactCenterRegion` sin asignar en las implementaciones de una sola región.

## Solución de problemas

### Errores

#### <mark style="color:azul;">El usuario no existe o no pertenece a esta cuenta</mark>

Este error se produce cuando no se puede aprovisionar la dirección de correo electrónico de un usuario objetivo porque ya existe una cuenta. Se recomienda a los administradores de Zoom que se pongan en contacto directamente con el usuario y lo inviten manualmente a la cuenta.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Ejemplo de un error de aprovisionamiento.</p></figcaption></figure></div>

#### <mark style="color:azul;">No se pueden añadir usuarios de pago</mark>

Este error se produce cuando SCIM intenta aprovisionar a un usuario y no hay licencias suficientes en la cuenta. Para resolver el error, se debe aprovisionar al usuario como usuario básico o debe haber una licencia disponible para el aprovisionamiento.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Ejemplo de un error de aprovisionamiento.</p></figcaption></figure></div>

### Uso de los registros de SCIM para solucionar problemas de aprovisionamiento de usuarios

Zoom proporciona los 100 registros más recientes de solicitudes a la API en [Zoom Marketplace](https://marketplace.zoom.us/). Un administrador de Zoom puede usar estos registros para confirmar qué información se envía y se recibe a través de las API de aprovisionamiento. Para acceder a los registros, inicie sesión en Zoom Marketplace como administrador de Zoom y haga clic en **Administrar**. En la página siguiente, seleccione **Registros de llamadas** en **Administración de aplicaciones personales**. Desde allí, haga clic en una entrada para expandir los registros de la API y revisar el contenido.

La siguiente imagen muestra un ejemplo de una solicitud de aprovisionamiento de usuarios de SCIM, con los atributos de identidad y licencia del usuario resaltados como referencia.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Ejemplo de una solicitud de aprovisionamiento de usuarios de SCIM.</p></figcaption></figure></div>

Al igual que con la asignación de respuestas, Zoom solo puede aplicar la información enviada por el proveedor de identidad en la solicitud de aprovisionamiento. Use estos registros para confirmar que el proveedor de identidad envía los atributos de identidad y licencia del usuario. Si falta información esperada en estas afirmaciones, póngase en contacto con su proveedor de identidad para obtener soporte.


---

# 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/rincon-del-administrador/account-and-endpoint-management/scim-guide.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.
