🧩 Nulbix · Cuadro de Mandos

¿Tengo que entrar en n8n? NO. Los flujos ya están importados y activos. Tú solo: (A) pegas 2 claves en el archivo de datos, (B) das de alta el cliente con los identificadores del número, (C) conectas el webhook en Meta, (D) escribes un WhatsApp. Dónde va cada cosa que ya tienes:

A) Pega las claves y Redeploy

En Dokploy → tu servicio → Environment, rellena (deja el WHATSAPP_VERIFY_TOKEN que ya viene generado) y pulsa Redeploy:

WHATSAPP_TOKEN=（tu access token del System User）
WHATSAPP_APP_SECRET=（tu clave secreta de la app）
ANTHROPIC_API_KEY=（tu clave de Anthropic, si no la pusiste ya）copiar

Estas claves NO se ponen en n8n: van en el archivo de datos (Environment). El Redeploy las aplica solo.

B) Da de alta el cliente (pestaña Clientes)

• Rellena identificador, nombre, y los dos IDs de la tabla de arriba (Phone number ID y WABA ID).
• Sube un Excel de precios (si no, no tendrá qué contestar y derivará a persona).
• ⚠️ Clave para que CONTESTE: en la tabla de clientes pon Etapa = operacion (o go_live). En etapas anteriores está en modo sombra: lee pero NO responde.

C) Conecta el webhook (Meta → tu App → WhatsApp → Configuration → Webhook)

• Callback URL (cambia cliente y servidor):

  https://n8n-clinica-juan.s1.nulbix.com/webhook/wa-incomingcopiar

• Verify token: el valor de WHATSAPP_VERIFY_TOKEN de tu archivo de datos.
• Pulsa Verify and save (Meta comprueba y el sistema responde solo).
• En Webhook fields, suscríbete a messages.

https://n8n-clinica-juan.s1.nulbix.com/webhook/wa-incoming?s=TU_WHATSAPP_WEBHOOK_SECRETcopiar

👉 ANTES de pulsar "Verify and save", comprueba que el webhook está vivo. Abre PowerShell en tu PC, cambia el dominio y pega tu WHATSAPP_VERIFY_TOKEN, y ejecuta:

$h="n8n-clinica-juan.s1.nulbix.com"; $t="PEGA_TU_WHATSAPP_VERIFY_TOKEN"; (iwr "https://$h/webhook/wa-incoming?hub.mode=subscribe&hub.verify_token=$t&hub.challenge=test123").Contentcopiar

• Si responde test123 → el webhook está vivo y el token coincide: Meta validará sin problema. ✅
• Si da 404 ("workflow must be active") → los flujos no están activos en n8n. Comprueba que en el archivo de datos de Dokploy está la N8N_API_KEY (se crea en n8n → Settings → n8n API; sin ella n8n 2.x deja los flujos en borrador) y haz Redeploy; al desplegar se publican solos. Vuelve a probar.
• Si responde vacío → el token NO coincide: el WHATSAPP_VERIFY_TOKEN del archivo de datos de Dokploy y el Verify token de Meta deben ser la misma palabra; corrígelo, Redeploy y reintenta.

D) Envía el WhatsApp de prueba

• En API Setup, añade tu móvil como destinatario de prueba (Meta lo pide una vez).
• Desde TU móvil escribe al número de prueba: "¿cuánto cuesta la limpieza facial?".
• Debe contestarte con el precio real; si preguntas algo que no sabe, debe decir que te pasa con una persona.
• Compruébalo también en la pestaña 📨 Conversaciones (ahí ves el hilo y puedes responder tú).

Antes de tocar Meta, prueba sin WhatsApp: Clientes → 🧪 Probar agente, escribe esa pregunta y mira que responde bien. Si ahí va, el WhatsApp irá.

1. Entra en business.facebook.com y crea una cuenta de empresa con el nombre del cliente (no Nulbix).
2. En Configuración del negocio → Información del negocio, pon los datos legales del cliente exactamente como en sus documentos (deben coincidir en la verificación).

Centro de seguridad → Verificación del negocio → Iniciar. Sube del cliente: CIF/registro mercantil, documento fiscal y una factura o extracto con el nombre y dirección. Todo debe coincidir con el paso 1. Envía y espera. (Fuentes: zaple.ai/blog/meta-business-verification-whatsapp, interakt.shop/whatsapp-business-api/account-approval.)

1. En developers.facebook.com → My Apps → Create App → tipo Business → asóciala a la cuenta de empresa del paso 1.
2. Add Product → WhatsApp → Set up.
3. En WhatsApp → API Setup verás un número de prueba gratis, un token temporal, el Phone number ID y el WhatsApp Business Account ID.

