ANTES DE EMPEZAR
Lo que necesita
- Una cuenta API con permisos y licencias adecuados, y un servidor EasyUC accesible. Guarde las credenciales en la cuenta protegida de integración del service desk.
- El usuario de CUCM ya existe. Las empresas, ubicaciones API, clústeres y valores de configuración están asociados en Enduser Setup.
- La parte de ServiceNow implementa la petición REST, un identificador propio y la recepción de webhooks. El ejemplo utiliza las interfaces generales de EasyUC; no presupone un conector de ServiceNow instalado.
Preparar el acceso técnico
Dónde trabajar: Administration → Integrations & Communication → API Access / API Documentation
Empiece con una cuenta técnica dedicada para distinguir las solicitudes automáticas de las acciones interactivas de los administradores. Abra después la documentación API integrada: describe los recursos, campos y respuestas de su versión de EasyUC.
La autenticación usa POST /public-api/auth con apiKey y apiSecret. La integración utiliza después el JWT devuelto. Compruebe autenticación y permisos de lectura antes de enviar una tarea real. Un fallo de acceso debe aparecer como error de integración en el service desk.
Consultar endpoints en el producto
La documentación integrada muestra los endpoints de dispositivos y el esquema de autorización. Interfaz original en inglés con algunas descripciones en alemán. No se ejecutó ninguna solicitud.
Asociar la solicitud al entorno correcto
Dónde trabajar: Administration → CUCM & Provisioning → Enduser Setup
Defina qué código de empresa y ubicación API corresponden a cada clúster y ubicación de EasyUC. Esta asociación traduce los datos del ticket en configuración telefónica concreta. El service desk no necesita reproducir pools de dispositivos de CUCM ni plantillas de teclas en el ticket.
Compruebe también que el identificador ya existe en CUCM y que los servicios solicitados están configurados en la ubicación. Por ejemplo, solicite Jabber Windows/Mac e iPhone sin perfil de dispositivo ni buzón de voz. La petición expresa la necesidad; EasyUC la resuelve con los valores configurados.
Enviar la tarea desde el ticket
Dónde trabajar: Flujo del service desk → POST /public-api/enduser_tasks
Tras la aprobación, el service desk envía una tarea con requestId, company, location, enduser y options. Utilice un identificador único, como el número RITM de ServiceNow. El mismo identificador aparece en la respuesta y vincula la ejecución con la solicitud original.
Guarde también en el ticket el identificador de tarea devuelto por EasyUC. Una respuesta de creación correcta significa inicialmente que la tarea fue aceptada. Cambie el ticket a en curso; solo el resultado final confirma la configuración. El ejemplo desplegable muestra la estructura de la solicitud.
Abrir ejemplo técnico
Datos ilustrativos. Adapte el usuario, la ubicación, el código de empresa y el destino de respuesta a su entorno.
POST /public-api/enduser_tasks
Content-Type: application/json
Authorization: Bearer <JWT>
{
"requestId": "RITM0001001",
"company": {
"code": "example-eu"
},
"location": "DE-BER-01",
"enduser": "anna.schmidt",
"options": {
"locale": "de_DE",
"softPhones": {
"iphone": true,
"android": false,
"tablet": false,
"windows": true
},
"deviceProfile": false,
"voicemail": false
}
}Seguir el procesamiento
Dónde trabajar: Enduser Setup → Live-Log / GET /public-api/enduser_tasks/{id}
EasyUC procesa la tarea de forma asíncrona. Los estados distinguen en espera (1), en curso (2), éxito (3) y error (4). El service desk puede consultar la tarea mediante su ID sin mantener abierta una petición durante toda la configuración.
El registro en vivo de Enduser Setup permite seguir la solicitud recibida, los pasos y la respuesta enviada. Compare requestId y taskId al investigar. Un error funcional, como una ubicación sin asociación, requiere una solución distinta de un destino de respuesta inaccesible.
Devolver el resultado a ServiceNow
Dónde trabajar: Administration → Integrations & Communication → Webhooks
Configure un webhook Enduser Task con formato compacto hacia el receptor de su integración. Compruebe destino y autenticación. La respuesta incluye requestId, taskId, estado, número, opciones seleccionadas y errores para asociarla a la solicitud correcta.
La integración de ServiceNow evalúa el resultado y añade número y servicios al ticket. Márquelo completado solo con estado 3; con estado 4, derive los errores para su tratamiento. Los callbacks repetidos deben actualizar el mismo ticket sin generar otra solicitud.
Conciliar inventario y solicitudes
Dónde trabajar: Enduser Setup → sincronización con la herramienta externa
Además de las respuestas de tareas, EasyUC puede enviar usuarios o configuraciones CUCM existentes a un destino externo. La base de usuarios indica quién existe. La sincronización completa añade clústeres, ubicaciones, números y dispositivos compatibles para distinguir un usuario conocido de uno ya equipado.
Pruebe primero las solicitudes, el procesamiento y las respuestas con unos pocos usuarios de prueba autorizados. Antes de enviar el inventario, compruebe su alcance con «Dry run (build inventory only)»: la sincronización abarca todos los clústeres CUCM configurados en Enduser Setup. No recopila buzones de voz; esa información procede de las respuestas de tareas. Defina responsables de errores y la aprobación en el service desk.
El resultado
La solicitud sigue siendo trazable en el service desk mientras EasyUC configura telefonía con valores centralizados. Identificador, estado y respuesta conectan ambos sistemas; el ticket puede mostrar el número realmente asignado y el resultado.
Conviene saber
- Una tarea aceptada no equivale a una configuración terminada. Compruebe el estado final y los errores antes de cerrar el ticket.
- La integración de ServiceNow se implementa según su flujo. EasyUC proporciona API y webhooks; este ejemplo no presupone una aplicación certificada ni una instalación sin trabajo de integración.
- Las tareas Enduser equipan usuarios existentes de CUCM. El endpoint de eliminación retira recursos telefónicos seleccionados y no equivale a eliminar la cuenta del directorio.
Las capturas proceden del laboratorio y del entorno de demostración de EasyUC. Los textos indican los estados de configuración o simulación. Cuando la interfaz aún no está disponible en su idioma, se indica el idioma original. Las funciones visibles dependen de la versión, los permisos y las conexiones configuradas.