Tu negocio,
paso a paso
con Codex.

Cinco palabras sin jerga

Repositorio: carpeta con historial de cambios, normalmente Git. Una carpeta puede empezar sin Git; /init no sustituye a git init.

Prompt: el encargo que escribes. Contexto: los documentos, imágenes e instrucciones que necesita para hacerlo.

Skill: procedimiento reutilizable. Plugin: paquete de capacidades. Conector o MCP: acceso a una herramienta externa; necesita permisos y una conexión real.

Token: unidad de texto que procesa el modelo. Adjuntar todo el negocio a cada tarea no garantiza mejores respuestas.

Qué modelo elegir

Luna: tareas delimitadas, ordenar una ficha, adaptar un texto o resumir datos ya preparados. Sol: opción inicial para construir, integrar y corregir. Astra: decisiones ambiguas o revisión difícil de arquitectura y fallos.

Estas son recomendaciones editoriales, no una garantía de precio ni calidad. Elige la variante disponible en tu cuenta. Selecciona modelo y esfuerzo ANTES de pegar el prompt; escribir su nombre no cambia la configuración.

Para ahorrar: define un resultado pequeño, señala los archivos necesarios y conserva las decisiones en documentos. Sube de modelo si la tarea se atasca, en lugar de repetir el mismo encargo muchas veces.

Estructura inicial propuesta, no un estándar obligatorio

AGENTS.md es el mapa breve para el agente: qué leer según la tarea, cómo probar y qué no inventar. Los demás nombres son decisiones de este proyecto, no archivos mágicos que Codex lea automáticamente.

Los originales y permisos de imagen se conservan en almacenamiento privado. Solo las copias autorizadas pasan al proyecto publicable. Las credenciales se guardan en el gestor de secretos del servicio.

Añade docs/arquitectura.md al incorporar una base de datos o integración. Describe entradas, salidas, responsable y fallos. Un README corto por módulo y pruebas de los procesos importantes ayudan más que decenas de carpetas vacías.

peluqueria-virtudes-delgado/
├── AGENTS.md                 # mapa e instrucciones breves
├── README.md                 # cómo abrir y comprobar el proyecto
├── docs/
│   ├── negocio.md            # hechos confirmados y pendientes
│   ├── plan.md               # entregas y criterios de aceptación
│   ├── marca.md              # referencias y decisiones visuales
│   └── decisiones.md         # qué se decidió y por qué
├── assets/aprobados/         # fotos autorizadas para publicar
├── contenidos/              # textos y campañas
├── web/                     # web pública; adaptar a Sites
├── datos/demo/              # solo datos ficticios
└── .gitignore               # secretos, originales e imports privados fuera

Al crecer: panel/, integraciones/ y tests/ según necesidad.
Fuera del repositorio público: originales, permisos, exportaciones y clientes.

Cómo dar un buen encargo

Incluye seis cosas: objetivo del negocio, destinatario, materiales, alcance, restricciones y una prueba de éxito. Adjunta 2–3 referencias explicando qué te interesa de cada una.

Evita «hazlo bonito y profesional». Mejor: «En móvil se debe ver dónde estamos y cómo pedir cita; usa estas fotos reales y prueba el botón».

Adaptar el ejemplo a tu negocio

Usamos Peluquería Virtudes Delgado, en Los Palacios y Villafranca, como caso de ejemplo. Para aplicarlo a tu negocio, completa tu propia ficha con precios, horarios, contacto, servicios y herramientas confirmados.

Comprueba la información con la persona responsable del negocio. Aparecer en un directorio no demuestra que se utilice su herramienta de reservas.

Dónde poner las fotos

Guarda originales y autorizaciones en una carpeta privada del negocio, con copia de seguridad. En assets/aprobados/ coloca únicamente versiones autorizadas y optimizadas.

Usa nombres como interior-01.webp o trabajo-001-despues.webp, sin nombres de clientes. El catálogo registra archivo, descripción, usos autorizados y referencia interna del permiso; no adjuntes documentos personales a la web.

