Alta de tienda nueva Todo lo que tienes que hacer tú a mano. Lo demás lo hace Claude solo.
Sígueme con el móvil en la mano mientras trabajas en el ordenador.

Fase 0 · 5 min

Antes de empezar

Decisiones. Sin esto, todo lo demás se queda a medias.

Ten decididas las cuatro cosas

Escríbelas en un papel antes de tocar nada.

  • Nombre de marca — es el que usarás en el dominio, en la página de Facebook y en Instagram. Que sea el mismo en los tres sitios.
  • Dominio — el .es que vas a comprar.
  • Precios — precio de venta y coste, para saber si el margen aguanta la publicidad.
  • Producto elegido — el ganador, ya validado. No se empieza el alta "a ver qué vendo".
Decisión

Si cambias el nombre de marca a mitad, tiras la página de Facebook y el dominio. Decídelo ahora, no en la Fase 2.

El correo no hay que contratarlo aparte

Si ya usas el correo de Hostinger, ya está resuelto.

No pagues un buzón nuevo por cada tienda. Los correos al cliente (confirmación de pedido, envío, devolución) los manda Shopify desde sus propios servidores, no desde tu buzón.

✅ Sabes que va bien si…

Puedes decir en voz alta el nombre de la marca, el dominio exacto y el precio de venta sin dudar.

↑ Volver al índice

Fase 1 · 5 min + espera

Dominio

Comprar, apuntar el DNS y sacar el token de API.

Compra el dominio en Hostinger

Busca el .es de la marca y págalo.

Decisión · el precio de 0,01 €

Ese precio de escaparate solo aplica contratando 3 años o más. A 1 año son 6,99 €. Si la tienda es un test, paga el año y ya está; si vas en serio con la marca, los 3 años salen a cuenta.

Decisión · el correo de pago

En el carrito te va a ofrecer el plan de correo. No lo contrates si no lo necesitas. Shopify manda los correos al cliente desde sus propios servidores.

Abre la pantalla de DNS / Nameservers

hPanel → Dominios → tu dominio → DNS / Nameservers. Déjala localizada.

Pantalla de DNS y Nameservers del dominio en el hPanel de Hostinger
Esta es la pantalla. Los registros los mete Claude después con dns-shopify.sh; tú solo tienes que saber llegar aquí.

Comprueba que el dominio está delegado

Pega esto en el Terminal cambiando el dominio.

dig +short NS tudominio.es @a.nic.es
Dato útil

Un .es recién comprado tarda de 15 minutos a 24 horas en delegarse. Si el comando sale vacío no es propagación: es que el registro todavía no tiene el dominio. No hay nada que arreglar, es esperar. No toques los DNS ni vuelvas a comprar nada.

Crea el token de API de Hostinger

Es lo que deja a Claude tocar los DNS por ti. Se hace una sola vez.

  • hPanel → tu foto de perfil (arriba a la derecha) → Cuenta → API.
  • Nombre: athenia-claude.
  • Caducidad: sin caducidad.
  • Copia el token y guárdalo con este comando:
mkdir -p ~/.athenia-tools && pbpaste > ~/.athenia-tools/hostinger.key && chmod 600 ~/.athenia-tools/hostinger.key
Error que nos costó tiempo

El token solo se muestra una vez. Si cierras la ventana sin copiarlo, se acabó: hay que borrarlo y generar otro, y mientras tanto Claude no puede tocar los DNS y el alta se para.

✅ Sabes que va bien si…

dig +short NS tudominio.es @a.nic.es devuelve algo (los nameservers de Hostinger). Si devuelve vacío, sigue con la Fase 2 y vuelve luego: no bloquea nada.

↑ Volver al índice

Fase 2 · 5 min

Página de Facebook

La página es obligatoria para anunciarse. Se crea desde tu perfil personal.

Entra en el creador de páginas

Ve a facebook.com/pages/create con tu perfil personal ya logueado.

Pantalla de creación de página de Facebook con nombre y categoría
Nombre de la página a la izquierda, vista previa a la derecha.

