# Capítulo 9: Problemas y Soluciones

> Diagnóstico rápido de los problemas más comunes en PageGenius, organizados por área.

---

## Índice de Problemas

> **Sitios de ejemplo creados con PageGenius:**
> `![Landing page](/help/screenshots/pagegenius-landing-es.png)`
> `![Página About](/help/screenshots/pagegenius-about.png)`
> `![Página de blog](/help/screenshots/pagegenius-blog.png)`

| Sección | Problemas cubiertos |
|---------|-------------------|
| [Registro y Login](#registro-y-login) | No llega email, no puedo entrar, olvidé contraseña |
| [Dashboard](#dashboard) | Stats en 0, acciones rápidas no funcionan, plan badge mal |
| [Proyectos y AI](#proyectos-y-ai) | AI falla, no puedo crear más, proyecto se quedó generando |
| [Builder](#builder) | Widget no se ve, guardar vs publicar, lento, undo no funciona |
| [Widgets](#widgets) | Imagen borrosa, botón no lleva a ningún lado, formulario no envía |
| [Publicación](#publicación) | Falla la publicación, sitio lento, 404 |
| [Dominios](#dominios) | Pendiente DNS forever, SSL no aparece, dominio ya en uso |
| [Analytics y Leads](#analytics-y-leads) | Stats en 0, email no llega, leads duplicados |
| [Team y Billing](#team-y-billing) | No puedo invitar, pago rechazado, downgrade perdió proyectos |
| [Errores de Código](#errores-de-código) | Custom Code rompió todo, CSS no aplica, JS no corre |

---

## Registro y Login

### "No me llega el email de verificación"
**Diagnóstico:**
1. Revisá spam/promociones/actualizaciones
2. Esperá 5 minutos
3. Clic en "Reenviar código"

**Si sigue sin llegar:**
- Probaste con Gmail? Revisá la pestaña "Actualizaciones"
- Probaste con email corporativo? Tu firewall puede estar bloqueando el remitente `notifications@mypagegenius.com`
- **Solución final:** Registrate con Google Sign-In (no requiere verificación por email)

### "Olvidé mi contraseña"
1. En la pantalla de login, clic en **"¿Olvidaste tu contraseña?"**
2. Escribí tu email
3. Te enviamos un link para resetear

### "Mi cuenta de Google no funciona"
- **Causa:** El email de Google está asociado a otra cuenta de PageGenius.
- **Solución:** Usá el login con email/contraseña, o contactá soporte para fusionar cuentas.

---

## Dashboard

### "Mis stats están en 0 pero ya publiqué"
- **Esperá 24h.** Los stats se calculan sobre una ventana de 30 días. Si publicaste hoy, no hay datos todavía.
- **Refrescá la página** (F5). A veces el cache del navegador no muestra lo último.
- **Verificá que el sitio tenga tráfico real.** Compartí la URL y esperá visitas.

### "El botón 'Generar con IA' no hace nada"
- **Causa:** Llegaste al límite de generaciones AI.
- **Solución:** Free = 1 generación total. Pro = 10/mes. Agency = 999/mes. Upgradéá o esperá al mes siguiente.

---

## Proyectos y AI

### "La IA generó contenido genérico"
**Tu descripción fue probablemente:**
- ❌ "Un negocio"
- ❌ "Una empresa"
- ❌ "Una tienda"

**Mejorála así:**
- ✅ "Taller mecánico en Miami que repara aires acondicionados de autos, frenos, y transmisiones. Abierto sábados. Atendemos emergencias."
- ✅ "Clínica dental en Houston que acepta seguros Aetna y Cigna. Especialistas en implantes same-day y ortodoncia invisible."

### "La IA tardó y falló"
1. Esperá 1 minuto
2. Reintentá
3. Si falla 3 veces, contactá soporte (puede ser un outage de Groq/Gemini)

### "Mi proyecto se quedó en 'Generando...'"
- Refrescá la página
- Si aparece incompleto, eliminalo y volvé a generar
- **No te preocupes:** la IA no te cobró una generación si falló

### "No puedo crear más proyectos"
- Free = 1 | Pro = 10 | Agency = 100
- **Solución:** Eliminá proyectos viejos o upgradéá

---

## Builder

### "Guardé pero los cambios no aparecen en vivo"
**Guardar ≠ Publicar.**
- Guardar = se guarda en el builder (solo vos lo ves)
- Publicar = se genera el HTML en vivo (todo el mundo lo ve)
- **Solución:** Clic en **"Publicar"** (`Ctrl/Cmd + P`)

### "El widget que agregué no se ve"
- Revisá que tenga contenido (título, texto, imagen)
- Revisá que el color de texto no sea igual al fondo
- Revisá que no esté "colapsado" (algunos widgets necesitan mínimo 1 item)

### "El builder se ve lento"
- Reducí la cantidad de widgets por página (máximo recomendado: 20)
- No uses más de 10 imágenes por galería
- No embeás videos de más de 30 segundos
- Cerrá otras pestañas del navegador

### "Quiero deshacer un cambio"
- `Ctrl/Cmd + Z` = undo
- `Ctrl/Cmd + Shift + Z` = redo
- El builder guarda un historial profundo. Podés deshacer hasta el inicio de la sesión.

---

## Widgets

### "La imagen se ve borrosa / pixelada"
- **Causa:** Subiste una imagen muy chica.
- **Solución:** Subí imágenes de mínimo 1200px de ancho. PageGenius las adapta, pero no las mejora.

### "El botón no lleva a ningún lado"
- Revisá el campo **Link** del botón
- Para WhatsApp: `https://wa.me/1234567890` (sin `+`, sin espacios)
- Para teléfono: `tel:+13051234567`
- Para email: `mailto:contacto@mitaller.com`

### "El formulario no envía"
- Revisá que todos los campos obligatorios estén completos
- Revisá que haya un campo **Email** (sin email, no se puede notificar)
- Revisá que el honeypot no esté visible (si aparece un campo extra, es un bot intentando spammear)

### "El mapa no muestra mi dirección"
- Escribí la dirección completa: "123 Main St, Miami, FL 33101"
- No uses PO Boxes
- Si sigue sin funcionar, usá el widget **Custom Code** con un iframe de Google Maps

### "Los testimonials se ven sin fotos"
- Si no subís fotos reales, PageGenius muestra iniciales con fondo de color
- **Recomendación:** Usá fotos reales de clientes. Aumenta la confianza un 300%.

### "El video no se reproduce"
- YouTube/Vimeo: Revisá que el video sea público (no privado ni "solo con link")
- Archivo MP4: Revisá que el archivo esté en una URL accesible (no en un servidor con autenticación)
- iOS: Algunos videos de fondo no autoplayan en iPhone

---

## Publicación

### "La publicación falló"
1. Revisá que no haya widgets con campos vacíos obligatorios
2. Revisá que no haya **Custom Code** con tags rotos
3. Intentá de nuevo
4. Si persiste, contactá soporte

### "Mi sitio publicado se ve diferente al builder"
- Usá **"Ver Preview"** en el builder para ver exactamente cómo quedará
- Diferencias menores de espaciado son normales
- Si hay diferencias grandes (colores, fuentes, layouts rotos), contactá soporte

### "Mi sitio da 404"
- **Causa:** El proyecto fue eliminado, o el slug cambió.
- **Solución:** Revisá que el proyecto exista y esté publicado. Si cambiaste el slug, la URL anterior ya no funciona.

---

## Dominios

### "Pendiente DNS lleva más de 2 horas"
**Verificá tu DNS:**
1. Andá a [whatsmydns.net](https://whatsmydns.net)
2. Escribí tu dominio
3. Seleccioná tipo **A**
4. Clic en **Search**
5. Si NO ves `195.26.248.6` en la mayoría de los servidores → el problema está en tu registrador

**Causas comunes:**
- ❌ Usaste CNAME en vez de A
- ❌ La IP tiene espacios o está mal escrita
- ❌ Hay un registro A viejo con otra IP
- ❌ En Cloudflare, tenés el proxy naranja encendido (ponelo en "Sólo DNS")

### "SSL no aparece (sin candado)"
1. Esperá 30 minutos después de que el dominio esté "Activo"
2. Si usás Cloudflare: SSL/TLS → **Full (strict)**
3. Forzá HTTPS: agregá una regla de redirect en Cloudflare

### "Dominio ya está en uso"
- Ese dominio está conectado a otro proyecto de PageGenius
- **Solución:** Andá al otro proyecto → Dominios → Eliminá el dominio → Volvé a tu proyecto y añadilo

---

## Analytics y Leads

### "No me llegan emails de leads"
1. Revisá spam/promociones
2. Revisá que tu email de notificaciones esté configurado en **Configuración** → **Avanzado**
3. Buscá "PageGenius" en tu email
4. Si usás email corporativo, tu IT puede estar bloqueando el remitente

### "Los leads aparecen duplicados"
- PageGenius no deduplica automáticamente
- Filtrá por email en la tabla de Leads
- Considerá agregar un mensaje en el formulario: "Por favor no envíes el formulario más de una vez"

---

## Team y Billing

### "No puedo invitar más miembros"
- Free = 1 | Pro = 5 | Agency = 20
- **Solución:** Eliminá miembros existentes o upgradéá

### "Mi pago fue rechazado"
1. Revisá que la tarjeta no esté vencida
2. Revisá que haya fondos suficientes
3. Probá con otra tarjeta
4. Si tu banco bloquea Stripe, llamá al banco y autorizá el pago

### "Bajé de plan y perdí proyectos"
- Free = 1 proyecto. Los demás se archivan (no se borran, pero no se pueden editar).
- **Solución:** Upgradéá de nuevo para recuperar acceso, o eliminá proyectos para quedarte con el límite.

---

## Errores de Código

### "Agregué Custom Code y el sitio se ve roto"
1. Entrá al builder
2. Encontrá el widget **Custom Code**
3. Eliminá el código o el widget entero
4. Guardá y publicá de nuevo

**Causas comunes:**
- Tags sin cerrar (`<div>` sin `</div>`)
- CSS con `!important` que sobreescribe todo
- JavaScript con errores de sintaxis que rompe el resto

### "Mi CSS custom no se aplica"
- Revisá que no haya errores de sintaxis (falta `;` o `}`)
- Revisá que los selectores sean correctos
- El CSS custom se aplica a TODOS los sitios de tu organización

---

## Contactar Soporte

Si ninguna de las soluciones arriba funciona:

1. **Desde el dashboard:** Andá a **Configuración** → **Soporte**
2. **Por email:** `soporte@adwolvesmedia.com`
3. **Información que necesitamos:**
   - URL del proyecto o sitio
   - Qué estabas haciendo cuando falló
   - Screenshot del error
   - Navegador y dispositivo (ej: Chrome en Windows, Safari en iPhone)

**Tiempo de respuesta:**
- Plan Free: 48-72 horas
- Plan Pro: 24 horas
- Plan Agency: 4-12 horas

---

## Cheat Sheet de Diagnóstico Rápido

```
¿Algo no funciona?
├── ¿Es solo visual? → Refrescá (F5) o limpiá cache (Ctrl+Shift+R)
├── ¿Es después de editar? → Guardá y publicá de nuevo
├── ¿Es en móvil? → Probá en desktop. Si funciona en desktop, es responsive.
├── ¿Es un widget? → Revisá que tenga contenido y que los campos obligatorios estén completos
├── ¿Es un dominio? → Verificá en whatsmydns.net
├── ¿Es un formulario? → Revisá spam y configuración de email
├── ¿Es lento? → Reducí imágenes/videos/widgets
└── ¿Nada de esto funciona? → Contactá soporte
```

---

**Fin del Manual de Usuario en Español.**

**Versión en Inglés:** [English User Manual](17a-en-getting-started.md)