QMS
A continuación verás como utilizar nuestra API para conectar con sistemas QMS.
Con nuestra Rest API de llamadas podrás generar llamadas en vivo para tus clientes de manera programática integrado con sistemas QMS (Queue management systems).
Los endpoints a continuación son públicos, es decir, se antepone /public/
como medio diferenciador de endpoints privados.
Recomendamos hacer uso de los códigos de estados para aplicar lógica a tus integraciones.
Debido a la nomenclatura de sistemas QMS se menciona queue
como referencia a segmentos, siendo similares.
Consideraciones
Debes considerar que la forma de comunicación entre nuestro ACD y POCs (puntos de contactos) se realiza de forma automática. Cuando un ticket (llamada) se asigna a un ejecutivo y este contesta se dispara nuestro webhook QMS el cual se configura en cada cuenta.
Puedes ver más información en la documentación de Webhooks.
Flujo de integración
Glosario:
QMS: Sistema de administración de filas (Queues Management System)
POC: Puntos de contacto (Point of contact)
Screens: Pantallas con turnos
Solicitud de añadir a fila
POST
https://api.videsk.io/public/video-contact-center/branches/:branch/queues/:queue
Solicitar añadir a la fila un ticket de QMS
Path Parameters
Headers
Request Body
La respuesta contiene el ID interno del ticket en la fila y el nombre del segmento (fila)
El valor integrationData
será usado para ser enviado mediante nuestros webhooks, por lo que es útil en caso que desees enviar un ID interno, metadata, etc. para la sincronización. Tiene un límite de 50 Kb, recibe cualquier tipo de dato String
, Objetcs
, Arrays
, etc.
Esto no se mostrará al agente, solo estará disponible en los webhooks de integración.
Obtener listado de oficinas
GET
https://api.videsk.io/public/video-contact-center/branches
Listado de oficinas usando API Key
Headers
Obtener listado de filas
GET
https://api.videsk.io/public/video-contact-center/branches/:branch/queues
Listado de filas disponibles en la oficina
Headers
La respuesta incluye users
que corresponde al número de agentes disponibles para realizar un atención inmediata.
Obtener información fila
GET
https://api.videsk.io/public/video-contact-center/branches/:branch/queues/:queue
Obtén información de una fila individual
Headers
Postman collection
Puedes clonar nuestra colección de postman exclusiva para integración QMS:
La colección incluye un flow para mejor entendimiento de cómo realizar la integración.
Última actualización