Uso de API de disponibilidad representativas

Utilice las API de disponibilidad de representantes para recuperar información sobre la disponibilidad de la cola y de los representantes de servicio al cliente en Dynamics 365 Contact Center.

Puede usar estas API en escenarios como:

  • Cuando los agentes de inteligencia artificial necesitan escalar las conversaciones en curso a aquellas colas donde los representantes de servicio solo estén disponibles.
  • Quiere que los clientes inicien conversaciones solo cuando las colas estén dentro del horario operativo o tengan representantes disponibles.

Las API de disponibilidad representativas son aplicables a todos los canales, como voz, chat en directo y mensajería digital.

Prerequisites

  • Usted tiene asignado el rol de administrador de Omnichannel.

Configuración del token para la autorización de API

Para usar las API de disponibilidad representativas, debe generar un token de acceso. Este token actúa como una credencial segura para autenticar la identidad de la aplicación y autorizarla para acceder a recursos de servicio específicos.

Siga estos pasos en el portal Azure:

  1. Registra tu aplicación o vaya a Entra ID>Registros de aplicaciones y seleccione la aplicación cliente. Copie los siguientes valores:

    • Identificador de aplicación (cliente)
    • Id. de directorio (inquilino)

  2. En el registro de la aplicación, seleccione Permisos> de APIAgregar un permiso.

  3. En Request API permissions, seleccione Microsoft API y, a continuación, seleccione Dynamics CRM.

  4. Seleccione Permisos delegados y, a continuación, seleccione el user_impersonation ámbito.

  5. Seleccione Agregar permisos.

  6. Agregue un secreto de cliente para la aplicación.

Importante

Copie el valor secreto inmediatamente. Este valor se cifra y no se muestra de nuevo después de salir de la página.

Para generar el token, ejecute la siguiente POST solicitud. Reemplace los valores siguientes.

Value Description
tenant-Id Identificador de directorio (inquilino) de la aplicación.
client_id El identificador de aplicación (cliente) asignado a la aplicación en Microsoft Entra ID.
client_secret Cadena secreta generada durante el registro de la aplicación.
resource La dirección URL del entorno de Dynamics 365, que define los permisos solicitados. 
 
   curl --request POST \
   --url https://login.windows.net/{tenant-Id}/oauth2/token \
   --header 'Content-Type: multipart/form-data' \

   --header 'User-Agent: insomnia/10.1.0' \
   --cookie 'fpc=ApQqO0OrCftGhsPOawVKHv6SxOiUAgAAHN3YN8OAAAA; x-ms-gateway-slice=estsfd; stsservicecookie=estsfd' \
   --form grant_type=client_credentials \
   --form client_id={ApplicationIdFromAppRegistration} \
   --form 'client_secret={secretSavedInPreviousStep}' \
   --form resource={OrgUrl}

La respuesta devuelve un objeto JSON con el token que puede usar en el encabezado de autorización de las llamadas api de disponibilidad representativas como token de portador.

API de disponibilidad representativas

Están disponibles las siguientes API de disponibilidad representativas:

  • CCaaS_GetRepresentativeAvailabilityForConversation: devuelve la disponibilidad de la cola y del representante del servicio durante una conversación activa con un identificador de conversación válido. Conozca más en CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation: devuelve la disponibilidad representativa de la cola y del servicio antes de que se inicie una conversación con el cliente. Más información en CCaaS_GetRepresentativeAvailabilityBeforeConversation

CCaaS_ObtenerDisponibilidadDelRepresentanteParaConversación
CCaaS_ObtenerDisponibilidadDelRepresentanteAntesDeLaConversación

  • Last updated on