# Conectar WhatsApp

> Vincula tu número de WhatsApp mediante código QR, gestiona múltiples números y soluciona problemas de conexión.

Source: https://waslo.io/es/docs/connecting-whatsapp · Last updated: 2026-10-16

> WhatsApp es el canal de entrada más habitual, pero es uno entre seis. Si tus clientes te encuentran sobre todo por Telegram, Instagram, Messenger o correo, consulta el documento de [Integraciones](/docs/integrations).

## Tres formas de conectar WhatsApp

| Forma | Cómo conectas | ¿Sigues usando la app del teléfono? | Cargos de Meta | Cuándo elegirla |
|-------|---------------|-------------------------------------|----------------|-----------------|
| **QR de Waslo** | Escaneas un código QR desde WhatsApp → Dispositivos vinculados | Sí | Ninguno | Por defecto — rápido, sin trámites con Meta |
| **QR oficial (app WhatsApp Business)** | La ventana de Meta y luego escaneas un código con la app WhatsApp Business | Sí | Por cada mensaje que envía el agente | Quieres la API oficial de Meta **y** seguir chateando desde la app Business |
| **WhatsApp Cloud API** | La ventana de Meta con un número nuevo | No — el número vive solo en la API | Por cada mensaje que envía el agente | Un número dedicado, plantillas, difusión a gran volumen |

La forma QR de Waslo es una conexión multidispositivo al estilo de WhatsApp Web — el mismo tipo de sesión que usa tu portátil cuando vinculas un dispositivo. No es una integración con la API de Meta Business. El QR oficial y la Cloud API funcionan ambos sobre la plataforma oficial WhatsApp Business de Meta.

**Un número se conecta de una sola forma.** Waslo no permite conectar el mismo número a la vez mediante el QR de Waslo y mediante el QR oficial o la Cloud API — de lo contrario, dos conexiones responderían a cada cliente. Desconéctalo de una forma antes de conectarlo por otra.

## Conectar Tu Primer Número

1. Ve a **Panel → Integraciones**
2. Haz clic en **Agregar Número**
3. Ponle un nombre que reconozcas (por ejemplo, "Recepción") y haz clic en **Conectar**
4. Abre WhatsApp en tu teléfono → Configuración → Dispositivos vinculados → Vincular un dispositivo
5. Escanea el código QR mostrado en Waslo
6. Espera unos segundos — tu estado cambiará a **Conectado**

El código se renueva solo mientras está en pantalla. Si pasan unos dos minutos sin escanearlo, pulsa **Reconectar** y escanea el código nuevo. Tu número de teléfono aparecerá en el panel una vez vinculado, y el agente empieza a responder de inmediato.

**Primera sincronización.** Justo después de vincularla, una cuenta grande se sincroniza con WhatsApp durante unos minutos. La tarjeta del número muestra **Sincronizando con WhatsApp: N contactos hasta ahora** y la nota: "El agente ya está respondiendo. No desvincules ni vuelvas a escanear este número hasta que termine; suele tardar unos minutos." No toques el número hasta que desaparezca: desvincularlo o volver a escanearlo a mitad de la sincronización puede dejar el dispositivo vinculado sin poder leer mensajes hasta que vuelvas a vincular el número.

## Conectar tu app WhatsApp Business (QR oficial)

Conserva el número que ya usas en la app WhatsApp Business, sigue chateando desde tu teléfono y deja que el agente responda a través de la API oficial de Meta.

1. Actualiza la app WhatsApp Business a la versión **2.24.17 o posterior**
2. En Waslo: **Integraciones → WhatsApp Official API → Conectar mi app WhatsApp Business** (también se ofrece en el asistente de configuración inicial)
3. En la ventana de Meta, elige conectar tu **app WhatsApp Business existente** y sigue los pasos
4. Escanea el código que muestra Meta con la app WhatsApp Business de tu teléfono
5. El número aparece con la insignia **App Business**