En un antes/después, mantén encuadre y luz comparables. La IA puede ayudar con recorte y exposición; no debe inventar el resultado del servicio.

Una ficha comercial no es un expediente de clientes

No hacen falta diagnósticos, alergias, conversaciones privadas o datos de pago para generar la web. La demo usa datos ficticios. Un CRM real necesita una evaluación específica de acceso, tratamiento y conservación de datos.

Una prueba de cinco segundos

Muestra la primera pantalla en móvil. ¿Se entiende qué negocio es, en qué localidad está y cómo pedir cita? Esa prueba vale más que añadir una animación llamativa.

Usa las galerías como referencias, respetando licencias de componentes, fotos y fuentes. Un diseño premiado puede ser poco apropiado para alguien que solo busca teléfono y horario.

Imágenes que no parezcan de catálogo

Para esta peluquería, la mejor base son fotografías reales. Si generas imágenes conceptuales para un fondo o campaña, describe luz, material, encuadre, colores y uso; etiqueta la propuesta como conceptual.

Pide imágenes sin texto y compón los titulares en HTML, Canva o un editor. Así puedes corregirlos y mantener una tipografía consistente. No presentes personas o trabajos generados como clientes y resultados reales.

¿Sites permite algo más que una web estática?

Sí: puede crear interfaces interactivas, animaciones y aplicaciones con almacenamiento y autenticación. La disponibilidad y los límites dependen del entorno. Para esta primera entrega basta la web y un contacto que funcione.

Comprueba las limitaciones actuales de Sites antes de usarlo para un CRM real. No supongas que incluye procesos permanentes de fondo. Las APIs privadas necesitan un servidor y secretos protegidos. La documentación actual restringe datos sanitarios y operaciones financieras: deja pagos y datos de tarjeta al proveedor externo adecuado.

Qué tiene que probar Codex

Pantallas de 390 y 1440 píxeles, navegación por teclado, enlaces, imágenes, texto alternativo, errores del formulario y confirmación final. El formulario debe validar también en el servidor si recibe datos.

No publiques una reserva ficticia: si no hay una agenda conectada, el botón dice «Solicitar cita» y explica que falta confirmación. Una dirección o mapa pendiente se omite hasta verificarlo.

De dónde sale cada dato

Dominio: lo eliges y registras. Titular y correo: los aporta la propietaria. Método de pago: se introduce en Namecheap, no en el chat.

Tipo, host y destino DNS: los da Sites. No existe una IP o CNAME universal que debas copiar de esta guía. La hoja DNS del kit permite anotarlos.

El proveedor DNS activo lo determinan los nameservers. Si apuntan a otro proveedor, cambia allí los registros. @ suele representar el dominio raíz; www es un subdominio. Un destino CNAME es un nombre de host, sin https:// ni rutas.

Los registros MX, SPF, DKIM y DMARC pueden sostener el correo. Antes de cambiar nada, guarda la configuración y no borres registros ajenos a la web.

Dominio, alojamiento y correo son cosas distintas

El dominio es la dirección; el alojamiento sirve la página; el correo es otro servicio. Tener la web en Sites no obliga a comprar alojamiento adicional en Namecheap.

Activa doble factor y una renovación controlada por la propietaria. Registra responsable y fecha de renovación. DNS y emisión del certificado pueden tardar: comprueba el estado antes de rehacer cambios.

Usar investigación profunda de ChatGPT

Úsala para comparar fuentes y producir un informe con enlaces. Dale zona, tipo de clientela, preguntas concretas y formato de salida. Después lleva el informe a Codex para implementar.

No se presupone que ChatGPT accede a todas las reseñas de Maps, perfiles cerrados o métricas privadas. Si una fuente no está accesible, debe decirlo. Comprueba manualmente las conclusiones decisivas.

En una muestra, «3 de 18 reseñas consultadas mencionan espera» describe lo observado; «el 17 % de sus clientes está descontento» no se puede deducir.

Tabla de trabajo

Columnas: negocio, URL, fecha, canal, observación, evidencia breve, tamaño y criterio de muestra, hipótesis, acción propuesta y verificación pendiente.