ATAJO para ver que funciona HOY: con el número de prueba, añade tu móvil como destinatario de prueba y ya puedes mandar/recibir sin esperar la verificación. Úsalo para el primer "funciona".

Genera un token permanente: Business Settings → System Users → crea uno tipo Admin → Generate token → permisos whatsapp_business_messaging y whatsapp_business_management. Guárdalo en sitio seguro (no en el chat ni en el repo). (Fuente: WhatsApp Cloud API · Get Started.)

1. En API Setup → Add phone number. Pon el display name (nombre comercial real; Meta lo revisa 1-2 días, hasta 14).
2. Verifica el número por SMS o llamada; crea el PIN de 6 dígitos (guárdalo).
3. Cuando el display name esté aprobado, el número queda Connected. Añade un método de pago (sin él no envía en producción).
4. Apunta el Phone number ID y el WhatsApp Business Account ID: van en la pestaña Clientes.

Son obligatorias para escribir al paciente fuera de la ventana de 24 h (recordatorios, lista de espera, reactivación). El sistema ya las trae preparadas; solo hay que enviarlas a aprobación en WhatsApp Manager → Plantillas (o por API). Categorías: recordatorio/confirmación/reagenda/hueco = Utility; reactivación = Marketing. (Fuente: Message Templates.)

Qué es: que el sistema lea huecos y cree citas en el calendario del cliente, sin contraseñas, con una "cuenta de servicio".

Tú (una vez): en console.cloud.google.com crea un proyecto → habilita Google Calendar API → Credenciales → Cuenta de servicio → crea una clave JSON (guárdala segura, va al servidor, no al repo). Apunta el email de la cuenta de servicio. (Fuente: Google Calendar API.)

El cliente (dueño): en su Google Calendar → Configuración → Compartir con personas → añade ese email con permiso "Hacer cambios en los eventos". Copia el ID del calendario (lo necesitas en la pestaña Clientes).

Recomendado: un calendario por profesional (o uno "Citas Nulbix"), compartidos con la cuenta de servicio.

Columnas (primera fila = cabecera):

servicio,descripcion_corta,precio_eur,duracion_min,ciclo_repeticion_dias
Depilación láser axilas,Sesión individual,45,20,42
Botox tercio superior,Aplicación,320,30,150
Mesoterapia facial,Sesión,90,45,30copiar

Si un servicio no tiene precio cerrado, deja precio_eur vacío: el sistema derivará a una persona (no inventa). ciclo_repeticion_dias = cada cuántos días toca repetir (para la reactivación).

profesional,dia_semana,hora_inicio,hora_fin,tipo
Dra. Ana,0,10:00,14:00,atencion
Dra. Ana,0,16:00,20:00,atencion
Laura,1,10:00,18:00,atencioncopiar

dia_semana: 0=lunes … 6=domingo. tipo: atencion (citas normales) o asesoramiento (huecos para la llamada de fuera de horario). profesional debe coincidir con el nombre que pusiste en la ficha del cliente.

Del cliente, recoge también: tono (cercano/formal, tuteo/usted), preguntas frecuentes reales con su respuesta, qué temas van siempre a persona (urgencias, dudas médicas, quejas) y quién recibe los avisos cuando la IA pasa a una persona.

Rellena y pulsa Crear / guardar. Crea el cliente de verdad. Luego sube los Excel.

Datos del WhatsApp (de "API Setup" de Meta)

Profesionales y su calendario de Google

Crear / guardar cliente

Crea antes el cliente. Formatos en la pestaña "Agenda y datos".

Chatea con el agente usando los datos REALES del cliente, sin enviar nada a WhatsApp ni agendar de verdad. Ideal para validar el prompt/precios antes del go-live y comparar modelos.

Probar →

El selector de modelo es solo para esta prueba. El modelo (y los suplentes) de producción se eligen en la pestaña 🤖 IA / Modelos, y se aplican sin redeploy. La clave de OpenRouter (OPENROUTER_API_KEY) sí va en el archivo de datos.

No tienes que borrar nada ni empezar de cero. Para aplicar cualquier cambio (nuevas funciones, arreglos, cambios de base de datos):

1. Sube los cambios a tu GitHub (con GitHub Desktop, "Push").
2. En Dokploy, en el servicio del cliente, pulsa Redeploy. Ya está.

Por qué es seguro ahora: en cada Redeploy el sistema:

• Aplica los cambios de base de datos automáticamente (migrador idempotente: añade lo nuevo sin tocar tus datos). No se pierde nada.
• Reimporta y reactiva los flujos de n8n (actualiza los que cambien, sin duplicar).
• Aplica las nuevas variables del archivo de datos.

