Rol: Administrador • ⏱ 7 min lectura • Actualizado: Septiembre 2026
Gateway de WhatsApp & Configuración QR
PrestaFacil SaaS integra un microservicio de mensajería bidireccional basado en WebSockets que permite enlazar cualquier línea telefónica con WhatsApp mediante un código QR interactivo, sin requerir costosas suscripciones de intermediarios terceros.
1. Arquitectura del Gateway de WhatsApp
El gateway corre como un contenedor aislado conectado al servidor Laravel a través de webhooks seguros:
- Emisión de Recibos: Cuando se confirma un cobro, el backend despacha un payload al socket del gateway con el número telefónico del prestatario y la plantilla formateada.
- Manejo de Reintentos: Si el destinatario tiene su teléfono apagado, el gateway encola el mensaje y reintenta la entrega hasta confirmar el doble check gris o azul.
- Soporte Multi-Sesión: Permite una sesión corporativa para toda la empresa o sesiones individuales por cobrador.
2. Vinculación mediante Código QR (Paso a Paso)
1
Ir a Ajustes > Configuración WhatsApp
Desde la Consola Web con perfil de Administrador, ingresa al módulo de WhatsApp.
2
Generar Código QR
Presiona el botón "Vincular Nueva Sesión". El sistema abrirá un socket en vivo y renderizará un código QR dinámico con tiempo de expiración de 45 segundos.
3
Escanear desde el Smartphone
Abre WhatsApp en el teléfono corporativo de la empresa, ve a Dispositivos Vinculados > Vincular un Dispositivo y escanea el código QR de la pantalla.
4
Confirmación de Enlace
La pantalla se actualizará automáticamente mostrando el indicador verde: Sesión Activa y Conectada junto con el número de teléfono y nombre del perfil.
3. Estados de Conexión y Telemetría
| Estado | Indicador Visual | Significado Operativo |
|---|---|---|
| Conectado | 🟢 Verde | Línea activa. Los comprobantes se entregan de forma instantánea al WhatsApp del cliente. |
| Conectando | 🔵 Azul | El sistema está sincronizando la sesión con los servidores de WhatsApp. |
| QR Listo | 🟡 Amarillo | Esperando que el administrador escanee el código QR con la cámara de su teléfono. |
| Desconectado | 🔴 Rojo | El teléfono perdió internet o la sesión fue cerrada desde la app de WhatsApp del teléfono. |
4. Prueba de Conexión y Diagnóstico
Para comprobar que tu línea está funcionando correctamente sin generar un cobro real:
- En la pantalla de ajustes, digita tu número telefónico personal de prueba en la casilla "Número de Prueba".
- Presiona el botón "Enviar Mensaje de Prueba".
- Si la conexión es exitosa, recibirás un mensaje institucional de bienvenida en tu celular en menos de 3 segundos.
5. Buenas Prácticas Anti-Bloqueo de Meta
Políticas de Uso de WhatsApp
Para proteger tu línea corporativa de posibles sanciones de Meta:
- **Usa la línea exclusivamente para recibos y cobranzas:** No envíes promociones, cadenas o publicidad masiva no solicitada.
- **Formato Nicaragüense (+505):** PrestaFacil SaaS opera exclusivamente en Nicaragua. Puedes ingresar los teléfonos con sus 8 dígitos habituales (ej.
8821-9456) o anteponiendo el código de país+505. La plataforma se encarga de normalizarlos de forma transparente para WhatsApp. - **Mantén el teléfono con carga y conexión:** Asegúrate de que el celular emisor tenga acceso a internet estable (WiFi o 4G).
¿Esta guía resolvió tu duda operativa?