No publiques acusaciones ni nombres de autores de reseñas en tu landing. Usa la investigación para mejorar tu propio proceso.

Lo útil para SEO local

Google explica los resultados locales mediante relevancia, distancia y prominencia. Una web no elimina el factor distancia ni garantiza una posición.

Publica información que resuelva dudas: cómo pedir cita, cómo llegar, qué incluye un servicio, duración orientativa confirmada y cuidados explicados por profesionales. Evita páginas casi idénticas para muchos pueblos.

Configura Search Console con una cuenta del negocio: Añadir propiedad → Dominio → copiar TXT → añadirlo al DNS activo → verificar. Conserva el registro. Envía la dirección real de sitemap.xml; comprueba que la web publicada es indexable y que la URL canónica es la elegida.

Los datos estructurados describen hechos visibles; no inventan reputación. El marcado LocalBusiness/HairSalon debe concordar con el negocio real. Añadir reseñas propias no da derecho a estrellas en Google.

Skills que pueden ayudar

Corey Haines publica skills como seo-audit, site-architecture y copywriting. Son de un tercero. Revisa el SKILL.md, los scripts y su licencia antes de instalar solo lo necesario.

Anthropic publica un plugin de marketing y una skill frontend-design. Un plugin de Claude no se convierte automáticamente en un plugin de Codex: las herramientas y dependencias deben ser compatibles.

Una skill ordena el trabajo; no aporta por sí sola acceso a Search Console, volúmenes de palabras clave ni experiencia real del salón. Google es la referencia para sus políticas, no una promesa de la skill.

Tres caminos, según el negocio

Agenda en papel: botón de WhatsApp con mensaje inicial y revisión humana. Un enlace wa.me abre una conversación; no envía automáticamente ni crea una reserva.

Excel o Google Sheets: formulario → registro único → aviso por correo → confirmación manual. Elige quién puede ver la hoja y evita enlaces públicos con clientes.

Software de reservas: usa su enlace, integración o API oficial. Comprueba profesionales, duración, márgenes, horarios, ausencias y cancelación. Google Calendar por sí solo no resuelve todos los conflictos de un salón.

Cuándo hace falta un sistema a medida

Solo si las herramientas existentes no cubren el proceso. La disponibilidad debe calcularse en el servidor y la confirmación debe ser atómica para que dos personas no reserven el mismo recurso.

Un correo de aviso no es la base de datos. Registra el estado del envío, los reintentos y una alternativa de contacto. Para una integración nueva empieza con datos ficticios y una cuenta de pruebas.

Elegir entre tres vías

Business Profile API permite listar reseñas de ubicaciones autorizadas y verificadas, con paginación. Requiere OAuth y acceso al proyecto aprobado; no permite administrar competidores.

Places API permite consultar información pública de un lugar. Place Details devuelve como máximo una muestra de cinco reseñas, según la API/documentación vigente: no equivale a todas las reseñas ni a una muestra aleatoria.

Un widget reduce trabajo de integración, pero no elimina las condiciones del proveedor ni de Google. Comprueba si conserva autor, enlace y procedencia y qué carga en el navegador.

Copiar reseñas no significa almacenarlas para siempre

Para obtener un Place ID, usa el buscador oficial de identificadores o Text Search. La clave de API sale de un proyecto de Google Cloud con Places habilitado y la facturación requerida; limita su uso y guarda las credenciales del servidor fuera de la web pública. Las condiciones del EEE pueden afectar a los datos disponibles.

Las APIs de Google imponen límites de almacenamiento, caché y uso. Business Profile contempla almacenamiento temporal limitado bajo sus condiciones; no lo interpretes como permiso para un archivo permanente ni para cualquier análisis de IA.

Para una landing, mantén atribución y enlaces conforme a la API o proveedor. No reescribas una reseña como si fuera literal ni inventes puntuaciones. Un testimonio obtenido directamente con autorización es otro material con su propio permiso.

El widget de reseñas del propio negocio no da acceso a estrellas de valoración en los resultados de Google. Consulta las políticas enlazadas antes de diseñar la integración.

