# Manual completo: WhatsApp + configuraciones (Roadmap full)

## 1) Requisitos previos (Meta / WhatsApp Business)
1. Cuenta Meta Business Manager verificada.
2. App en Meta Developers con producto WhatsApp.
3. WABA (WhatsApp Business Account) creada/vinculada.
4. Número verificado (no puede estar en WhatsApp personal activo).
5. Políticas y opt‑in documentados.

## 2) Credenciales necesarias
- `WHATSAPP_TOKEN` (token largo o sistema OAuth).
- `WHATSAPP_PHONE_NUMBER_ID` (ID del número).
- `WHATSAPP_WABA_ID` (ID de la cuenta WABA).
- `WHATSAPP_VERIFY_TOKEN` (token para webhook).

## 3) Plantillas (Templates)
### 3.1 Crear plantilla
- Usa el panel `panel/whatsapp_templates.php` o `POST /marketing/templates/create`.
- La plantilla se envía a Meta si `sync_to_meta=true`.

### 3.2 Aprobación
- Meta revisa la plantilla. Puede tardar minutos u horas.
- Cuando esté aprobada, sincroniza desde el panel (botón “Sincronizar con Meta”).

### 3.3 Uso en campañas
- Marca la campaña con `use_whatsapp_template=1` y define:
  - `whatsapp_template_name`
  - `whatsapp_template_lang`

## 4) Opt‑in / Consentimiento
- Obligatorio para mensajes proactivos.
- Registrar consentimiento en:
  - `POST /marketing/consent`
  - `panel/whatsapp_consents.php`
- Guarda evidencia en `proof`.

## 5) Webhook de WhatsApp
1. URL: `https://xzonasvalencia.com/admin/chatbot/webhook.php`
2. Verify token: `WHATSAPP_VERIFY_TOKEN`
3. Confirmar verificación y logs.

## 6) Entorno de pruebas
- Activar `WHATSAPP_DRY_RUN=true`.
- Usar números de prueba y monitorizar logs.

## 7) Envíos en producción
- Desactivar `WHATSAPP_DRY_RUN`.
- Enviar campañas desde panel o cron.

## 8) Cron jobs recomendados
- `chatbot-unified/cron/send_marketing_messages.php` cada 1-5 minutos.
- `chatbot/bulk_cron.php` para masivos del sistema legacy.

## 9) Checklist seguridad y compliance
- Opt‑in documentado.
- Plantillas aprobadas.
- Logs de envío.
- Políticas de contenido de Meta.

## 10) Roadmap técnico recomendado
1. Fase 1: Estabilidad (opt‑in + templates + logs).
2. Fase 2: Escalado (colas, rate limit inteligente).
3. Fase 3: IA (mensajes personalizados + reengagement).
4. Fase 4: Automatización total (onboarding bot + handoff).