Nombre = la marca. Categoría = Shopping & retail

Escribe el nombre exacto de la marca y elige esa categoría, solo esa.

Error que nos costó tiempo

NUNCA elijas "Salud y belleza" ni "Producto médico", aunque Facebook te lo sugiera por el producto. Si lo haces, la página entra en la revisión de anuncios de salud y a partir de ahí Meta te rechaza los creativos uno detrás de otro. Se arregla tarde y mal.

Dato útil

Si la interfaz te sale en inglés, escribir "tienda" no filtra nada. Escribe directamente "Shopping".

Paso 1 de 5 · Datos de contacto

Rellena web, teléfono y correo. Nada más.

Paso 1 de 5: datos de contacto de la página, web, teléfono y correo
Ojo al prefijo del teléfono: viene por defecto en US +1. Cámbialo a ES +34.
Error que nos costó tiempo

Deja Location y Hours VACÍOS. Si pones la dirección, Facebook trata la página como negocio físico: la mete en el mapa, activa las valoraciones de ubicación y te aparece gente en la puerta preguntando por el producto. No es una tienda física.

Paso 3 de 5 · Salta WhatsApp

No conectes el número aquí. Pasa de largo.

Paso 3 de 5 del asistente: conectar WhatsApp, hay que saltarlo
Este paso se salta entero.
Error que nos costó tiempo

Un número de teléfono solo puede estar en un sitio a la vez: o en la app de WhatsApp Business, o en la Cloud API. Si lo conectas aquí, lo atas a la app — y luego, para automatizar las confirmaciones de pedido, hay que desvincularlo, esperar y volver a verificarlo. Media mañana perdida.

Pasos 4 y 5 · Salta fotos y no invites a amigos

Terminar el asistente sin añadir nada más.

  • Fotos: saltar. Las pone Claude con el kit de marca.
  • Invitar amigos: NO.
Error que nos costó tiempo

Si invitas a tus amigos, ensucias el público que Meta aprende de la página: te da seguidores que no compran y el algoritmo empieza a buscar más gente como ellos. Los primeros días de campaña salen caros por esto.

✅ Sabes que va bien si…

La página existe y en su resumen pone la categoría "Shopping & retail".

↑ Volver al índice

Fase 3 · 10 min

Acceso al negocio y 2FA

La parte que más se atasca. Léela entera antes de empezar a pinchar.

El negocio no te aparece en la lista

Es normal. Avisa a Claude y él te invita como administrador.

Lista de negocios en business.facebook.com donde falta Athenia.agency
Athenia.agency no está en la lista. Ese es el problema.
Error que nos costó tiempo · corregido el 13-sep-2026

El negocio lo creó una aplicación por API, y su único administrador figura como "UnclaimedBusinessUser FromPool". Se intentó invitarte por API con POST /{business}/business_users y no funcionó: el negocio se queda sin invitaciones pendientes y tú sigues sin verlo, así que no puedes ponerle tarjeta ni conectar la app de Facebook e Instagram — es decir, no hay píxel.

La regla nueva, para no repetirlo: los activos de Meta (cuenta publicitaria y píxel incluidos) los creas tú desde tu cuenta, en tu propio negocio. Claude no los crea por API. Si ya hay un negocio huérfano de una tienda anterior, olvídalo y empieza en el tuyo.

Acepta la invitación desde el Gmail

Solo si alguien te ha invitado a un negocio que ya existe. Con la regla nueva no hace falta: sáltatelo.

Este paso ya no aplica

Era el intento de rescatar el negocio huérfano creado por API, y no funcionó: la invitación no llega. Si creas la cuenta publicitaria en tu propio negocio, no hay nada que aceptar. Se deja escrito para que nadie vuelva a intentarlo.

Si alguna vez sí recibes una invitación real: no estar logueado en Facebook en ese navegador hace que el enlace te mande a un login y luego se pierda. Loguéate primero, abre el correo después.

Te pide 2FA aunque ya seas administrador

Verás "Full access: Everything" con un aviso rojo encima.

