API keys
Acceso: Configuración → API keys
Una API key es la contraseña que usa un programa —tu ERP, una hoja de cálculo conectada, un cuadro de mando propio— para leer tus datos de Epinium sin entrar en la app. Esta pantalla es donde se crean, se les cambian los permisos y se anulan.
Aquí se explica la pantalla. Para saber qué información puedes consultar con una clave y cómo se usa desde un programa, mira la guía de la API.
¿Solo quieres conectar un asistente de IA?
No necesitas crear ninguna clave. Ve a Configuración → MCP y autoriza el asistente desde el navegador.
Las consultas consumen créditos
Cada llamada a la API gasta créditos de tu cuenta, los mismos que usan las funciones de IA. Los precios por recurso están en Configuración → Créditos, en el apartado API pública y conector MCP.
Dos cosas que ahorran disgustos: solo se cobra lo que se entrega, así que una llamada que falla no gasta nada; y en las consultas de métricas lo que cuesta es el rango de fechas, no el número de filas. Si te quedas sin créditos, la llamada se rechaza antes de ejecutarse y la respuesta indica qué acortar.
El detalle de las cabeceras de coste y de ese error está en la guía de la API.
Crear una clave
- Pulsa Crear API key
- Ponle un nombre que te recuerde para qué es (por ejemplo, integración ERP): es lo único que verás después para distinguirla
- Ajusta el acceso de cada área: la clave llega en solo lectura, que es lo que necesita casi cualquier integración. Si la tuya tiene que modificar algo, sube esa área a Editar
- Guarda y copia el secreto que aparece
- Pégalo en la herramienta que vaya a usarlo
El secreto solo se muestra una vez
Al crear la clave se ve su valor completo una sola vez. En cuanto cierras la ventana ya no se puede recuperar, ni desde Epinium ni desde soporte.
Los permisos
Cada clave alcanza solo las áreas que le abras, y con el nivel que les des. Dale el mínimo que la integración necesite: si mañana necesita más, se lo subes sin cambiar la clave.
| Área | Qué abre |
|---|---|
| Catálogo | Tus productos, marcas, países y agrupaciones de palabras clave, con sus métricas. En Editar, crear agrupaciones de palabras clave, cambiar sus palabras clave y sus productos, y borrarlas |
| Campañas | Campañas, carteras, grupos de anuncios, segmentaciones, anuncios de producto y términos de búsqueda, con sus métricas. En Editar, crear campañas y carteras y cambiar pujas, presupuestos y estado en Amazon |
| Conexiones | Las cuentas de Amazon y las tiendas de Shopify y WooCommerce conectadas a Epinium: qué tienes conectado, no lo que contiene |
| Datos de tus tiendas y plataformas conectadas | Lo que hay dentro de tus tiendas de Shopify y WooCommerce: productos, stock, precios y el resto de lo que expongan, y el registro de los cambios hechos en ellas. Es lo que usa un asistente de IA para consultar la tienda. En Editar, crear, editar y borrar productos y contenido directamente en la tienda, sin revisión previa |
| Tareas | Las tareas de Epinium y sus sugerencias. En Editar, crear tareas, aprobar o rechazar sus sugerencias y aplicar lo aprobado |
| CMO Brain | El catálogo de playbooks de marketing de Epinium |
| Flujos de trabajo | Tus automatizaciones, su configuración y el rendimiento de las campañas que optimizan |
Cada área se pone en uno de tres niveles: Sin acceso, Ver o Editar. Hoy admiten Editar las áreas de Catálogo, Campañas, Datos de tus tiendas y plataformas conectadas, Tareas y Flujos de trabajo, y Editar incluye Ver: una integración que escribe también lee.
Editar es de los planes Business y Master. En Free y Guru las claves leen y el nivel Editar aparece bloqueado. Si bajas a uno de esos planes, una clave que ya tenía Editar sigue sirviendo para leer, pero sus escrituras se rechazan.
Arriba tienes dos predeterminados que mueven todas las áreas a la vez: Acceso total y Solo lectura. Una clave necesita al menos un permiso: sin ninguno fallaría todas sus llamadas, así que no se puede guardar así.
Qué ves en la tabla
| Columna | Qué te dice |
|---|---|
| Nombre | El que le pusiste al crearla, con el prefijo debajo: los primeros caracteres del secreto, para reconocerla sin revelar el resto |
| Acceso | Un resumen en una etiqueta: Acceso total, Solo lectura, Personalizado (una combinación a medida) o Sin acceso en rojo, que significa que esa clave no funciona |
| Último uso | Cuándo se usó por última vez. Si pone Nunca usada, nadie ha llegado a conectarla |
| Creada | La fecha de alta |
La columna Último uso es la forma rápida de encontrar claves olvidadas: una que lleva meses sin usarse casi siempre sobra, y cada clave viva es una puerta abierta más.
Cambiar los permisos de una clave
Puedes editar una clave existente y subir o bajar el nivel de cada área. El cambio se aplica al instante y la clave sigue siendo la misma: no hay que tocar nada donde la tengas configurada.
Es la forma preferible de ampliar o recortar el alcance de una integración, porque evita generar un secreto nuevo y repartirlo otra vez.
Revocar una clave
Revocar anula la clave para siempre. Cualquier integración que la esté usando deja de funcionar de inmediato, así que conviene saber antes quién la usa: la columna Último uso y el nombre que le pusiste son la pista.
Una clave revocada no se puede reactivar. Si la integración tiene que volver a funcionar, se crea una nueva y se sustituye el secreto donde estuviera puesto.
Si pierdes el secreto
No se puede recuperar. El único camino es revocar la clave y crear otra, y después cambiar el secreto en la herramienta que lo usaba.
Por eso conviene guardarlo al crearlo en el gestor de contraseñas del equipo, y no en un correo o un chat.
Si eres una agencia
Esta sección aparece también en tu propia cuenta de agencia, igual que MCP y al contrario que Conexiones. Y dónde creas la clave cambia su alcance:
- Creada en tu cuenta de agencia, la clave es tuya y alcanza las cuentas que tus clientes te han compartido. Cada consulta tiene que decir sobre cuál opera.
- Creada dentro de la cuenta de un cliente, la clave es de ese cliente y solo alcanza sus conexiones.
Si lo que quieres es conectar un asistente de IA, no necesitas clave: mira Configuración → MCP.