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

NameTypeDescription

branch*

String

ID de oficina

queue*

String

ID de fila (segment)

Headers

NameTypeDescription

Authorization*

String

Backend API Key

Content-Type*

String

application/json

Request Body

NameTypeDescription

integrationData

Mixed

Datos del ticket (Array, Object o String)

form

String

ID del formulario

ticketId

String

Ticket ID legible por el cliente/agente

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

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

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.

Obtener listado de oficinas

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

Listado de oficinas usando API Key

Headers

NameTypeDescription

Authorization*

String

Backend API Key

Content-Type*

String

application/json

[
    {
        "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

NameTypeDescription

Authorization*

String

Backend API Key

Content-Type*

String

application/json

[
    {
        "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.

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

NameTypeDescription

Authorization*

String

Backend API Key

Content-Type*

String

application/json

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

Postman collection

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

Colección Postman

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

Última actualización