Justo después de conectar, Waslo pide a Meta los contactos de tu app y hasta **180 días de historial de chats**. Los chats antiguos llegan a tu bandeja de entrada como historial: el agente no los responde y no se cobra nada por ellos. Meta permite esta solicitud una sola vez, dentro de las 24 horas siguientes a la conexión.

**Mientras está conectado:**
- Responde desde la app Business cuando quieras. Tu respuesta aparece en la conversación de Waslo y **pausa el agente** para ese cliente. Los mensajes automáticos de bienvenida y de ausencia de la propia app no lo pausan.
- Los grupos, los mensajes temporales, los mensajes de visualización única y las listas de difusión se quedan en la app — el agente no los ve.
- Meta limita un número compartido a 20 mensajes por segundo.

Si la ventana de Meta conecta un número normal en lugar de tu app Business (puede pasar si eliges otra opción ahí), Waslo te lo indica. Ábrela de nuevo y elige la app Business.

## Conectar mediante la Cloud API

Para un número dedicado, marketing con plantillas o grandes volúmenes de mensajes:

1. En Waslo: **Integraciones → WhatsApp Official API → Conectar con WhatsApp**
2. Sigue la ventana de Meta: elige o crea tu empresa, tu cuenta de WhatsApp Business y tu número
3. El número aparece como **Activo**

La **configuración avanzada (manual)**, debajo del botón, acepta en su lugar un WABA ID, un ID de número de teléfono y un token de acceso, para números configurados mediante tu propia app de Meta.

La conexión oficial de WhatsApp (Cloud API o QR oficial) está incluida en ambos planes, sin cuota de activación.

## Plantillas listas para alertas, recordatorios y seguimientos

Veinticuatro horas después del último mensaje de un cliente, Meta solo permite que un número oficial envíe una plantilla que haya aprobado. Cada número oficial tiene una tarjeta **Plantillas listas** con tres plantillas que envías una sola vez:

| Plantilla | Qué permite enviar a este número | Tarifa de Meta |
|-----------|----------------------------------|----------------|
| **Alertas para tu equipo** | Alertas para operadores a los números de WhatsApp de Ajustes → Notificaciones, cuando no hay ningún número QR de Waslo conectado | Utilidad |
| **Recordatorios de citas** | El recordatorio de 24 horas a los clientes que reservaron a través de este número | Utilidad |
| **Seguimientos** | Seguimientos automáticos a los prospectos inactivos de este número, cuando el seguimiento está activado | Marketing |

Haz clic en **Revisar y enviar**, revisa el texto y el idioma, y envíala a Meta. La tarjeta muestra el estado de cada plantilla — en revisión, aprobada o rechazada con el motivo de Meta — y **Comprobar estado** lo actualiza. Puedes editar la redacción, pero conserva los marcadores entre dobles llaves y deja palabras antes del primero y después del último; Meta rechaza cualquier otra cosa.

## Cargos de Meta (QR oficial y Cloud API)

Meta factura directamente a tu propia cuenta de WhatsApp Business los mensajes enviados a través de su API — Waslo no los revende ni les añade margen. A partir del **1 de octubre de 2026**:

- Meta cobra cada respuesta que envía el agente, por mensaje entregado, a la tarifa de Meta para el país de tu cliente.
- Los mensajes dentro de la ventana gratuita de 72 horas que se abre cuando un cliente te escribe desde un anuncio de clic a WhatsApp siguen siendo gratuitos.
- Los mensajes que escribes tú mismo en la app WhatsApp Business son gratuitos.
- Mantén un método de pago en tu cuenta de WhatsApp Business, o Meta dejará de entregar las respuestas del agente.

Waslo refleja lo que Meta cobró — el total, por tipo de mensaje y por país del cliente — en **Configuración → Facturación** y en la pestaña WhatsApp Official API, actualizado cada 30 minutos. **Ver precios de Meta**, en la misma tarjeta, abre la tabla de tarifas de Meta. La forma QR de Waslo no tiene cargos de Meta.

## Múltiples Números de WhatsApp

Puedes conectar más de un número de WhatsApp tanto en PAYG como en Growth:

