WhatsApp API es la conexión oficial de WhatsApp para empresas, directa con Meta. Es la más estable, la que habilita todas las funciones (campañas masivas, plantillas, medición de anuncios) y la recomendada para operar en serio.
Cómo conectarlo
- Entra a Canales y en la tarjeta WhatsApp API haz clic en Conectar (tienes un botón Tutorial con la guía en video).
- Se abre la ventana oficial de Meta: inicia sesión con Facebook y elige (o da de alta) tu cuenta de WhatsApp Business y tu número.
- Sigue los pasos — el botón muestra el progreso: Conectando… → Procesando… → Guardando conexión… → Conectado ✔.
- Al terminar verás el aviso "¡Conexión establecida!".
💡 ¿Número nuevo o el que ya usas? Ambos sirven. Si ya usas el número en la app de WhatsApp Business, puedes conectarlo sin dejar de usar el celular: los mensajes que respondas desde la app también quedan registrados en WeSpeak.
ℹ️ Si más adelante la conexión con Meta se pierde (cambio de contraseña, permisos vencidos), el sistema lo detecta automáticamente y te envía una notificación de canal desconectado — no dependes de darte cuenta por tu cuenta.
Los estados de tu número
En la tarjeta del canal ves tres indicadores:
| Indicador | Qué significa |
|---|---|
| Estado de conexión | Conectado / Pendiente (falta terminar la verificación) / Desconectado (ver detalle abajo). |
| Nombre comercial | Meta revisa el nombre visible de tu negocio: Aprobado, En revisión o Rechazado. |
| Límite de mensajería | Se muestra como «N conversaciones/día»: cuántas conversaciones puedes iniciar tú por día fuera de la ventana de 24 horas. Responder a clientes que te escribieron no consume este límite ni tiene tope. Sube solo manteniendo buena calidad. |
Todos los estados de conexión posibles
| Estado | Qué significa |
|---|---|
| Conectado | Tu número está conectado y operando normalmente. |
| Pendiente | El número fue agregado a la cuenta de WhatsApp Business pero todavía no terminó el proceso de configuración/verificación. Completa la verificación en Meta. |
| Desconectado | El número perdió la conexión con WhatsApp. Reconéctalo desde Canales. |
| Eliminado | El número ya no está disponible en la cuenta de WhatsApp Business (se quitó desde Meta). |
| Baneado | Meta suspendió el número. Revisa el estado de la cuenta en Meta Business Suite (ver la guía de Problemas con WhatsApp). |
El nombre comercial, además de Aprobado, En revisión y Rechazado, puede figurar como Nombre Caducado (el certificado venció: vuelve a solicitarlo en Meta) o Nombre no existente (falta validar el nombre en Meta Business Suite).
La regla de las 24 horas (lo más importante)
WhatsApp permite escribir libremente durante las 24 horas posteriores al último mensaje del cliente. Pasado ese plazo (o para iniciar una conversación nueva), solo puedes enviar plantillas aprobadas por Meta:
- En el chat, escribe / para elegir una plantilla.
- Solo aparecen seleccionables las plantillas con estado Aprobada.
- Si intentas enviar texto libre fuera de la ventana, el sistema te avisa: "Debes usar una plantilla para enviar este mensaje."
- Cada mensaje que envíes fuera de la ventana necesita su propia plantilla, hasta que el cliente conteste.
- Cuando el cliente responde, la ventana se reabre al instante y vuelves a escribir libremente (sin recargar la página). También se cierra puntual: exactamente a las 24 horas del último mensaje del cliente, aunque tengas el chat abierto.
Qué soporta
| Función | WhatsApp API |
|---|---|
| Texto, emojis, adjuntos, notas de voz | ✅ |
| Plantillas aprobadas (con /) | ✅ |
| Citar / responder un mensaje | ✅ |
| Programar mensajes | ✅ |
| Campañas masivas | ✅ (el canal recomendado) |
| Varios números a la vez, con nombre y predeterminado ⭐ | ✅ |
| Texto libre pasadas 24 h sin respuesta del cliente | ❌ Solo plantillas aprobadas |
| Eliminar mensajes | ⚠️ Solo mensajes del contacto y solo de tu panel (el contacto lo sigue viendo) |
Preguntas frecuentes
¿Por qué no puedo escribirle a un cliente que me habló la semana pasada?
Pasaron más de 24 h desde su último mensaje: usa una plantilla aprobada (escribe /).
Mi nombre comercial está "En revisión", ¿puedo operar?
Sí, la mensajería funciona; Meta aprueba el nombre en paralelo.
¿Puedo tener WhatsApp API y la conexión por código QR a la vez?
No — son excluyentes. Para conectar la API primero se desconecta el QR: en Canales, la tarjeta de WhatsApp QR tiene el botón Desconectar junto al check de estado. Confirma en el diálogo y listo — no necesitas contactar a soporte. Ten en cuenta que para volver a usar la conexión QR deberás escanear el código de nuevo (no hace falta volver a ingresar el número).
Si migro de QR a API, ¿pierdo el historial de conversaciones?
No necesariamente: tu asesor puede ejecutar una migración del historial al nuevo canal, que traslada las conversaciones, todos los mensajes (enviados y recibidos) y las notas de cada conversación. Si ya existía una conversación con el mismo contacto en el destino, se fusionan automáticamente.
¿Mi conexión es "híbrida" o API pura? ¿Qué significa?
Híbrida = tu número está vinculado a la API de Meta pero sigue usable desde el teléfono (la app convive con la plataforma). API pura = el número vive solo en la API: ya no usas la app de WhatsApp y todo se responde desde WeSpeak. Si al conectar un teléfono se te desconectaron los demás dispositivos, es un efecto de cómo Meta maneja las sesiones en este esquema — consúltalo con tu asesor antes de mover el número.
¿Qué necesito para migrar de QR a API? ¿Pierdo algo?
Necesitas el usuario y clave de Meta del negocio (y los de Facebook/Instagram si los vas a vincular) y quitar la cuenta de WhatsApp Business del teléfono. No pierdes la línea: la API solo toma la mensajería de WhatsApp — el número telefónico y las llamadas siguen funcionando normal. Lo que cambia: dejas de usar la app y respondes todo desde la plataforma.
¿Puedo publicar "estados" de WhatsApp desde WeSpeak?
No — los estados son una función de la app y no están disponibles vía API.
Quiero un QR para un folleto que abra un chat con mi número.
Se puede: es un QR que apunta a tu número con un mensaje predefinido. Pídeselo a tu asesor (no es una gestión del panel).
¿Cómo consigo el tilde verde (cuenta verificada)?
Lo otorga Meta, no WeSpeak. Requisitos habituales: 30 días o más de antigüedad usando WhatsApp Business, cumplimiento de las políticas de Meta y notoriedad del negocio. Se solicita desde tu Meta Business Suite (la verificación de Instagram es un trámite aparte).
Mi teléfono también tiene la app de WhatsApp Business y responde solo.
Desactiva los mensajes de bienvenida, ausencia y respuestas rápidas de la app (WhatsApp Business → Configuración → Herramientas para la empresa): se pisan con el asistente.