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 queuecomo 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

Name	Type	Description
branch*	String	ID de oficina o integrationId
queue*	String	ID de fila (segment) o integrationId

Headers

Name	Type	Description
Authorization*	String	Backend API Key
Content-Type*	String	application/json

Request Body

Name	Type	Description
integrationData	Mixed	Datos del ticket (Array, Object o String)
form	String	ID del formulario
ticketId	String	Ticket ID legible por el cliente/agente

201: Created Ticket añadido a la fila

{
    "id": "652a1ae848880e168884e49b",
    "segment": "Trámites ABC"
}

La respuesta contiene el ID interno del ticket en la fila y el nombre del segmento (fila)

400: Bad Request ID de oficina o segmento incorrecto

428: Precondition Required Formulario obligatorio

406: Not Acceptable Sin agentes disponibles

422: Unprocessable Entity No es posible procesar la solicitud

El valor integrationDataserá 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.

El valor ticketId tiene un límite de 50 caracteres, mínimo 1.

Obtener listado de oficinas

GET https://api.videsk.io/public/video-contact-center/branches

Listado de oficinas usando API Key

Headers

Name	Type	Description
Authorization*	String	Backend API Key
Content-Type*	String	application/json

200: OK Listado de oficinas

[
    {
        "location": [
            7,
            9
        ],
        "label": "Virtual Main branch",
        "address": "1345 Main Street, CA",
        "name": "branch-main-1345",
        "id": "652720d479497a1b62df288b"
    }
]

Obtener listado de filas

GET https://api.videsk.io/public/video-contact-center/branches/:branch/queues

Listado de filas disponibles en la oficina

Headers

Name	Type	Description
Authorization*	String	Backend API Key
Content-Type*	String	application/json

200: OK Listado de filas disponibles

[
    {
        "name": "Atención a clientes",
        "id": "652a1ae848880e168884e49b",
        "users": 0,
        "avgWaitingTime": 1.124
    }
]

La respuesta incluye users que corresponde al número de agentes disponibles para realizar un atención inmediata.

404: Not Found Oficina no encontrada

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

Name	Type	Description
Authorization*	String	Backend API Key
Content-Type*	String	application/json

200: OK Información de la fila

{
    "name": "Atención a clientes",
    "id": "652a1ae848880e168884e49b",
    "users": 1,
    "avgWaitingTime": 1.124
}

404: Not Found Oficina o segmento no encontrado

Postman collection

Puedes clonar nuestra colección de postman exclusiva para integración QMS:

Postmanwww.postman.com

Colección Postman

La colección incluye un flow para mejor entendimiento de cómo realizar la integración.