Compartir a través de


Luware Nimbus

Conector para el Centro de contactos nimbus y servicios con licencia de enrutamiento empresarial para conectar rápidamente Nimbus con sistemas de terceros. Escuchando y reaccionando a eventos desencadenadores, el conector puede seguir las acciones de flujo, por ejemplo, para recuperar datos de sistemas externos y almacenarlos en parámetros nimbus para su uso posterior en los flujos de trabajo de Nimbus.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Luware Helpdesk
URL https://helpdesk.luware.cloud/
Correo Electrónico nimbus.support@luware.com
Metadatos del conector
Publicador Software de software
Sitio web https://luware.com/
Directiva de privacidad https://luware.com/en/privacy-policy/
Categorías Comunicación; Colaboración

El conector Nimbus de Luware permite la integración entre Nimbus y software de terceros, como CRM o sistemas de vales. Le permite escuchar eventos de entrada de tareas y programador que se producen en Luware Nimbus. Puede crear tareas, enriquecer las tareas existentes con datos de información del autor de la llamada, agregar parámetros de enrutamiento o desencadenar un evento en el sistema de terceros. Además, puede administrar libretas de direcciones, programar llamadas salientes o agregar tareas externas.

Algunos casos de uso son:

  • Mostrar los detalles de contacto en Nimbus para una llamada entrante.
  • Conserva la elección del idioma de IVR en Nimbus a un CRM.
  • Cree un elemento de trabajo posterior a la llamada después de la llamada en un CRM.
  • Cree una tarea de devolución de llamada para una llamada perdida en un CRM.
  • Cree una llamada saliente de Nimbus basada en una campaña de CRM.
  • Enrutar una llamada según las preferencias del cliente.
  • Mostrar las preferencias del autor de la llamada para una llamada entrante.
  • Cree vales en un sistema de terceros.
  • Cree una lista de llamadas perdidas en un sistema de terceros.
  • Abra el registro del cliente cuando un agente tome la llamada.

Obtenga más información y mucha ayuda sobre la base de conocimiento de Luware: https://help.luware.com/nimbus-power-automate-connector