Aviso de que hace falta autenticación en dos pasos para administrar el negocio
Tienes el acceso, pero está bloqueado hasta que actives 2FA.
Dato útil

El negocio tiene two_factor_type: all_required. Sin 2FA no se puede administrar aunque seas administrador. No es un fallo, es la configuración del negocio.

El atajo: no sigas por donde te lleva Facebook

Cierra lo que te ofrece y entra directo a la pantalla buena.

ATAJO IMPORTANTE — esto es lo que ahorra media hora

Facebook te empuja hacia la passkey. En un Mac sin llavero de iCloud activado eso es un callejón sin salida: acaba pidiéndote meter tu cuenta de Apple entera en el ordenador solo para guardar una llave.

No sigas por ahí. Cierra esa ventana con la X o con "Not now" y ve directo a:

accountscenter.facebook.com/password_and_security
Pantalla de protección avanzada de Facebook empujando hacia la passkey
Así empieza la trampa: la pantalla de protección avanzada.
Diálogo del sistema pidiendo iniciar sesión con la cuenta de Apple para guardar la passkey
Y así acaba: pidiéndote la cuenta de Apple. Si ves esta ventana, cancela.

Elige la cuenta correcta

Te va a listar todas tus cuentas. Elige la de Facebook.

Selector de cuenta para activar la autenticación en dos pasos
Perfil personal de Facebook. No Instagram, no la página.
Error que nos costó tiempo

Si activas el 2FA en una cuenta de Instagram o en la página, el negocio te sigue bloqueando igual y encima crees que ya está hecho. El 2FA que exige el negocio es el de la persona: tu perfil de Facebook.

Elige "Authentication app"

App de autenticación, nunca SMS.

Elección del método de 2FA: aplicación de autenticación
SMS no: se pierde con el cambio de número y con el roaming.

Escanea el QR y mete los 6 dígitos

Con la misma app de autenticación que usas para Hostinger.

Error que nos costó tiempo

La clave en texto que aparece junto al QR es la llave maestra del 2FA: con ella cualquiera genera tus códigos. No la mandes por chat ni la guardes en texto plano — va al gestor de contraseñas. Los códigos de recuperación sí conviene guardarlos: son los que te salvan si pierdes el móvil.

Confirma que el 2FA está activo

Tiene que poner "Two-factor authentication is on".

Pantalla confirmando que la autenticación en dos pasos está activada
Si no ves este cartel, no está activo.

Vuelve a los negocios: ya aparece

Recarga business.facebook.com.

El negocio ya aparece en la lista de business.facebook.com
El negocio con sus cuentas y sus páginas. Fase 3 superada.
✅ Sabes que va bien si…

El negocio aparece en business.facebook.com con sus cuentas y sus páginas dentro.

↑ Volver al índice

Fase 4 · 5 min

Enganchar la página y pagar

Lo último tuyo. Después ya trabaja Claude.

Mete la página en el negocio

business.facebook.com/settings/pages → elige el negocio → botón azul Add.

Desplegable Add con las tres opciones para añadir una página al negocio
Tres opciones. Solo una es la buena.
Error que nos costó tiempo

Elige "Add an existing Facebook Page". Las otras dos no:

• Request shared access es para agencias que piden permiso sobre la página de un cliente — se queda esperando una aprobación que nunca llega porque la página es tuya.
• Create a new Facebook Page te crea una página duplicada, y acabas anunciándote desde la vacía.

Añade la tarjeta a la cuenta publicitaria

business.facebook.com/settings/ad-accounts → cuenta de la marca → Configuración de pagos → añadir tarjeta.

Dato útil

Sin método de pago, la cuenta no puede gastar aunque la campaña esté creada y activa. Se queda sin entregar y no avisa en la cara.

Crea el Instagram de la marca

Desde la app del móvil: cuenta nueva → pasar a profesional (categoría Tienda) → vincular a la página.

  • Créalo desde la app del móvil.
  • Pásalo a cuenta profesional, categoría Tienda.
  • Vincúlalo a la página desde el Centro de cuentas.
