📱 Método QR — número personal o de empresa
Vincula cualquier número de WhatsApp (personal o Business) escaneando un código QR desde el teléfono, igual que WhatsApp Web. No requiere ninguna cuenta de desarrollador.
Requisitos previos
⚠ El teléfono debe estar activo
El número de WhatsApp debe tener la app instalada en un teléfono encendido y con conexión a internet. La sesión QR funciona como un dispositivo vinculado adicional.
Pasos
1
Abre WA Manager y pulsa «+» para añadir cuenta
En la barra de pestañas de cuentas (parte superior de la barra lateral) pulsa el botón + que aparece al final.
2
Elige «Código QR» e introduce un nombre
En el diálogo que aparece selecciona la pestaña Código QR, escribe un nombre identificativo para esta cuenta y pulsa Generar QR.
Nombre de la cuenta
Ej: Mi número personal, Soporte…
Generar QR
3
Aparecerá un código QR en pantalla
El servidor genera el código en unos segundos. Tienes ~60 segundos para escanearlo — si caduca, pulsa «Regenerar QR».
Escanea este código con WhatsApp
4
Escanea el QR desde tu teléfono
En tu teléfono abre WhatsApp → Configuración → Dispositivos vinculados → Vincular dispositivo y apunta la cámara al código QR de la pantalla.
WhatsApp
📱 Dispositivos vinculados
›
+ Vincular dispositivo
💡 En iPhone: WhatsApp → Ajustes → Dispositivos vinculados → Vincular dispositivo
5
¡Listo! La cuenta aparece como «Conectada»
Tras el escaneo, en unos segundos el estado cambia a Conectada y WhatsApp enviará automáticamente el historial de los últimos ~3 meses.
📥 Historial de mensajes
La primera vinculación puede tardar varios minutos en importar todos los mensajes. Puedes seguir el progreso desde el botón de configuración (⚙) de la cuenta.
🌐 Meta API — WhatsApp Business API oficial
Para empresas con número de WhatsApp Business verificado en Meta. Requiere crear una aplicación en Meta for Developers y obtener credenciales específicas.
⚠ Requisitos previos
Necesitas: una cuenta de empresa en Facebook, un número de teléfono no vinculado a WhatsApp normal, y acceso a Meta for Developers (developers.facebook.com).
Parte 1 — Crear la aplicación en Meta
1
Entra en Meta for Developers
Abre developers.facebook.com e inicia sesión con tu cuenta de Facebook de empresa.
Si es la primera vez, acepta las condiciones de desarrollador.
2
Crea una nueva aplicación
Haz clic en Mis apps → Crear app.
Meta for Developers
developers.facebook.com
Aún no tienes ninguna app
3
Selecciona el tipo «Business»
Elige el tipo de app Business (la que permite integrar WhatsApp Business API). Pulsa Siguiente.
🏢
Business
Incluye WhatsApp Business API
4
Ponle nombre y asocia tu cuenta de empresa
Escribe un nombre para la app (interno, no lo verá nadie) y selecciona tu cuenta de Business Manager si tienes varias.
Parte 2 — Añadir WhatsApp al producto
5
Añade WhatsApp como producto
En el panel de tu nueva app, en el apartado Añadir productos, busca WhatsApp y pulsa Configurar.
Panel de la app → Añadir productos
WhatsApp
WhatsApp Business Platform
Configurar
Parte 3 — Obtener las credenciales
6
Obtén el Phone Number ID
Ve a WhatsApp → Configuración de API en el menú lateral izquierdo. Verás un panel con los datos de tu número.
WhatsApp → Configuración de API
Número de teléfono
+34 6XX XXX XXX
Phone number ID
1234567890123456
← Copia este valor
WhatsApp Business Account ID
9876543210987654
Es un número largo (15-16 dígitos). No es el número de teléfono, es el identificador interno de Meta.
Ejemplo: 123456789012345
7
Genera un Token de acceso
En la misma pantalla Configuración de API, justo debajo, aparece un token temporal. Para uso en producción necesitas un token permanente.
🔑 Token temporal (pruebas)
Válido 24 horas. Solo para probar que la integración funciona.
Configuración de API → Token de acceso temporal
Token temporal
EAABzbz...XXXXX
← Copia
🔐 Token permanente (producción) — recomendado
Para que el sistema funcione sin interrupciones, crea un Usuario del sistema con token permanente:
a
Ve a business.facebook.com → Configuración → Usuarios del sistema
b
Crea un nuevo usuario del sistema de tipo Admin
c
Pulsa Generar token, selecciona tu app y activa el permiso whatsapp_business_messaging
d
Elige «Sin caducidad» y copia el token generado (solo se muestra una vez)
Es una cadena larga que empieza por EAA.
Ejemplo: EAABzbzxuqv8BO...
8
Obtén el App Secret (opcional pero recomendado)
El App Secret permite a WA Manager verificar que los mensajes que llegan por webhook son auténticos de Meta.
Configuración → Información básica
Secreto de la app
••••••••••••••••
← Clic en «Mostrar»
Es un hash hexadecimal de 32 caracteres.
Ejemplo: a1b2c3d4e5f6789...
Parte 4 — Introducir los datos en WA Manager
9
Añade la cuenta en WA Manager
Pulsa + en la barra de cuentas, selecciona la pestaña Meta API y rellena los campos:
Añadir cuenta → Meta API
Nombre de la cuenta
Ej: Soporte empresa
App Secret
← Paso 8 (opcional)
Pulsa Añadir cuenta Meta. El sistema creará automáticamente una URL de webhook.
10
Configura el webhook en Meta
Tras añadir la cuenta, WA Manager te mostrará una URL de webhook. Debes configurarla en Meta para que lleguen los mensajes.
WhatsApp → Configuración → Webhooks
URL del webhook
https://tudominio.com/wa-api/webhooks/meta/xxxxxxxx
Token de verificación
← El que aparece en WA Manager
⚠ Suscríbete a «messages»
En la sección Webhooks de Meta, asegúrate de suscribirte al campo messages para recibir los mensajes entrantes.
✓ Prueba la conexión
En WA Manager, abre la configuración (⚙) de la cuenta y pulsa Probar conexión para verificar que el token es válido.
Problemas frecuentes
El QR caduca antes de que pueda escanearlo
+
Los códigos QR de WhatsApp caducan en ~60 segundos. Si caduca, cierra el modal y vuelve a pulsar Generar QR. Asegúrate de tener WhatsApp abierto en el teléfono antes de generarlo.
La cuenta aparece como «Desconectada» aunque la añadí bien
+
Puede ocurrir si el teléfono pierde conexión o si se cerró la sesión en WhatsApp. Abre la configuración (⚙) de la cuenta y pulsa Reconectar y recuperar. Si no funciona, usa Nuevo QR desde cero para volver a vincular.
No aparece el historial de mensajes antiguos
+
WhatsApp solo envía el historial (~3 meses) al vincular un dispositivo nuevo por primera vez. Si la cuenta ya estaba vinculada antes, usa Nuevo QR desde cero (⚙ → Nuevo QR desde cero) para borrar la sesión y volver a vincular — así WhatsApp enviará el historial completo de nuevo.
Los mensajes de grupo aparecen como conversaciones individuales
+
Esto ocurre si el servidor no pudo obtener el nombre del grupo al recibir los mensajes. Desconecta y reconecta la cuenta desde ⚙ → Reconectar y recuperar. Los mensajes del grupo se reagruparán automáticamente.
Error de token en cuenta Meta: «Token inválido» o «Token caducado»
+
El token temporal de Meta caduca en 24 horas. Para evitarlo, crea un token permanente mediante un Usuario del sistema (ver Paso 7 de la guía Meta API). Una vez tengas el nuevo token, ve a ⚙ → editar la cuenta → introduce el nuevo token y guarda.
No llegan las notificaciones push
+
Comprueba que:
- Has pulsado el icono 🔔 de la barra lateral y aceptado los permisos de notificación
- El navegador permite notificaciones para este sitio (ajustes del navegador)
- No tienes el modo «No molestar» activo en el sistema operativo
- Accedes por HTTPS (las notificaciones push no funcionan en HTTP)
No veo las fotos de perfil de los contactos
+
Las fotos de perfil dependen de la configuración de privacidad de cada contacto en WhatsApp. Si el contacto tiene la privacidad configurada como «Nadie» o «Mis contactos» (y no tienes su número guardado en el teléfono vinculado), no es posible obtener su foto. Es una limitación de WhatsApp, no del sistema.
Contacto y soporte
Contact & support
💬 ¿Necesitas más ayuda? Contacta con soporte:
💬 Need more help? Contact support:
Revisa los logs del servidor en /opt/wa-manager/backend/.
Check server logs at /opt/wa-manager/backend/.
