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
- Marca los permisos que necesite
- 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 lleva los permisos que le marques, y solo alcanza lo que esos permisos abren. Marca los mínimos que la integración necesite: si mañana necesita más, se los añades sin cambiar la clave.
| Permiso | Le deja consultar |
|---|---|
| Catálogo (lectura) | Tus productos, marcas, países y clusters |
| Campañas (lectura) | Campañas, grupos de anuncios, targets, anuncios de producto y términos de búsqueda |
| Conexiones (lectura) | Las cuentas de Amazon conectadas a Epinium |
| Tareas (lectura) | Las tareas de Epinium y sus sugerencias |
| Skills (lectura) | El catálogo de playbooks de marketing de Epinium |
| Workflows (lectura) | Tus automatizaciones, su configuración y a qué campañas llegan |
| Workflows (escritura) | Además de consultarlas, cambiar la configuración de tus automatizaciones |
Una clave sin ningún permiso marcado no puede consultar nada.
Qué ves en la tabla
| Columna | Qué te dice |
|---|---|
| Nombre | El que le pusiste al crearla |
| Prefijo | Los primeros caracteres del secreto. Sirven para reconocer una clave cuando tienes varias, sin revelar el resto |
| Permisos | A qué llega esa clave |
| Ú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 marcar o desmarcar permisos. 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.