Para generar y administrar los tokens de autenticación, sigue los pasos a continuación, utilizando la interfaz de wolkvox Manager.

Proceso para Crear un Token

Para crear un nuevo token, debes acceder a la configuración de integraciones dentro de wolkvox Manager.

1. Ingresa a wolkvox Manager.
   1. Haz clic en el ícono de Configuración (engranaje), ubicado en el menú superior derecho de la aplicación.
2. En la ventana emergente de "Configuración", navega y selecciona la pestaña principal de Integraciones.
3. Dentro de esta sección, haz clic en la sub-pestaña Tokens.
4. En el campo "Descripción del token", escribe un nombre o descripción clara que te permita identificar el uso del token. Este campo es obligatorio.
5. Presiona el botón “Adicionar token”.
6. Inmediatamente, el nuevo token se listará en la tabla inferior, mostrando el token mismo, su descripción, el conteo de uso del día y el límite total de consumo.

Gestión de Tokens Existentes

Una vez que los tokens están creados y listados en la tabla, puedes gestionarlos fácilmente. Haz clic derecho sobre un token específico en la lista para desplegar las siguientes opciones:

• Copiar Token: Copia el valor alfanumérico del token a tu portapapeles. Es la forma recomendada para evitar errores de transcripción.
• Borrar: Elimina permanentemente el token seleccionado. Esta acción no se puede deshacer.
• Refrescar: Actualiza la lista de tokens en la tabla. Es útil si no ves un token recién creado o si quieres actualizar los contadores de uso.

Cómo Utilizar el wolkvox-token

Para autenticar tus solicitudes a la API, debes enviar el token generado como un encabezado (header) en tu petición HTTP de la siguiente manera:

• Nombre del encabezado: wolkvox-token
• Valor del encabezado: [El token que copiaste desde wolkvox Manager]

Límites y Consideraciones de Consumo del Token

Ten en cuenta que un mismo token no puede ser consumido de manera simultánea sin control entre múltiples procesos. Por ello, se recomienda programar el consumo de la siguiente API únicamente cuando el resultado de la solicitud anterior haya sido exitoso.

• Límite de consumo simultáneo de un token: 2 solicitudes simultáneas.
• Límite diario de tokens: Número de licencias multiplicado por 1000 tokens diarios.
  • Fórmula del límite diario de tokens: 
    • Número de licencias * 1000 tokens diarios
• Uso diario de tokens: 1000 por licencia.

Esto significa que el consumo diario disponible dependerá directamente de la cantidad de licencias asociadas.

Consideración Importante: Mantenimiento del Servidor

Es importante tener en cuenta que durante los procesos de mantenimiento, como la creación de copias de seguridad en el servidor, el consumo de APIs se deshabilita temporalmente para garantizar la integridad de los datos.

Si intentas consumir una API durante este intervalo, recibirás la siguiente respuesta con un código de estado 403 Forbidden:

{
  "code": "403",
  "error": "Forbidden",
  "msg": "The APIs cannot be consumed at this time, try again later."
}

Esta es una respuesta controlada y esperada. Tu desarrollo debe estar preparado para manejar este escenario y reintentar la solicitud más tarde.