Un cliente nuevo se sigue creando desde cero igual (todo se crea solo en el primer deploy).

Solo borrarías el proyecto si quieres empezar limpio a propósito (perderías los datos de ese cliente). Para el día a día: Push → Redeploy.

Qué se respalda: cada noche, el sistema vuelca toda la base de datos (datos de tus clientes: precios, citas, conversaciones, mensajes… y el estado de n8n), la comprime, la cifra y la sube fuera del servidor. Si el VPS muere, tus datos están a salvo en otro sitio.

Dónde se guardan: en un bucket de almacenamiento S3 que tú controlas. Recomendado: Cloudflare R2 o Backblaze B2 (ambos con tier gratis de sobra para esto). No depende de un proveedor concreto.

Cómo activarlo (una vez por servidor)

1. Crea una cuenta en R2 o B2 y un bucket (ej. nulbix-backups).
2. Genera una clave de acceso (Access Key ID + Secret) para ese bucket.
3. En el archivo de datos (Dokploy → Environment) rellena el bloque de copias y pulsa Redeploy:

OFFSITE_REMOTE=offsite:nulbix-backups/clinica-juan
RCLONE_PROVIDER=Cloudflare
RCLONE_ACCESS_KEY_ID=（tu access key）
RCLONE_SECRET_ACCESS_KEY=（tu secret）
RCLONE_ENDPOINT=https://<tu-cuenta>.r2.cloudflarestorage.com
BACKUP_GPG_PASSPHRASE=（ya te la genera el panel; guárdala APARTE）copiar

Hecho. A partir de ahí hay copia cada noche (por defecto 03:15) y se conservan los últimos 14 días. Mientras no lo configures, el aviso del panel te recuerda que la copia es solo local.

Cómo restaurar (en el mismo VPS o en uno nuevo)

Levanta el stack y ejecuta (desde la consola de Dokploy del servicio, o por SSH):

docker compose exec backup sh /restore.sh nulbix-clinica-juan-2026-06-02-0315.sql.gz.gpgcopiar

Trae la copia del bucket, la descifra y la restaura. Para cambiar de proveedor de VPS: instala Docker, clona el repo, pon el mismo .env y restaura. Servicio recuperado en ~15-30 min.

Un *.nulbix.com no puede ir a varios servidores. Usa un comodín por servidor:

*.s1.nulbix.com → IP servidor 1
*.s2.nulbix.com → IP servidor 2
*.s3.nulbix.com → IP servidor 3copiar

Cada cliente vive en las direcciones de su servidor. Añadir un servidor = 1 registro. En "Clientes" ves en qué servidor está cada uno.

No. Solo cubre subdominios sin entrada propia. nulbix.com y www tienen la suya. Compruébalo viendo las entradas @ y www en tu DNS, y abriendo nulbix.com después.

Ninguno. Cada cliente es un proyecto independiente con su nombre y direcciones. Lo único compartido es la memoria: en 8 GB caben ~8-12 clínicas pequeñas; cuando se llene, abres otro servidor.

1. Ahora (gratis): los programas se reinician solos; hay copias automáticas guardadas fuera del servidor y un aviso si algo cae. Si el servidor muere del todo, se restaura en 15-30 min (pero actúas tú).
2. De pago, transparente (recomendado con 5-10 clientes de pago): base de datos gestionada (los datos sobreviven a la caída) + plataforma que se recoloca sola (Render/Railway/Fly o Dokploy en clúster). Se recupera sin que hagas nada.
3. Externalizado: una empresa lo vigila y arregla por ti.

Como todo está "encajonado" (contenedores) y los datos en un único sitio con copias, subir de nivel no obliga a rehacer nada.

• El panel exige iniciar sesión: la primera vez pides crear el usuario y la contraseña de administrador (una sola vez); después, cada visita y cada acción exigen esa sesión iniciada. La contraseña se guarda cifrada (scrypt), nunca en claro. Sin sesión, nadie ve clientes, conversaciones ni datos de pacientes. Tras varios intentos fallidos, se bloquea unos minutos.
• Nunca se suben: contraseñas, claves, JSON de Google, ni datos de pacientes. Viven solo en el servidor (Environment) y en copias cifradas.
• El repositorio del sistema es privado y solo tiene código genérico (sin tus estudios ni estrategia).
• Tus estudios, decisiones y manuales internos están en OTRA carpeta y no se suben.

• Servidor: desde ~5-10 €/mes (aguanta varios clientes).
• Programas (Dokploy, base de datos, n8n, este panel): gratis.
• WhatsApp: casi 0 € en pruebas; céntimos por recordatorio en uso real.
• La IA: el único gasto que sube con el uso, céntimos a pocos euros/mes por clínica, con tope.