Decisión

No reutilices una cuenta de Instagram de otra marca. El público y el contenido no tienen nada que ver, y ensucia lo que Meta aprende sobre a quién enseñarle tus anuncios.

✅ Sabes que va bien si…

tienda-estado.sh <carpeta> <dominio> <slug> dice que hay método de pago y PAGE_ID.

↑ Volver al índice

Fase 5 · 20 min

La tienda Shopify

Abrirla bien, sacar el token y dejar los ajustes que ninguna app puede tocar.

Abre la tienda tú, en shopify.com

Ve a shopify.com/es/prueba-gratis y créala con tu correo. Sin intermediarios.

Error que nos costó una tarde entera

NO abras la tienda a través de un tercero tipo storebuild.ai. Te la crean bajo su cuenta de Shopify Partners y después te la transfieren. Al transferirse, la tienda sale de la organización de ellos y no entra en la tuya. Se queda huérfana.

Qué pasa si te lo saltas: ninguna app propia se puede instalar — ni la tuya ni la del proveedor. Todos los botones dan error y no hay ningún mensaje que te diga por qué. Se pierde la tarde entera hasta dar con el camino bueno.

storebuild.ai pidiendo nombre, correo y teléfono para reclamar la tienda
Así empieza: te piden los datos para "reclamar tu tienda". Aquí es donde hay que cerrar la pestaña.
Pantalla de storebuild.ai avisando de que la tienda está lista para reclamarla en Shopify
La transferencia. Parece un regalo y es el origen del problema.
Decisión · el correo

Usa un correo sin cuenta previa de Shopify. Si el correo ya tuvo una tienda, pierdes la promo de 1 $/mes durante 3 meses y pasas a pagar tarifa completa desde el primer día.

Si ya te la transfirieron: qué te llega de verdad

Comprueba el plan y el contenido antes de dar nada por hecho.

Panel de inicio de Shopify recién transferido, completamente vacío
La tienda llega vacía: ni tema profesional ni productos, aunque te lo prometan. Te toca montarla igual.
Dato útil

La transferencia no cuesta la promo: el plan Basic se queda en 1 $/mes hasta el 15-dic-2026. Y ahí ves las comisiones reales de tarjeta: 2,1 % + 0,30 € online. Mételas en tus números, no en el "ya veremos".

Pantalla de Plan en Shopify: Basic a 1 dólar al mes hasta el 15 de diciembre de 2026 y recargos por tarjeta
Configuración → Plan. Confirma el precio y la fecha de fin de promo.

Token de API · entra por el admin DE ESA tienda

admin.shopify.com → tu tienda → Configuración → Apps y canales de venta → Desarrollar apps → Build apps in Dev Dashboard.

Apps y canales de venta dentro del admin de la tienda, con el botón Desarrollar apps
Este es el camino bueno: dentro de la tienda, no desde fuera.
Botón Desarrollar apps en Dev Dashboard dentro de la configuración de la tienda
El botón negro. Desde aquí el Dev Dashboard se abre ya con la organización correcta.
Error que nos costó tiempo

El Dev Dashboard no tiene selector de organización: el contexto te lo da la puerta por la que entras.

Qué pasa si te lo saltas: si abres dev.shopify.com directamente, caes en otra organización, creas la app ahí y no se puede instalar en tu tienda. Todo lo que hagas después está mal y no te avisa nadie.

Crea la app y publica los alcances

Create app → nombre → Versions → pegar alcances → App URL cualquiera → Release.

Los alcances van separados por comas, en una sola línea. Estos están probados y funcionan:

write_products,write_content,write_themes,write_shipping,write_orders,write_discounts
Error que nos costó tiempo

write_inventory exige read_locations. Si pides uno sin el otro, Shopify rechaza la concesión entera — no solo ese alcance — y la instalación revienta sin decirte cuál falla.

Dev Dashboard con la app Athenia Claude creada y 0 instalaciones
App creada y publicada, con 0 instalaciones. Todavía no sirve: falta instalarla.