| Plan | Máximo de Números |
|------|-------------------|
| PAYG | 1 gratis + números adicionales por 1.500 créditos cada uno (pago único), hasta 10 números en total |
| Growth | 3 incluidos, hasta 10 — cada número a partir del tercero cuesta 1.500 créditos una sola vez |

Para agregar otro número:
1. Ve a **Panel → Integraciones**
2. Haz clic en **Agregar Número**
3. Dale una etiqueta (ej.: "Ventas", "Soporte")
4. Escanea el código QR con un teléfono diferente

Cada número puede tener su propia configuración de IA (prompt personalizado, reglas de clasificación, política de seguimiento, palabras clave de traspaso) a través del Context Selector en **AI Agent**. También puedes desactivar el interruptor **"El AI agent responde en este número"** para un número concreto desde la página de Personalidad — la IA deja de responder automáticamente solo en ese número (los mensajes se siguen guardando y sincronizando con tu CRM), mientras el resto de tus números y canales siguen funcionando con normalidad.

## Estado de Conexión

Tu conexión de WhatsApp puede estar en uno de estos estados:

- **Conectado** — Activo y recibiendo mensajes
- **Conectando** — Estableciendo conexión (puede tardar hasta 60 segundos)
- **Escanear QR** — Esperando a que escanees el código QR
- **Desconectado** — No conectado, necesita reconexión
- **Sesión Cerrada** — La sesión fue cerrada, necesita un nuevo escaneo QR

Mientras el código está en pantalla, WhatsApp lo renueva solo. Si pasan unos dos minutos sin escanearlo, el código caduca y la tarjeta del número lo indica: pulsa **Reconectar** y escanea el código nuevo.

## Reconexión Automática

Waslo monitorea automáticamente tus conexiones e intentará reconectar si una sesión se cae inesperadamente. Esto se ejecuta cada 2 minutos, por lo que las desconexiones breves se manejan automáticamente.

## Solución de Problemas

**¿El código QR no aparece?**
- Actualiza la página e inténtalo de nuevo
- Verifica tu conexión a internet

**¿La conexión se cae constantemente?**
- Asegúrate de que tu teléfono tenga una conexión a internet estable
- No cierres sesión de WhatsApp en tu teléfono
- Evita vincular demasiados dispositivos al mismo número de WhatsApp

**¿Aparece Conectado pero no llegan los mensajes entrantes?**
- Si un número conectado falla una y otra vez al leer los mensajes entrantes, Waslo te avisa por correo
- Solución: pulsa **Desconectar** en la tarjeta del número y vuelve a conectarlo — no hace falta un código nuevo
- Solo si los mensajes siguen sin llegar: usa **Cerrar Sesión** para borrar la sesión y vuelve a vincular el número escaneando un código QR nuevo

**¿Estado "Prohibido"?**
- WhatsApp puede restringir cuentas que envían demasiados mensajes demasiado rápido
- Contacta al soporte de WhatsApp para resolver restricciones de cuenta
- Waslo incluye limitación de velocidad integrada para prevenir esto

## Cambiar entre el QR de Waslo y el QR oficial

1. Desconecta el número donde está ahora (**Desconectar** en su tarjeta)
2. Si dejas el QR oficial por completo: en la app WhatsApp Business, ve a **Configuración → Cuenta → Plataforma empresarial** y desconéctalo
3. Conecta el número por la otra forma

El cliente sigue siendo el mismo lead. Los mensajes nuevos inician una conversación nueva en la nueva forma; la conversación anterior se queda en la bandeja de entrada. Los ajustes de prompt y de base de conocimiento hechos para el canal **WhatsApp Cloud** no se trasladan a un número con QR de Waslo, que usa los ajustes de tu espacio de trabajo o por número.

## Desconectar

Para desconectar un número:
1. Ve a **Panel → Integraciones**
2. Haz clic en el botón **Desconectar** junto al número
3. La sesión se guardará — puedes reconectar más tarde sin escanear un nuevo código QR

Para eliminar completamente un número (borrar todos los datos de sesión), usa **Cerrar Sesión**, que está en la tarjeta del número junto a **Desconectar**.