Manual de uso · Configuración

Paso a paso

Conectar el bot de WhatsApp y generar un token de API

La misma pestaña Mi Empresa donde dejaste los datos legales de tu empresa guarda, más abajo, dos configuraciones para conectar Marko con el resto de tus herramientas: el bot que avisa por WhatsApp cuando pasa algo en tus OC, y los tokens que le dan a un sistema externo acceso de lectura a tu información —bancos, facturas, OC— sin que nadie tenga que entrar a la web.

Los pasos

Parte 1 · El bot de WhatsApp

1. Dentro de Configuración → Mi Empresa, baja hasta la sección WhatsApp Bot.

   

   Qué deberías verUn único campo, Chat ID de WhatsApp, con un ícono de ayuda junto al título. Si tu empresa ya está conectada, el campo trae ese identificador —en la imagen aparece disimulado: es el dato de un grupo real—. Si todavía no la conectaste, está vacío.
   Nadie valida que el número sea realMarko no comprueba que el bot esté de verdad en ese grupo. Puedes guardar cualquier texto en este campo y no vas a ver ningún error; si el Chat ID está mal escrito, simplemente nunca llega ninguna notificación y no hay forma de saberlo desde aquí.

2. Pulsa el ícono de ayuda o el enlace ¿Cómo obtener mi Chat ID? para abrir el instructivo.

   

   Qué deberías verUna ventana con cinco pasos: crear un grupo de WhatsApp, agregar el número del bot —+56 9 3673 7890— a ese grupo, escribir el comando chatid en el chat, copiar el identificador que responde el bot (termina siempre en @g.us) y pegarlo en el campo de Marko. El botón Guardar Cambios que menciona el último paso es el mismo de arriba de todo: guarda el Chat ID junto con el resto de la ficha, no sólo este campo.
   No se lo mandes a un número que no controlasAgregar el bot a un grupo y escribirle un comando es una acción real sobre WhatsApp. Hazlo sólo en un grupo tuyo, creado para esto. Por eso este manual no completó el paso 5 ni pulsó Guardar Cambios: hacerlo habría reemplazado la conexión real que ya tenía configurada la empresa de demostración.

Parte 2 · Generar y gestionar un token de API

1. Baja hasta la tarjeta API Pública y revisa los tokens que ya existen.

   

   Qué deberías verUna tabla con columnas Label, Usuario, Fecha creación, Último uso y Acciones. La columna Usuario sólo aparece si tu rol es Administrador; si entras como Manager no la ves, porque sólo puedes ver y revocar tus propios tokens. Si nadie generó uno todavía, en su lugar aparece «No hay tokens activos. Genera uno para comenzar a usar la API pública de Marko.»
   Un token por integraciónEl aviso azul lo resume: «Cada token queda atribuido al usuario que lo genera. Puedes tener múltiples tokens activos simultáneamente.» No hay un único token de empresa: cada integración —y cada persona— tiene el suyo, y se revocan por separado.

2. Pulsa Generar nuevo token, arriba a la derecha, y escribe un Label que identifique para qué es.

   

   Qué deberías verLa ventana Generar nuevo token de API, con un solo campo: Label (opcional, hasta 80 caracteres, con contador). El placeholder sugiere ejemplos como «Integración Bsale, Backend interno...».
   Ponle un nombre que reconozcas despuésEl Label es opcional, pero una vez generado el token no se puede editar. Si lo dejas vacío, esa fila va a mostrar un guion (—) para siempre y vas a tener que abrir cada integración para saber cuál token es cuál.

3. Pulsa Generar y copia el token de la ventana que aparece.

   

   Qué deberías verLa ventana cambia a Token generado, con un aviso amarillo: «Guarda este token AHORA. No podrás volver a verlo.» El token aparece en un campo de sólo lectura —en la imagen está oculto— con un botón de portapapeles al lado para copiarlo entero.
   Es la única vez que lo ves completoMarko sólo guarda una huella (hash) del token, nunca el valor. Si cierras esta ventana sin copiarlo, no hay forma de recuperarlo: tendrías que revocar ese token y generar uno nuevo.

4. Pulsa He guardado el token, cerrar.

   

   Qué deberías verLa ventana se cierra y la tabla se actualiza con una fila nueva arriba: tu Label, tu usuario, la fecha de hoy en Fecha creación y «Nunca usado» en Último uso —ese dato cambia a una fecha real recién cuando algún sistema haga su primera llamada con este token—.

Cuando una integración deja de necesitarlo

7. Para dar de baja una integración, pulsa Revocar en la fila de su token.

   

   Qué deberías verUna confirmación: «¿Revocar token? El sistema o integración que use este token dejará de funcionar inmediatamente. Esta acción no se puede deshacer.», con los botones Sí, revocar y Cancelar.
   Quién puede revocar el token de otra personaEl dueño del token siempre puede revocarlo. Si es de otro usuario, sólo lo puede revocar un Administrador.

8. Confirma con Sí, revocar.

   

   Qué deberías verEl aviso «Token revocado» y la fila desaparece de la tabla de inmediato —no queda marcada como inactiva ni tachada, se filtra sin más—. Cualquier sistema que siga usando ese token empieza a recibir 401 Token revoked en su próxima llamada.
   No hay vuelta atrásUn token revocado no se puede reactivar. Si la integración lo sigue necesitando, hay que generar uno nuevo y actualizarlo en el otro sistema.

Lo que esta pantalla todavía no hace

• No prueba la conexión de WhatsApp. No hay un botón para mandar un mensaje de prueba: la única forma de confirmar que el Chat ID quedó bien es esperar a que llegue la próxima notificación real.
• No valida el formato del Chat ID. Puedes guardar cualquier texto —le falte o no el @g.us— y Marko no avisa de nada.
• No se puede editar el Label de un token ya creado. Se define una sola vez, al generarlo.
• Un token revocado no se reactiva. Hay que generar uno nuevo y volver a configurarlo en el otro sistema.
• No hay expiración automática. Un token generado hoy sigue activo indefinidamente hasta que alguien lo revoca a mano; no hay rotación ni vencimiento programado.
• No se puede volver a ver un token completo, ni siquiera un Administrador. Marko sólo guarda su huella (hash), nunca el valor.
• Todos los tokens tienen el mismo alcance. No hay forma de limitar uno a sólo lectura o a un endpoint concreto desde esta pantalla: cualquier token válido puede llamar a toda la API pública que tenga habilitada la empresa.
• «Último uso» es sólo una fecha. No hay un registro de qué llamó cada token, cuántas veces ni desde dónde.

Para consultar después

Cuando algo no sale