Tres estilos para elegir

Editorial cálido: fondo crema, una tipografía de titulares, fotos amplias y poco texto. Útil para mostrar trabajos con calma.

Natural y cercano: luz real, colores discretos y lenguaje cotidiano. Útil para presentar equipo, espacio y proceso.

Gráfico: titulares grandes, contraste y bloques simples. Útil para listas o preguntas, sin tapar los trabajos con efectos.

Estas son propuestas para comparar con la propietaria, no la identidad confirmada de Virtudes Delgado. Un carrusel bonito pero ilegible en el móvil no está terminado.

Evitar el aspecto genérico de IA

Compón letras y formas en un editor o HTML y reserva la generación de imágenes para elementos conceptuales. Reutiliza una plantilla con tamaños, colores y márgenes fijos.

No fabriques un antes/después. No atribuyas consejos al salón hasta revisarlos. La llamada «Comenta GUÍA y te la enviamos» exige que la guía exista y que el recorrido funcione.

Puedes invitar a seguir la cuenta. Si condicionas la entrega a seguirla, explícalo antes y prueba que tu herramienta puede comprobarlo en ese contexto; no simules la comprobación.

Qué datos necesita una integración propia

App ID y App Secret: panel de Meta. Cuenta profesional e identificador: autorización y consulta de la cuenta. Token de acceso: flujo OAuth. URL de retorno: tu servidor HTTPS y configuración de la app.

Con Instagram Login, los permisos dependen de lo que hagas: perfil, publicación, comentarios, mensajes o estadísticas. Consulta la versión actual; no mezcles scopes de Facebook Login con los de Instagram Login.

Conectar tu cuenta de pruebas y ofrecer el servicio a otros negocios son situaciones distintas. El segundo caso puede requerir acceso avanzado, revisión y verificación. Los secretos se introducen en el gestor del alojamiento, nunca en el prompt.

Qué programa realmente la publicación

Un proceso ejecutado a la hora acordada crea los contenedores de medios, espera su procesamiento y solicita la publicación. En carruseles hay elementos y un contenedor padre; el servidor debe ofrecer archivos accesibles para Meta.

Guarda estado e identificadores para que un reintento no duplique publicaciones. Antes de repetir tras un fallo, consulta si ya se publicó. Añade reintentos limitados y una bandeja de errores.

Para funcionar con el ordenador apagado, utiliza un servicio siempre disponible y su programador, por ejemplo Workers/Queues. Una tarea de Codex es útil para preparar y revisar; no debe ser el único mecanismo de una operación crítica.

Qué aporta Buffer

Su MCP permite operar sobre canales y contenidos autorizados con herramientas del proveedor. Revisa capacidades, permisos y plan antes de elegirlo. El acceso a Buffer no crea por sí solo una automatización de mensajes de Instagram.

Hoja de configuración: app y producto elegidos, cuenta autorizada, identificador devuelto por la API, versión Graph, scopes aprobados, redirect URI, callback HTTPS, verify token, suscripciones del webhook y responsable de renovación. App Secret, access token y verify token se guardan como secretos; los nombres de esas variables sí pueden documentarse.

Un calendario semanal empieza con pocos contenidos. Mide citas y consultas útiles, no solo si se publicó algo.

Comentario → DM → interacción → recurso

Manychat explica que el primer mensaje privado no abre por sí solo la ventana de mensajería. Una respuesta o botón admitido sí puede abrirla; un botón que solo abre una web no equivale a esa interacción.

Existen límites sobre qué comentarios disparan el flujo y qué mensajes pueden enviarse después. Verifica la documentación vigente antes de activarlo. No encadenes mensajes promocionales fuera de las ventanas permitidas.

Pedir seguir la cuenta no autoriza una suscripción por correo. Si recoges email, explica para qué y separa ese permiso.

Si construyes tu propio Manychat

Necesitas la API de mensajes/comentarios y un webhook: una dirección HTTPS donde Meta entrega los eventos. Verifica su configuración y la firma de los mensajes recibidos.