Instálala desde Home → Installs

Home → Installs → "Install app" → elegir la tienda → Instalar.

Dato útil

Ese botón es el instalador oficial y es el que nunca se encuentra. Está en Home, no en Settings ni en Versions. Búscalo ahí y ya está.

Selector de tienda al instalar la app en Shopify
Elige la tienda. Si aquí no sale la tuya, entraste por la organización equivocada.
Pantalla de permisos Instalar app con los accesos que pide la app
Los permisos que pediste en los alcances. Dale a Instalar.
La app ya instalada apareciendo en el menú Apps de la tienda
La app ya aparece en el menú Apps de la tienda. Esto es lo que confirma que ha funcionado.

Copia las credenciales

Settings → Credenciales → copia el ID de cliente y el Secreto.

Pantalla de credenciales de la app con el ID de cliente y el secreto
Las dos piezas. El secreto solo se ve una vez: cópialo ya.
Dato útil

El token se pide con client_credentials y caduca a las 24 h. No pasa nada: se renueva solo. No hay que volver a esta pantalla cada día.

Callejones sin salida verificados hoy

Todos estos los hemos pisado. Léelos para no repetirlos.

Sección Tiendas del Dev Dashboard vacía, ofreciendo solo crear una tienda en desarrollo
"Tiendas" del Dev Dashboard sale vacío. No es un fallo: ahí solo se listan tiendas de desarrollo.
"Crear tienda en desarrollo"

Qué pasa si lo pulsas: te crea una tienda de pruebas nueva que no es la tuya, sin dominio ni pagos, y te pasas un rato configurando una tienda que no sirve para vender.

Error: No se puede usar este enlace de instalación
No se puede usar este enlace de instalación.
Los enlaces /oauth/install?client_id=…

No son una ruta documentada y no funcionan. Qué pasa si insistes: te pasas media hora cambiando parámetros de una URL que nunca iba a ir, convencido de que te falta una letra.

Error de OAuth failed_grant_with_invalid_scopes al instalar la app
failed_grant_with_invalid_scopes. El mensaje te miente.
El error que más despista

failed_grant_with_invalid_scopes no significa que un alcance esté mal escrito. Lo provoca que la app no tenga concesión posible en esa tienda, o pasar scope= en la URL sin el flujo heredado.

Qué pasa si te lo crees: te pones a quitar y poner alcances uno a uno durante una hora, y el problema estaba en la organización de la app.

Dos cosas que ya no existen

• El "Token de automatización" (atkn_) NO es un token de Admin API: es para la CLI en CI/CD. Da 401 siempre, con cualquier llamada.
• No existe la sección "Distribución" en apps de comerciante: solo aparece en apps creadas desde Partners. Si la buscas y no está, no es un despiste tuyo.
• Las apps personalizadas heredadas (crear la app dentro del admin) están muertas desde el 1-ene-2026.

Los ajustes que ninguna app puede tocar

Esto es tuyo a mano, sí o sí. Ve tachando.

Verificado por introspección de GraphQL

No existen las mutaciones shopUpdate, ni de dominios, ni de métodos de pago, ni de preferencias de tienda, ni de checkout. No es cuestión de permisos: Shopify no se lo expone a ninguna app, porque son cosas de dinero, identidad y consentimiento. No pierdas tiempo buscando la llamada: no está.

La zona horaria

Las tiendas vienen en America/New_York. Qué pasa si no la cambias: seis horas de desfase — te bailan las horas de corte del proveedor, los informes salen del día equivocado y crees que un día no vendiste nada.

Ojo · dos secciones que se confunden

"Información comercial" son los datos fiscales de la empresa (ahí va el domicilio social). "Perfil de la tienda" son nombre y correos. Están en la misma pantalla y es muy fácil rellenar la que no es.

✅ Sabes que va bien si…

El token responde 200 a /admin/api/2026-07/shop.json.

↑ Volver al índice

Fase 6 · 10 min

El proveedor (Dropea)

Lo que Dropea hace y lo que NO hace. Léelo antes de prometer nada al cliente.

