Cómo obtener tu API Key

Una API Key es la única credencial que necesitas para integrar Neuroon. Vale para sincronizar productos, generar Widget Tokens, registrar conversiones y consultar analytics.

Pasos

1. Crea tu cuenta

Abre el Dashboard de Neuroon. Si es la primera vez, haz click en Empezar / Registrar y sigue el flujo (Google OAuth o email).

2. Registra tu tienda

Una vez dentro, Tiendas → Crear tienda. Rellena:

• Nombre: lo que tú quieras (no es público).
• URL: el dominio canónico de tu tienda (https://tutienda.com). Importante: este dominio se usará para validar el widget. Si lanzas en staging.tutienda.com y tutienda.com, contacta a soporte para añadir orígenes adicionales.
• Plataforma: WooCommerce o Genérico (custom). Si tu stack no es WordPress + WooCommerce, elige Genérico — los recipes cubren Next.js, Nuxt y cualquier backend con HTTP + JSON. Si eliges Genérico, antes de nada tendrás que verificar tu dominio añadiendo un registro DNS TXT — sin eso no podrás sincronizar productos ni el widget funcionará.

3. Copia tu API Key

Tras crear la tienda, ve a la configuración de la tienda (Settings / Integrations). Ahí encontrarás tu API Key. Cópiala y guárdala en tu secret manager.

4. Guárdala como variable de entorno

En tu servidor (NUNCA en frontend ni HTML):

NEUROON_API_URL=https://api.neuroon.ai
NEUROON_API_KEY=tu_api_key_aqui

5. Verifica que funciona

curl https://api.neuroon.ai/api/integrations/v1/shop \
-H "Authorization: Bearer $NEUROON_API_KEY"

Debería devolver 200 con tu shop info y cuotas. Si recibes 401, revisa la key.

Producción vs Desarrollo

Cada entorno tiene su propia API Key y son independientes. Usa el selector de entorno del navbar para ver las URLs de cada uno:

Entorno	Dashboard	API
Producción	Dashboard Prod	https://api.neuroon.ai
Desarrollo	Dashboard Dev	https://dev-api.neuroon.ai

Empieza siempre integrando contra Desarrollo. Cuando todo funcione, cambia las URLs y la key a Producción.

Buenas prácticas

• Rota la key cada 6-12 meses o cuando un colaborador deja el equipo.
• Una key por entorno (no compartir entre prod y dev).
• No commitees la key a git. Usa .env ignorado por .gitignore o un secret manager.
• No la imprimas en logs públicos, error pages o respuestas HTTP.

Siguientes pasos

Tienes la API Key. Ahora ve al Quickstart para sincronizar tu primer producto y embeber el widget en 10 minutos.