Flujo: evento → validación → identificador único → cola → regla de campaña → envío → registro de resultado. Mantén una lista de errores y bloqueo de duplicados. Un webhook puede llegar más de una vez.

La respuesta a un comentario y una conversación posterior tienen permisos y ventanas diferentes. Configura las reglas de la versión actual de Meta, incluida la ventana de la respuesta privada inicial; no reutilices supuestos de WhatsApp.

Para dudas de precios, disponibilidad o reclamaciones, deriva a una persona si no hay datos confirmados. Empieza con respuestas preparadas y añade IA solo donde aporte valor. Editar AGENTS.md no actualiza mágicamente el conocimiento que usa el bot en producción.

Qué datos conectar y qué se puede medir

Agenda o software: solicitudes, citas confirmadas, realizadas, cancelaciones y no presentadas. Usa identificadores estables para no duplicar clientes.

Instagram autorizado: publicaciones, comentarios e insights disponibles. Guarda la fecha de consulta; una métrica ausente es «sin datos», no cero. La API no aporta las métricas privadas de competidores.

Web: visitas o sesiones según la herramienta y eventos como clic en pedir cita. Search Console aporta búsquedas y clics de Google, no todas las visitas de la web.

Clientes: primer servicio realizado y repetición. Vincula campaña con solicitud/cita mediante identificadores y UTM cuando sea posible; conserva «origen desconocido». Un clic no es un cliente.

Stock: producto, unidad, entrada, consumo/venta, ajuste y mínimo. Separar unidades y mililitros evita sumas engañosas. Cobros: importación autorizada desde TPV; ingresos no equivalen a beneficio.

Métricas que sí ayudan a decidir

Ocupación = minutos reservados / minutos realmente disponibles, con periodo y personal. Sin disponibilidad fiable, muestra que no se puede calcular.

No presentación = citas marcadas no presentadas / citas cuyo resultado ya se conoce, explicando qué estados incluyes. Nuevos clientes = personas cuyo primer servicio realizado cae en el periodo.

Conversión web = solicitudes atribuibles / sesiones comparables, si el seguimiento lo permite. No dividas citas de cualquier origen entre visitas registradas de solo una parte del público.

Para stock, alerta cuando existencias estén por debajo del mínimo configurado. Para redes, compara piezas del mismo formato y periodo; prioriza conversaciones útiles y citas confirmadas.

Cómo crecer sin rehacerlo todo

Modelo inicial: clientes, solicitudes, citas, servicios, profesionales, campañas, publicaciones, interacciones, productos y movimientos de stock. Relación por ID y registro de fecha de origen/importación.

Vista HTML es la interfaz, no la protección. Ocultar botones, usar una URL larga o poner noindex no protege datos. El servidor debe comprobar sesión y permisos en cada operación.

Supabase puede aportar base de datos y políticas por fila; un backend equivalente también sirve. Recharts sirve para gráficos; Playwright para comprobar recorridos. No añadas todas las bibliotecas si una tabla resuelve la decisión.

Consentimiento y privacidad de analítica dependen de la herramienta y configuración; consulta la guía de AEPD y valida la implantación antes de activar seguimiento. No envíes nombres o teléfonos a herramientas de analítica.

Tres rutinas propuestas

Lunes: resumen de la semana anterior, con periodo y fuentes, más tres acciones. Luna suele bastar cuando los datos están preparados.

Antes de publicar: comprobar activos, texto, enlace y estado aprobado. Si algo falta, llevarlo a revisión; no publicar una pieza incompleta.

Diario en el sistema de negocio: solicitudes sin atender y stock bajo mínimo. La frecuencia concreta depende del salón y sus horarios, no de esta demo.

Qué debe quedar documentado

Quién controla dominio y cuentas, dónde están las copias, cómo exportar datos, cómo pausar envíos, cómo revocar tokens y quién atiende los errores.

Prueba cada conexión con tu cuenta antes de depender de ella: que una solicitud llegue, que el aviso se reciba una sola vez y que puedas resolver un fallo.