Las devoluciones son tuyas

Prepara tu propia política y tu dirección de devoluciones antes de vender.

Error que cuesta dinero, no tiempo

Dropea NO gestiona devoluciones por desistimiento, cambio de opinión ni insatisfacción. Solo cubre garantía: producto defectuoso o equivocado.

Qué pasa si no lo tienes en cuenta: cada devolución te cuesta el producto + el envío que ya pagaste, y te quedas con una unidad usada que no puedes revender. Si ofreces "garantía de prueba 30 días" sin meter esto en los números, la oferta que parecía buena te deja en pérdidas.

Los datos GPSR hay que pedirlos

Formulario de consultas de Dropea → pídeselos al proveedor del producto.

Error que nos costó tiempo

Dropea no te da los datos GPSR. Hay que pedírselos al proveedor con su formulario de consultas, y tarda. Qué pasa si lo dejas para el final: te plantas con la tienda montada y los anuncios listos sin poder publicar la ficha legal.

Dato útil

El ID de dropshipper es numérico y no aparece en el panel. Se saca del token de sesión, campo user_number. Si lo buscas por la interfaz, no está.

Sin tienda conectada no hay pedidos

Respeta el orden. No intentes adelantarte.

La cadena, en este orden

dominio → correo → tienda → app del proveedor → pedidos

No se pueden crear pedidos sin una tienda conectada. Ni siquiera una muestra para ti. Si querías probar el producto antes de montar nada, no se puede: monta primero.

Contra reembolso: en efectivo

El propio proveedor recomienda no garantizar el cobro con tarjeta al repartidor. Ponlo así en la ficha de producto y en el checkout, para que el cliente lo sepa antes de pedir.

Mira la tabla de tarifas antes de fijar precios

Los tramos de peso cambian el margen del pack.

Decisión · el pack de 2

El pack de 2 sube de tramo de peso, no paga el doble de envío. Sale mucho mejor que dos pedidos sueltos.

Qué pasa si no lo miras: pones el precio del pack a ojo, regalas margen en el 2×1 o lo dejas tan caro que nadie sube de una unidad — y el ticket medio se queda plano.

✅ Sabes que va bien si…

La tienda aparece conectada en el panel de Dropea, tienes el ID de dropshipper numérico apuntado y sabes cuánto te cuesta el envío de 1 unidad y el de un pack de 2.

↑ Volver al índice

Cierre

Lo que hace Claude solo

Esto NO lo toques. Está automatizado.
  • dns-shopify.sh <dominio> --aplicar — los registros DNS del dominio hacia Shopify.
  • nueva-tienda.sh <carpeta> "<Marca>" <dominio> — el esqueleto de la tienda.
  • tienda-estado.sh — la radiografía: dominio, correo, Meta y contenido.
  • tienda-checklist.sh <slug> — la tienda por dentro: producto, precios, stock, páginas legales, pie, tema, textos en inglés, contraseña y píxel. Solo lee.
  • crear_campana.py — campaña, conjunto y 3 anuncios, siempre en pausa, sobre la cuenta publicitaria que tú hayas creado.
  • La cuenta publicitaria y el píxel ya no: los creas tú (lo de arriba). meta-alta.sh se queda solo para consultar.
  • Textos legales, creativos, campaña creada en pausa, confirmación de pedidos y el informe diario.

Tiempo total: unos 60 minutos tuyos

FaseTiempo
0 · Antes de empezar5 min
1 · Dominio5 min (+ espera del .es, no cuenta)
2 · Página de Facebook5 min
3 · Acceso al negocio y 2FA10 min
4 · Enganchar la página y pagar5 min
5 · La tienda Shopify20 min
6 · El proveedor (Dropea)10 min
Total~60 min

La Fase 3 solo se paga una vez: cuando tu Facebook ya tiene 2FA, la siguiente tienda baja a unos 50 minutos.
Los 20 minutos de la Fase 5 son con esta guía delante. Sin ella fueron cuatro horas.

↑ Volver al índice