Descripción general
Las claves de API te permiten conectar Dashboardly con un asistente de IA como ChatGPT, Claude o Cursor para que el asistente pueda responder preguntas sobre los datos de tu TikTok Shop en lenguaje natural. Preguntas "¿Cuál fue mi Net Profit la semana pasada?" o "¿Qué SKU se vendió más ayer en mi tienda del Reino Unido?" y el asistente obtiene la respuesta directamente de tus datos en vivo de Dashboardly.
La conexión utiliza un estándar abierto llamado Model Context Protocol (MCP), que cualquier asistente de IA moderno puede usar. Generas una clave de API por asistente (o una por tienda), la pegas en la configuración del asistente y la conversación queda conectada a tus datos.
Las claves de API son de solo lectura. Un asistente de IA puede leer cualquier métrica que tú puedas ver en Dashboardly, pero no puede crear pedidos, cambiar costos de productos, editar configuraciones, enviar reembolsos ni modificar nada en tu TikTok Shop o en tu cuenta de Dashboardly.
Administras todas las claves en la página Settings > API Keys.
Requisitos de plan
Las claves de API forman parte de la función de Integraciones de IA de Dashboardly, disponible en los siguientes planes:
| Plan | Claves de API incluidas |
|---|---|
| Brand Starter | No disponible |
| Brand Growth | Disponible |
| Brand Pro | Disponible |
| Brand Elite | Disponible |
Si tienes el plan Brand Starter, la pestaña API Keys en Settings muestra un aviso para actualizar. Actualiza tu suscripción en la página Settings > Subscriptions para habilitar la función.
No hay ninguna tarifa por clave. Puedes crear tantas claves como quieras en un plan elegible, sin cargo adicional por las consultas que haga tu asistente de IA.
Cómo funciona
Cuando creas una clave de API en Dashboardly, ocurren dos cosas:
- Se genera la clave. Tiene el aspecto
dk_live_...seguido de una larga cadena aleatoria. Ves la clave completa exactamente una vez, en el momento de la creación. Después de eso, Dashboardly almacena solo una huella de ella, por lo que ni siquiera nuestro equipo de soporte puede recuperar la clave completa más adelante. - La clave queda vinculada a tu cuenta. Cada clave está asociada a tu inicio de sesión de Dashboardly y, opcionalmente, a un único TikTok Shop. Cuando un asistente de IA usa la clave para solicitar datos, recibe exactamente lo que verías si abrieras esa tienda en tu navegador.
Tu asistente de IA se conecta a un endpoint de Dashboardly (el servidor MCP) y presenta la clave. El endpoint verifica la clave, comprueba qué tienda puede leer la clave y devuelve los datos solicitados. Cada solicitud se registra para que puedas ver con qué frecuencia tu asistente usa la clave y qué preguntas hace.
Como la clave es de solo lectura, el asistente no tiene forma de cambiar nada. La acción más "destructiva" que puede realizar es leer una métrica.
Paso a paso: crea tu primera clave de API
Paso 1: Abre la página API Keys
Ve a Settings > API Keys en la barra lateral izquierda. Si no ves la pestaña, comprueba que tu suscripción sea Brand Growth o superior.
Paso 2: Haz clic en "New API key"
En la esquina superior derecha de la página, haz clic en el botón + New API key. Se abre un pequeño formulario.
Paso 3: Completa los detalles
- Name -- Una etiqueta para que puedas reconocer la clave más adelante. Usa algo descriptivo como "Claude Desktop -- Tienda US" o "ChatGPT para John". Los nombres solo son visibles para ti.
- Shop -- Elige una sola tienda, o deja el campo en "All shops" para dar a la clave acceso a todas las tiendas que tengas conectadas. La mayoría de los usuarios prefieren una clave por tienda, de modo que cada conversación de IA quede automáticamente acotada a los datos correctos.
- Expires in -- Cuántos días faltan para que la clave deje de funcionar automáticamente. El valor predeterminado es 365 días. Las caducidades más cortas son más seguras; las más largas significan que no tienes que rotar la clave tan a menudo. Puedes revocar una clave en cualquier momento, independientemente de su caducidad.
Paso 4: Haz clic en "Create key"
Dashboardly genera la clave y la muestra en un panel de confirmación. La clave se muestra completa solo esta única vez.
Paso 5: Copia la clave de inmediato
Haz clic en el botón Copy para poner la clave en el portapapeles. Pégala en un lugar seguro (el archivo de configuración de tu asistente, un gestor de contraseñas o una nota segura). Si cierras el panel sin copiarla, tienes que revocar la clave y crear una nueva -- no hay forma de recuperarla de nuevo.
Paso 6: Conecta tu asistente de IA
Abre la configuración de tu asistente de IA y agrega Dashboardly como una conexión (la ruta exacta varía según el asistente; consulta la siguiente sección para obtener orientación sobre cada uno).
Paso 7: Confirma la conexión
Hazle a tu asistente una pregunta sencilla como "¿Cuál es mi Net Profit de la semana pasada?". Si todo está configurado correctamente, el asistente responde con la respuesta obtenida de tus datos en vivo de Dashboardly. Si ves un error, consulta ¿Por qué no funciona mi asistente de IA?.
Conexión de un asistente de IA
La configuración exacta depende de qué asistente uses. Después de crear la clave en Dashboardly, el panel de confirmación muestra fragmentos de configuración listos para pegar para las herramientas más populares.
Claude (escritorio y web)
En la configuración de Claude, busca una sección llamada Connectors, Integrations o MCP servers. Agrega una nueva conexión pegando la URL del endpoint de Dashboardly y tu clave de API. Una vez guardada, Claude muestra Dashboardly como una conexión disponible en cualquier conversación.
Si usas Claude Desktop, la conexión se agrega a un archivo de configuración que se carga al iniciar Claude. El panel de confirmación en Dashboardly muestra el texto exacto que debes pegar.
ChatGPT
En ChatGPT, abre el menú Apps & Connectors y agrega Dashboardly como conector personalizado. Pega la URL del endpoint y la clave de API cuando se te solicite. ChatGPT recuerda la conexión en todas tus conversaciones.
Cursor
En Cursor, abre Settings > MCP, haz clic en Add new MCP server y pega el endpoint y la clave de Dashboardly. Cursor usa la conexión mientras programas, de modo que puedes hacer preguntas como "¿Cuál es mi SKU más vendido este mes?" sin salir de tu editor.
Otros asistentes de IA
Cualquier asistente que use el Model Context Protocol puede conectarse. Proporciona al asistente la URL del endpoint MCP de Dashboardly y la clave de API (trátala como una contraseña). El asistente debería descubrir automáticamente qué datos están disponibles.
Qué puede hacer tu asistente de IA
Una vez conectado, tu asistente puede responder preguntas sobre todas las áreas principales de los datos de tu tienda. Haces preguntas en lenguaje natural (o en cualquier idioma que admita tu asistente) y el asistente decide qué datos obtener.
| Tema | Preguntas de ejemplo |
|---|---|
| Cuenta y tiendas | "¿Qué tiendas están conectadas?" "¿Cuál es el correo electrónico de mi cuenta?" |
| Resumen del Dashboard | "Dame un resumen rápido de la semana pasada." "¿Cómo están evolucionando las ventas en comparación con el mes pasado?" |
| Profit & loss | "¿Cuál fue mi Net Profit en marzo?" "Desglosa mi P&L por semana del último trimestre." |
| Pedidos | "¿Cuántos pedidos recibí ayer?" "Muéstrame los pedidos cancelados de los últimos 7 días." |
| Productos principales | "¿Qué SKU se vendieron más el mes pasado?" "¿Cuáles fueron mis 10 productos principales por ingresos este trimestre?" |
| Reembolsos | "¿Cuánto reembolsé la semana pasada?" "¿Qué productos tienen la mayor tasa de devolución?" |
| Clientes | "¿Cuántos clientes recurrentes tengo?" "¿Cuál es el valor de vida de mi cliente promedio?" |
| Marketing y anuncios | "¿Cuál fue mi ROAS en TikTok Ads la semana pasada?" "¿Cómo están rindiendo mis campañas publicitarias?" |
| Transmisiones en vivo y promociones | "¿Qué transmisiones en vivo generaron más ventas el mes pasado?" "¿Cuánto ahorré con los subsidios de la plataforma en abril?" |
| Inventario | "¿Qué SKU tienen poco stock?" "¿Cuál es el valor actual de mi inventario?" |
| Desglose geográfico | "¿De dónde provienen la mayoría de mis pedidos?" "¿Cómo van las ventas en Alemania este mes?" |
| Métricas por hora | "¿Qué hora del día recibe la mayor cantidad de pedidos?" "Muéstrame las ventas de ayer hora por hora." |
El asistente no puede realizar acciones en tu TikTok Shop ni en Dashboardly. Solo puede leer.
Administración de tus claves
Visualización de claves
La página Settings > API Keys muestra cada clave que has creado con su nombre, los primeros caracteres de la clave (para que puedas reconocerla), la tienda a la que está vinculada, cuándo se creó, cuándo se usó por última vez y cuándo caduca.
Inspección del uso
Haz clic en cualquier clave activa para expandir un panel de uso que muestra:
- Llamadas totales en los últimos 30 días
- Tasa de éxito (llamadas que devolvieron datos correctamente)
- Tiempo de respuesta promedio para que sepas que la conexión es rápida
- Un gráfico de actividad diaria de los últimos 7 días
- Las herramientas de datos más utilizadas para que puedas ver qué solicita más el asistente
Esto es útil para confirmar que una clave se está usando, detectar actividad inusual o ver en qué tiende a centrarse tu asistente.
Revocación de una clave
Si una clave se pierde, queda expuesta o ya no se necesita, haz clic en el icono Revoke junto a ella. Dashboardly bloquea de inmediato cualquier solicitud posterior que use esa clave. Los asistentes de IA conectados con la clave revocada verán un error en su siguiente pregunta.
La revocación es instantánea. No hay período de gracia.
Caducidad de la clave
Cada clave tiene una fecha de caducidad establecida cuando la creas. Dashboardly muestra una insignia de advertencia en la página API Keys cuando a una clave le quedan 14 días o menos. Las claves caducadas dejan de funcionar automáticamente -- no es necesario revocarlas.
Para rotar una clave de forma periódica, crea una nueva clave, actualiza tu asistente de IA para que la use y luego revoca la antigua.
Aplicaciones conectadas
Algunos asistentes de IA (en particular ChatGPT) se conectan mediante un flujo de inicio de sesión con un solo clic en lugar de exigirte que copies una clave de API. Cuando concedes a Dashboardly acceso a uno de estos asistentes, aparece en la sección Connected Apps en la parte inferior de la página API Keys.
Para cada aplicación conectada puedes ver su nombre, cuándo se conectó por primera vez, cuándo estuvo activa por última vez y dos formas de desconectarla:
- Revoke -- Bloquea nuevos inicios de sesión desde ese asistente. Las sesiones activas siguen siendo válidas hasta por una hora y luego caducan.
- Sign out now -- Desconecta el asistente de inmediato, cerrando cualquier sesión activa. Usa esto si sospechas que se está haciendo un uso indebido de la conexión.
Seguridad y privacidad
Las claves de API son sensibles. Trata cada clave como una contraseña.
- Nunca incluyas una clave en un repositorio de código público. Si lo haces accidentalmente, revócala desde Dashboardly y genera una nueva.
- Nunca compartas una clave en un mensaje de chat, correo electrónico o captura de pantalla. Cualquiera que tenga la clave puede leer tus datos hasta que la revoques.
- Usa una clave por asistente o por dispositivo. De esa manera, si una clave se ve comprometida en un dispositivo, puedes revocar solo esa clave sin afectar a tus otras conexiones.
- Establece una caducidad razonable. Una clave que caduca en 90 días es más segura que una que dura para siempre. Siempre puedes crear una nueva.
Dashboardly nunca muestra la clave completa después de la creación. El único lugar para encontrarla es donde la guardaste cuando se generó la clave.
Todas las solicitudes de los asistentes de IA se realizan a través de HTTPS. Cada solicitud se registra con una marca de tiempo y el área de datos que consultó. Puedes auditar este historial por clave desde el panel de uso descrito anteriormente.
Solo lectura significa solo lectura: incluso si una clave se viera comprometida, un atacante podría ver tus datos, pero no podría cambiar ni un solo costo de producto, enviar un reembolso ni afectar de ninguna manera tu TikTok Shop.
Preguntas frecuentes
¿Mi asistente de IA ve toda mi cuenta de Dashboardly o solo una tienda?
Depende de cómo configuraste la clave. Si vinculaste la clave a una sola tienda, el asistente solo ve esa tienda. Si dejaste seleccionada "All shops", el asistente puede leer datos de todas las tiendas de tu cuenta. La mayoría de los usuarios prefieren una clave por tienda por claridad.
¿Puedo crear claves diferentes para distintos miembros del equipo?
Sí. Crea una clave con nombre por persona ("Claude -- Maria", "ChatGPT -- John") y comparte cada clave solo con la persona que la necesita. Si alguien deja el equipo, revoca su clave sin afectar a los demás.
¿Usar un asistente de IA me costará algo adicional?
No. Dashboardly no cobra ninguna tarifa por consulta. El proveedor de tu asistente de IA (OpenAI, Anthropic, etc.) te factura por separado por el asistente en sí, según su propia tarifa.
¿Qué tan actualizados están los datos que ve mi asistente?
Exactamente tan actualizados como lo que ves en Dashboardly. Si el panel muestra una métrica actualizada hace 2 minutos, eso es lo que recibe el asistente. Los números basados en la liquidación (comisiones, impuestos) pueden ser estimados para pedidos muy recientes -- consulta ¿Por qué se retrasan mis datos? para conocer todos los detalles.
¿Puede mi asistente de IA realizar cambios en mi tienda?
No. Cada clave de API es de solo lectura. No existe un modo de "escritura" ni hay planes de agregar uno. Lo máximo que puede hacer un asistente es resumir los números que lee.
¿Qué pasa con mis claves antiguas si reduzco mi plan?
Si reduces tu plan a Brand Starter, todas las claves de API existentes dejan de funcionar de inmediato. Vuelve a actualizar a Brand Growth o superior para reactivarlas, o crea nuevas claves después de actualizar.
¿Puedo ver qué ha estado preguntando mi asistente de IA?
Sí. El panel de uso de cada clave muestra las áreas de datos más utilizadas (pedidos, P&L, productos principales, etc.) y un gráfico de actividad de 7 días. No registramos las preguntas en lenguaje natural que escribió el usuario -- solo qué herramientas de datos invocó el asistente.