Prerrequisitos

  • Un plan de Microsoft PowerApps o PowerAutomate con el nivel "Premium"
  • Un inquilino de Azure
  • Al menos un servicio Nimbus de Luware aprovisionado
  • Un rol en Luware Nimbus que permite el uso del conector Nimbus de Luware (https://help.luware.com/power-automate-roles)

Establecimiento de una conexión segura

Las API de Nimbus se protegen mediante Azure Active Directory (AAD) o el identificador de Microsoft Entra mediante permisos delegados. Como administrador de inquilinos, debe conceder estos permisos para la aplicación "Inicio de sesión de Nimbus de Luware" para que el conector pueda acceder de forma segura a Luware Nimbus. En la mayoría de los casos, estos permisos se han concedido durante la incorporación de Nimbus ya y no es necesario volver a confirmarlos.

Una vez completado este paso, puede usar el conector estableciendo una conexión a clústeres de Nimbus. Asegúrese de elegir la misma ubicación del clúster que la instalación de Nimbus. Si no está seguro de esto, inicie sesión en la administración de Nimbus para comprobar hacia qué clúster se le redirigirá.

Introducción al conector

  1. Seleccione el desencadenador "Cuando una tarea cambia el estado" en los desencadenadores Nimbus de Luware.
  2. Configure el servicio Nimbus en el que desea escuchar las llamadas entrantes.
  3. Seleccione el evento "Sistema aceptado" (desencadenado cuando se alcanza la actividad "Aceptar conversación" en el flujo de trabajo).
  4. Implemente la búsqueda de la información del autor de la llamada basada en el número de teléfono del autor de la llamada, por ejemplo, en su CRM o con fines de prueba en una hoja de Excel hospedada en Sharepoint.
  5. Use la acción "Actualizar tarea" para establecer la información del cliente como Nombre/Apellido, Dirección, Ciudad, País, etc. en la tarea.

Consulte nuestra sección de casos de uso sobre la base de conocimiento: https://help.luware.com/power-automate-use-cases

Problemas y limitaciones conocidos

  • La pérdida de permisos (RBAC) en Luware Nimbus deshabilitará los desencadenadores en Power Automate sin información transparente para el usuario final. Los flujos ya no se desencadenarán.
  • Luware no tiene influencia en el tiempo de ejecución de los flujos, por lo que los resultados pueden volver a llegar a Nimbus con un retraso. Los flujos de trabajo en función de la finalización del flujo deben crearse teniendo en cuenta esta limitación.

Errores y soluciones comunes

Código de error HTTP:

  • 400: La solicitud que ha enviado a la API de Nimbus de Luware no contiene parámetros válidos o no se pueden aplicar. Ejemplos: todos los usuarios preferidos pasados no son válidos, por lo que los usuarios preferidos no se establecen O intenta eliminar una tarea externa cuando ya está asignada a un usuario.
  • 401: El token de autenticación proporcionado no se puede analizar o no es válido. Compruebe la configuración correcta del registro de aplicación de Azure AD/Entra ID y de que ha proporcionado las credenciales correctas para su cuenta de O365.
  • 403: La cuenta carece de los permisos necesarios en Nimbus para realizar la acción configurada en el flujo. Consulte knowledge Base y póngase en contacto con el administrador en caso de que necesite roles o derechos adicionales.
  • 404: Los identificadores pasados no pueden coincidir con ninguna entidad del back-end.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Ubicación cuerda / cadena Ubicación en la que se encuentra el inquilino. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualización de una llamada saliente con la entrada del programador de flujo de trabajo

Cambie la configuración de una llamada saliente ya creada con la entrada del programador de flujo de trabajo.

Actualizar tarea

Actualice la información del cliente, el parámetro de contexto o la configuración de usuario preferida para una tarea en curso.

Actualizar un contacto en una libreta de direcciones

Actualiza un único contacto en la libreta de direcciones especificada.

Actualizar una entrada del programador

Cambie la configuración de una entrada del programador ya creada.

Agregar un contacto a una libreta de direcciones

Agrega un nuevo contacto a una libreta de direcciones específica. ExternalId se usa como referencia en más solicitudes.

Agregar una nueva tarea externa

Agregar una nueva tarea externa

Obtención de datos del asistente de usuario virtual

Devuelve los datos del asistente de usuario virtual para la sesión de servicio seleccionada.

Obtener contactos de una libreta de direcciones

Devuelve contactos de una libreta de direcciones.

Obtener horario de apertura

Obtener un horario de apertura del servicio: devuelve el estado del servicio (Abierto, Cerrado, Festivo, etc.) en un momento dado.

Obtener todas las entradas del programador

Devuelve todas las entradas del programador para el servicio especificado.

Programar una nueva llamada saliente

Programe una nueva llamada saliente (entrada del programador).

Programar una nueva llamada saliente con flujo de trabajo

Programe una nueva llamada saliente con flujo de trabajo (entrada del programador).

Quitar contactos de una libreta de direcciones

Quite uno o varios contactos de una libreta de direcciones.

Quitar una entrada del programador

Quite una entrada del programador del sistema. Solo es posible, mientras que la entrada del programador aún no está en curso.

Quitar una tarea externa

Quitar una tarea externa

Vaciar una libreta de direcciones

Quite todos los contactos de la libreta de direcciones especificada.

Actualización de una llamada saliente con la entrada del programador de flujo de trabajo

Cambie la configuración de una llamada saliente ya creada con la entrada del programador de flujo de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de entrada del programador
SchedulerEntryID True string

Identificador de la entrada del programador que se va a actualizar.

Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Destino
destination True string

Destino de la llamada saliente con flujo de trabajo.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc True date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn True string

UPN del servicio.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Define cuánto tiempo Nimbus intenta llegar al destino antes de que se detenga el intento.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Actualizar tarea

Actualice la información del cliente, el parámetro de contexto o la configuración de usuario preferida para una tarea en curso.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de la tarea
taskId True string

Identificador específico de Nimbus de la tarea.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

UPN
upn True string

UpN del usuario preferido.

Priority
priority integer

Prioridad. 1 alto a 99 bajo.

Id. de sesión de servicio
serviceSessionId string

Identificador de la sesión de servicio.

Id. de sesión de usuario
userSessionId string

Identificador de la sesión del usuario.

Actualizar un contacto en una libreta de direcciones

Actualiza un único contacto en la libreta de direcciones especificada.

Parámetros

Nombre Clave Requerido Tipo Description
Libreta de direcciones
AddressBook True string

El libreta de direcciones en el que se va a actualizar el contacto.

Id. externo de contacto
externalId True string

Id. del contacto proporcionado por el sistema externo.

Nombre del contacto
firstName string

Nombre del contacto.

Apellidos de contacto
lastName string

Apellidos del contacto.

Nombre para mostrar del contacto
displayName string

Nombre para mostrar del contacto.

Iniciales de contacto
initials string

Iniciales del contacto.

Ponerse en contacto con la empresa
company string

Compañía del contacto.

Departamento de contacto
department string

Departamento del contacto.

Puesto de contacto
jobTitle string

Título del trabajo del contacto.

Ponerse en contacto con el nombre principal de usuario
userPrincipalName string

Nombre principal de usuario del contacto.

Ponerse en contacto con direcciones de mensajería instantánea
imAddresses array of string

Lista de direcciones de mensajería instantánea.

Direcciones de correo electrónico de contacto
emailAddresses array of string

Lista de direcciones de correo electrónico.

Ponerse en contacto con teléfonos profesionales
businessPhones array of string

Lista de teléfonos empresariales.

Ponerse en contacto con teléfonos móviles
mobilePhones array of string

Lista de teléfonos móviles.

Ponerse en contacto con teléfonos domésticos
homePhones array of string

Lista de teléfonos domésticos.

Calle de direcciones
street string

Calle y número de la dirección.

Ciudad de dirección
city string

Ciudad de la dirección.

País de dirección
country string

País de la dirección.

Estado de dirección
state string

Estado de la dirección.

Código postal de dirección
postalCode string

Código postal de la dirección.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Actualizar una entrada del programador

Cambie la configuración de una entrada del programador ya creada.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de entrada del programador
SchedulerEntryID True string

Identificador de la entrada del programador que se va a actualizar.

Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Destino
destination True string

Destino de las entradas del programador con la dirección "Saliente".

Prioridad de distribución
distributionPriority string

Prioridad con la que se debe controlar la tarea en Nimbus.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc True date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn True string

UPN del servicio.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Tiempo de espera (intervalos) entre reintentos de conexión hasta que se alcanza el número máximo de intentos.

Tiempo máximo de cola en segundos
maxQueueTimeInSeconds integer

Define cuánto tiempo Nimbus intenta resolver la tarea hasta que la tarea se considera Límite alcanzado.

Tiempo de espera de RONA en segundos
ronaTimeoutInSeconds integer

Define el tiempo que Nimbus intenta llegar al usuario hasta que la tarea se considera RONA y se seleccionará un nuevo usuario.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Agregar un contacto a una libreta de direcciones

Agrega un nuevo contacto a una libreta de direcciones específica. ExternalId se usa como referencia en más solicitudes.

Parámetros

Nombre Clave Requerido Tipo Description
Libreta de direcciones
AddressBook True string

El libro de direcciones al que se va a agregar el contacto.

Id. externo de contacto
externalId True string

Id. del contacto proporcionado por el sistema externo.

Nombre del contacto
firstName string

Nombre del contacto.

Apellidos de contacto
lastName string

Apellidos del contacto.

Nombre para mostrar del contacto
displayName string

Nombre para mostrar del contacto.

Iniciales de contacto
initials string

Iniciales del contacto.

Ponerse en contacto con la empresa
company string

Compañía del contacto.

Departamento de contacto
department string

Departamento del contacto.

Puesto de contacto
jobTitle string

Título del trabajo del contacto.

Ponerse en contacto con el nombre principal de usuario
userPrincipalName string

Nombre principal de usuario del contacto.

Ponerse en contacto con direcciones de mensajería instantánea
imAddresses array of string

Lista de direcciones de mensajería instantánea.

Direcciones de correo electrónico de contacto
emailAddresses array of string

Lista de direcciones de correo electrónico.

Ponerse en contacto con teléfonos profesionales
businessPhones array of string

Lista de teléfonos empresariales.

Ponerse en contacto con teléfonos móviles
mobilePhones array of string

Lista de teléfonos móviles.

Ponerse en contacto con teléfonos domésticos
homePhones array of string

Lista de teléfonos domésticos.

Calle de direcciones
street string

Calle y número de la dirección.

Ciudad de dirección
city string

Ciudad de la dirección.

País de dirección
country string

País de la dirección.

Estado de dirección
state string

Estado de la dirección.

Código postal de dirección
postalCode string

Código postal de la dirección.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Agregar una nueva tarea externa

Agregar una nueva tarea externa

Parámetros

Nombre Clave Requerido Tipo Description
UPN de servicio
serviceUpn True string

UPN del servicio.

Identificador de cliente
customerIdentifier string

Identificador de informes único opcional, anónimo cuando está vacío.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

Prioridad de distribución
distributionPriority string

Prioridad con la que se debe controlar la tarea en Nimbus una vez que se deba.

UPN
upn True string

UpN del usuario preferido.

Priority
priority integer

Prioridad. 1 alto a 99 bajo.

Devoluciones

Obtención de datos del asistente de usuario virtual

Devuelve los datos del asistente de usuario virtual para la sesión de servicio seleccionada.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sesión de servicio
serviceSessionId True string

Identificador de la sesión de servicio para la que se deben devolver los datos del asistente de usuario virtual.

Id. de sesión de usuario
userSessionId string

Identificador de la sesión de usuario para la que se deben devolver los datos del asistente de usuario virtual.

Tipo de datos
dataType True string

Tipo de datos que se deben devolver para la sesión de servicio.

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener contactos de una libreta de direcciones

Devuelve contactos de una libreta de direcciones.

Parámetros

Nombre Clave Requerido Tipo Description
Libreta de direcciones
AddressBook True string

La libreta de direcciones de la que se van a obtener los contactos.

ExternalId
externalIds array

Identificadores externos de los contactos que se van a capturar. Opcional: Si no se proporciona ninguno, se devolverán todos los contactos.

Devoluciones

Contactos devueltos.

Obtener horario de apertura

Obtener un horario de apertura del servicio: devuelve el estado del servicio (Abierto, Cerrado, Festivo, etc.) en un momento dado.

Parámetros

Nombre Clave Requerido Tipo Description
UPN de servicio
serviceUpn True string

UPN del servicio para el que se comprobará el estado.

Fecha y hora de vencimiento (UTC)
time date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

Devoluciones

Estado del servicio (Abierto, Cerrado, etc.).

response
CalendarStatus

Obtener todas las entradas del programador

Devuelve todas las entradas del programador para el servicio especificado.

Parámetros

Nombre Clave Requerido Tipo Description
UPN de servicio
serviceUpn True string

UPN del servicio para el que se deben devolver las entradas del programador.

Devoluciones

Lista de todas las tareas programadas para el servicio especificado

Programar una nueva llamada saliente

Programe una nueva llamada saliente (entrada del programador).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Destino
destination True string

Destino de las entradas del programador con la dirección "Saliente".

Prioridad de distribución
distributionPriority string

Prioridad con la que se debe controlar la tarea en Nimbus.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc True date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn True string

UPN del servicio.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Tiempo de espera (intervalos) entre reintentos de conexión hasta que se alcanza el número máximo de intentos.

Tiempo máximo de cola en segundos
maxQueueTimeInSeconds integer

Define cuánto tiempo Nimbus intenta resolver la tarea hasta que la tarea se considera Límite alcanzado.

Tiempo de espera de RONA en segundos
ronaTimeoutInSeconds integer

Define el tiempo que Nimbus intenta llegar al usuario hasta que la tarea se considera RONA y se seleccionará un nuevo usuario.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Programar una nueva llamada saliente con flujo de trabajo

Programe una nueva llamada saliente con flujo de trabajo (entrada del programador).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Destino
destination True string

Destino de la llamada saliente con flujo de trabajo.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc True date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn True string

UPN del servicio.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Define cuánto tiempo Nimbus intenta llegar al destino antes de que se detenga el intento.

Nombre
name True string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Nombre
name True string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Nombre
name True string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

Devoluciones

Quitar contactos de una libreta de direcciones

Quite uno o varios contactos de una libreta de direcciones.

Parámetros

Nombre Clave Requerido Tipo Description
Libreta de direcciones
AddressBook True string

La libreta de direcciones de la que se va a quitar el contacto.

externalIds
externalIds True array of string

Quitar una entrada del programador

Quite una entrada del programador del sistema. Solo es posible, mientras que la entrada del programador aún no está en curso.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de entrada del programador
SchedulerEntryID True string

Identificador de la entrada del programador que se va a quitar.

Quitar una tarea externa

Quitar una tarea externa

Parámetros

Nombre Clave Requerido Tipo Description
Id. de tarea externa
externalTaskId True string

Identificador de la tarea externa que se va a quitar

Vaciar una libreta de direcciones

Quite todos los contactos de la libreta de direcciones especificada.

Parámetros

Nombre Clave Requerido Tipo Description
Libreta de direcciones
AddressBook True string

El libro de direcciones que se va a vaciar

Desencadenadores

Cuando cambia el estado de una entrada del programador

Se genera cada vez que una entrada del programador coincide con los criterios de filtro cambia su estado.

Cuando el asistente de usuario virtual tiene una actualización

Este evento se desencadena cuando el asistente de usuario virtual tiene una nueva actualización.

Cuando una tarea cambia de estado

Se genera cada vez que una tarea que coincida con los criterios de filtro cambia su estado.

Cuando cambia el estado de una entrada del programador

Se genera cada vez que una entrada del programador coincide con los criterios de filtro cambia su estado.

Parámetros

Nombre Clave Requerido Tipo Description
Services
services True array of string

UpN de los servicios para los que se deben capturar los eventos de las tareas.

Eventos de entrada del programador
schedulerEntryEvents True array of string

Eventos de la entrada del programador, para los que se debe generar este desencadenador.

Devoluciones

Cuando el asistente de usuario virtual tiene una actualización

Este evento se desencadena cuando el asistente de usuario virtual tiene una nueva actualización.

Parámetros

Nombre Clave Requerido Tipo Description
Services
services True array of string

UpN de los servicios para los que se deben capturar los eventos de las tareas.

Eventos de Virtual User Assistant
virtualUserAssistantEvents True array of string

Eventos del asistente de usuario virtual, para los que se debe generar este desencadenador.

Devoluciones

Cuando una tarea cambia de estado

Se genera cada vez que una tarea que coincida con los criterios de filtro cambia su estado.

Parámetros

Nombre Clave Requerido Tipo Description
Services
services True array of string

UpN de los servicios para los que se deben capturar los eventos de las tareas.

Eventos de tareas
taskEvents True array of string

Eventos de las tareas para las que se debe generar este desencadenador.

Modalidades
modalities array of string

Especifique las modalidades iniciales de las tareas.

Direcciones
directions array of string

Especifique las direcciones de las tareas.

Devoluciones

Definiciones

TaskEventData

Nombre Ruta de acceso Tipo Description
Id. de la tarea
taskId string

Identificador específico de Nimbus de la tarea.

Id. de sesión de servicio
serviceSessionId string

Identificador de la sesión de servicio

Id. de sesión de usuario
userSessionId string

Identificador de la sesión de usuario

Sesión de usuario iniciada con transferencia
userSessionStartedWithTransfer boolean

Indica si la sesión del usuario se inició como resultado de una transferencia.

Identificador de cadena de llamadas
callChainId string

Identificador de cadena de llamadas de Microsoft de la tarea.

Event
event string

Evento que se produjo en Nimbus para la tarea.

Dirección
direction string

Dirección de la tarea en curso en Nimbus (Entrante/Saliente/Ninguno).

Modality
modality string

Modalidad inicial de la tarea en Nimbus.

Creado
created string

Marca de tiempo, cuando se ha creado la tarea.

Finalizado
terminated string

Marca de tiempo, cuando se ha terminado la tarea.

Motivo
reason string

Motivo de finalización.

Identificador del último usuario conectado
lastConnectedUserId string

Id. de objeto (AAD) del último usuario conectado de la tarea.

UPN del último usuario conectado
LastConnectedUserUPN string

UPN del último usuario conectado de la tarea.

Correo electrónico del último usuario conectado
LastConnectedUserEmail string

Correo electrónico del último usuario conectado de la tarea.

Identificador del autor de llamada de Microsoft
microsoftCallerId string

Id. de objeto (AAD) del autor de la llamada.

Identificador de referencia
referenceId string

Identificador de referencia pasado por el sistema de terceros.

Id. de llamada
callerId string

Identificador interno del autor de la llamada en Nimbus. Id. de objeto (AAD) si se conoce al autor de la llamada.

Número de teléfono del autor de la llamada
callerTelNumber string

Número de teléfono (E.164) del autor de la llamada. Establezca solo para tareas con modality=Audio.

UPN del autor de la llamada
callerUPN string

UPN del cliente.

Id. de destino de Microsoft
microsoftDestinationId string

Id. de objeto (AAD) del destinatario en una tarea saliente.

Id. de destino
destinationId string

Identificador interno del destino (saliente) en Nimbus. Id. de objeto (AAD) si se conoce al autor de la llamada.

Número de teléfono de destino
destinationTelNumber string

Número de teléfono (E.164) del destino (saliente).

UPN de destino
destinationUPN string

UPN del destino (saliente).

Id. de ACS
acsId string

Identificador de comunicación de Azure del autor de la llamada.

Es anónimo
isAnonymous boolean

Marca establecida en true, cuando el autor de la llamada es anónimo.

Identificador de cliente
customerIdentifier string

Identificador del cliente en todos los tipos de tareas.

Mensaje inicial
initialMessage string

En primer lugar, se muestra el mensaje del cliente de mensajería instantánea.

Id. de servicio
serviceId string

Identificador interno del servicio Nimbus.

Nombre del servicio
serviceName string

Nombre del servicio Nimbus.

Descripción del servicio
serviceDescription string

Descripción del servicio Nimbus (heredado de Microsoft Teams).

Nombre para mostrar del servicio
serviceDisplayName string

Nombre para mostrar del servicio Nimbus.

UPN de servicio
serviceUPN string

UPN del servicio Nimbus.

Número de teléfono del servicio
serviceTelNumber string

Número de teléfono (E.164) del servicio Nimbus.

Asunto del correo electrónico
emailSubject string

Asunto del correo electrónico.

Texto enriquecido único del cuerpo del correo electrónico
emailBodyUniqueRichText string

Cuerpo del correo electrónico, texto enriquecido.

Texto sin formato único del cuerpo del correo electrónico
emailBodyUniquePlainText string

Cuerpo del correo electrónico, texto sin formato.

UPN de buzón del servicio de correo electrónico
emailServiceMailboxUPN string

UPN del buzón asignado al servicio.

Intentos de salida
outboundAttempt integer

Número de intentos para llegar al destino de salida.

Nombre de parámetro actualizado
updatedParameterName string

Nombre del último parámetro que se actualizó.

Valor de parámetro actualizado
updatedParameterValue string

Valor del último parámetro que se actualizó.

Información de tareas
taskInformation TaskInformation

Contiene información sobre el cliente, el parámetro de contexto personalizado y los usuarios preferidos.

TaskInformation

Contiene información sobre el cliente, el parámetro de contexto personalizado y los usuarios preferidos.

Nombre Ruta de acceso Tipo Description
cliente
customer Customer

Objeto que contiene toda la información del cliente.

Parámetros de contexto personalizados
customContextParameters array of CustomContextParameter

Lista de parámetros de contexto personalizados (Key-Value).

Usuarios preferidos
preferredUsers array of PreferredUser

Lista de usuarios preferidos para las tareas (UPN-Priority).

Cliente

Objeto que contiene toda la información del cliente.

Nombre Ruta de acceso Tipo Description
Nombre del cliente
firstName string

Nombre del cliente.

Apellidos del cliente
lastName string

Apellidos del cliente.

Nombre para mostrar del cliente
displayName string

Nombre para mostrar del cliente.

Empresa cliente
company string

Compañía del cliente.

Puesto del cliente
jobTitle string

Título del trabajo del cliente.

Departamento de clientes
department string

Departamento del cliente.

Dirección postal del cliente
streetAddress string

Dirección postal del cliente.

Código postal del cliente
postCode string

Código postal del cliente.

Ciudad del cliente
city string

Ciudad del cliente.

Estado del cliente
state string

Estado del cliente.

País del cliente
country string

País del cliente.

Número de teléfono principal del cliente
primaryTelNumber string

Número de teléfono principal del cliente.

Números de teléfono
telNumbers array of TelNumber

Lista de números de teléfono adicionales del cliente.

UPN del cliente
UPN string

UPN del cliente.

Dirección de mensajería instantánea del cliente
imAddress string

Dirección de mensajería instantánea del cliente.

Correo electrónico del cliente
email string

Correo electrónico del cliente.

Campos personalizados
customFields array of CustomField

Lista de campos personalizados del cliente.

TelNumber

Nombre Ruta de acceso Tipo Description
Nombre
name string

Designación del número de teléfono.

Importancia
value string

Valor del número de teléfono.

CustomField

Nombre Ruta de acceso Tipo Description
Nombre
name string

Designación del campo personalizado.

Importancia
value string

Valor del campo personalizado.

CustomContextParameter

Nombre Ruta de acceso Tipo Description
Nombre
name string

Nombre del parámetro de contexto personalizado.

Importancia
value string

Valor del parámetro de contexto personalizado.

PreferredUser

Nombre Ruta de acceso Tipo Description
UPN
upn string

UpN del usuario preferido.

Priority
priority integer

Prioridad. 1 alto a 99 bajo.

ContactReadDto

Nombre Ruta de acceso Tipo Description
Id. externo de contacto
externalId string

Id. del contacto proporcionado por el sistema externo.

Nombre del contacto
firstName string

Nombre del contacto.

Apellidos de contacto
lastName string

Apellidos del contacto.

Nombre para mostrar del contacto
displayName string

Nombre para mostrar del contacto.

Iniciales de contacto
initials string

Iniciales del contacto.

Ponerse en contacto con la empresa
company string

Compañía del contacto.

Departamento de contacto
department string

Departamento del contacto.

Puesto de contacto
jobTitle string

Título del trabajo del contacto.

Ponerse en contacto con el nombre principal de usuario
userPrincipalName string

Nombre principal de usuario del contacto.

Ponerse en contacto con direcciones de mensajería instantánea
imAddresses array of string

Lista de direcciones de mensajería instantánea.

Direcciones de correo electrónico de contacto
emailAddresses array of string

Lista de direcciones de correo electrónico.

Ponerse en contacto con teléfonos profesionales
businessPhones array of string

Lista de teléfonos empresariales.

Ponerse en contacto con teléfonos móviles
mobilePhones array of string

Lista de teléfonos móviles.

Ponerse en contacto con teléfonos domésticos
homePhones array of string

Lista de teléfonos domésticos.

Direcciones
addresses array of Address

Lista de direcciones.

customFields
customFields array of CustomField

Lista de campos personalizados del contacto.

Dirección

Nombre Ruta de acceso Tipo Description
Calle de direcciones
street string

Calle y número de la dirección.

Ciudad de dirección
city string

Ciudad de la dirección.

País de dirección
country string

País de la dirección.

Estado de dirección
state string

Estado de la dirección.

Código postal de dirección
postalCode string

Código postal de la dirección.

SchedulerEntryEventData

Nombre Ruta de acceso Tipo Description
Id. de entrada del programador
schedulerEntryId string

Identificador específico de Nimbus de la entrada del programador.

ConversationType
conversationType string

Tipo de conversación de la entrada del programador.

Event
event string

Evento que se produjo en Nimbus para la tarea programada.

Dirección
direction string

Dirección de la tarea en curso en Nimbus (Entrante/Saliente/Ninguno).

Modality
modality string

Modalidad inicial de la tarea en Nimbus.

Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Id. de conversación unificada
unifiedConversationId string

Id. de conversación unificada.

Motivo de finalización
completionReason string

Resultado de la entrada del programador cuando finaliza.

Destino
destination string

Destino de las entradas del programador con la dirección "Saliente".

Prioridad de distribución
distributionPriority string

Prioridad con la que se debe controlar la tarea en Nimbus.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn string

UPN del servicio para el que está programada la entrada.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Tiempo de espera (intervalos) entre reintentos de conexión hasta que se alcanza el número máximo de intentos.

Tiempo máximo de cola en segundos
maxQueueTimeInSeconds integer

Define cuánto tiempo Nimbus intenta resolver la tarea hasta que la tarea se considera Límite alcanzado.

Tiempo de espera de RONA en segundos
ronaTimeoutInSeconds integer

Define el tiempo que Nimbus intenta llegar al usuario hasta que la tarea se considera RONA y se seleccionará un nuevo usuario.

Parámetros de contexto personalizados
customCallContextParameters array of CustomContextParameter

Lista de parámetros de contexto personalizados (Key-Value).

cliente
customer Customer

Objeto que contiene toda la información del cliente.

OutboundCallWithWorkflowSchedulerEntryEventData

Nombre Ruta de acceso Tipo Description
Id. de entrada del programador
schedulerEntryId string

Identificador específico de Nimbus de la entrada del programador.

ConversationType
conversationType string

Tipo de conversación de la entrada del programador.

Event
event string

Evento que se produjo en Nimbus para la tarea programada.

Dirección
direction string

Dirección de la tarea en curso en Nimbus (Entrante/Saliente/Ninguno).

Modality
modality string

Modalidad inicial de la tarea en Nimbus.

Identificador de referencia
ReferenceId string

Identificador de referencia pasado por el sistema de terceros.

Id. de conversación unificada
unifiedConversationId string

Id. de conversación unificada.

Motivo de finalización
completionReason string

Resultado de la entrada del programador cuando finaliza.

Destino
destination string

Destino de las entradas del programador con la dirección "Saliente".

Prioridad de distribución
distributionPriority string

Prioridad con la que se debe controlar la tarea en Nimbus.

Fecha y hora de vencimiento (UTC)
dueDateTimeUtc date-time

Fecha y hora de vencimiento en UTC: ejemplo: '2020-03-23T11:00:00Z'.

UPN de servicio
serviceUpn string

UPN del servicio para el que está programada la entrada.

Número máximo de intentos
maxAttempts integer

Número máximo de intentos para llegar al destino.

Tiempo de espera de intento en segundos
attemptTimeoutInSeconds integer

Define cuánto tiempo Nimbus intenta llegar al destino antes de que se detenga el intento.

Parámetros de contexto personalizados
customCallContextParameters array of CustomContextParameter

Lista de parámetros de contexto personalizados (Key-Value).

cliente
customer Customer

Objeto que contiene toda la información del cliente.

VirtualUserAssistantEventData

Nombre Ruta de acceso Tipo Description
Id. de sesión unificada
unifiedSessionId string

Identificador de la sesión unificada de Nimbus relacionada.

Id. de sesión de servicio
serviceSessionId string

Identificador de la sesión de servicio nimbus relacionada.

Id. de sesión de usuario
userSessionId string

Identificador de la sesión de usuario de Nimbus relacionada.

UPN de servicio
serviceUpn string

UPN del servicio para el que se produjo el evento.

Id. de servicio
serviceId string

Identificador del servicio para el que se produjo el evento.

Nombre del servicio
serviceName string

Nombre del servicio para el que se produjo el evento.

Event
event string

Evento del asistente de usuario virtual que se produjo en Nimbus.

Sesión de usuario iniciada con transferencia
userSessionStartedWithTransfer boolean

Indica si la sesión del usuario se inició como resultado de una transferencia.

ExternalTaskWriteResult

Nombre Ruta de acceso Tipo Description
Id. de tarea externa
id string

Identificador de la tarea externa agregada.

Modality
modality Modality

Modalidad de la tarea.

Creado
created string

Marca de tiempo, cuando se ha creado la tarea externa.

Tipo
type string

Tipo de la tarea externa.

Es anónimo
isAnonymous boolean

Marca establecida en true, cuando el autor de la llamada es anónimo.

Id. de servicio
serviceId string

Identificador interno del servicio Nimbus.

Nombre del servicio
serviceName string

Nombre del servicio Nimbus.

Descripción del servicio
serviceDescription string

Descripción del servicio Nimbus (heredado de Microsoft Teams).

Nombre para mostrar del servicio
serviceDisplayName string

Nombre para mostrar del servicio.

UPN de servicio
serviceUPN string

UpN del servicio.

Número de teléfono del servicio
serviceTelNumber string

Número de teléfono del servicio.

Usuarios preferidos
preferredUsers array of PreferredUser

Lista de usuarios preferidos para las tareas (UPN-Priority).

Modality

Modalidad de la tarea.

Modalidad de la tarea.

Modality
string

CalendarStatus

Estado del servicio (Abierto, Cerrado, etc.).

Estado del servicio (Abierto, Cerrado, etc.).

Estado de las horas de apertura
string