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 o de WhatsApp Business, antes de conectarlo hay que quitar la cuenta de la app (WhatsApp → Configuración → Cuenta → Eliminar mi cuenta): WeSpeak conecta el número en API pura, la mensajería pasa a la plataforma y las llamadas de la línea siguen funcionando. Si necesitas conservar los chats del teléfono, haz una copia de seguridad antes — Meta no los traslada a la API.
ℹ️ 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 el mismo contacto ya tiene una conversación abierta en el canal de destino, esa conversación no se migra sola: queda señalada al final del proceso y tu asesor la resuelve contigo.
¿Puedo seguir usando el número desde la app mientras está en la API (coexistencia)?
No — WeSpeak no ofrece el modo de coexistencia. La conexión de WhatsApp API es siempre API pura: el número vive solo en la API, dejas de usar la app de WhatsApp y todo se responde desde la plataforma. El número telefónico y las llamadas siguen funcionando normal; lo que se muda a la API es la mensajería.
¿Cómo desconecto WhatsApp API para volver a usar el número en la app?
Quitar el canal en Canales no alcanza: el número sigue registrado en la API de Meta hasta que lo eliminas desde el Administrador de WhatsApp, con la cuenta administradora de tu portfolio. Paso a paso, requisitos y la regla de los 30 días en Desconectar WhatsApp API y liberar tu 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.
Antes usaba WhatsApp con otro proveedor (u otro chatbot). ¿Tengo que hacer algo antes de conectar?
Sí: date de baja definitiva con ese proveedor y pídele que quite su acceso a tu cuenta de WhatsApp Business. En Meta Business Suite, Cuentas de WhatsApp → Socios muestra qué empresas tienen acceso a cada cuenta. Si tu número sigue conectado con ellos, no lo elimines: avísale a tu asesor antes de conectar, porque el cambio de proveedor se hace con una migración (Desconectar WhatsApp API y liberar tu número explica cómo funciona). Revisa también si te dejó una línea de crédito (pregunta siguiente).
En Meta me aparece una «línea de crédito» de otra empresa. ¿Qué significa?
Que un proveedor de WhatsApp con el que trabajaste te asignó su forma de pago. La ves en Meta Business Suite, en Facturación y pagos → Líneas de crédito, con la leyenda «Allocated from:» y el nombre de esa empresa (por ejemplo, Gupshup). Qué implica:
- La línea es de esa empresa, no tuya ni de WeSpeak: Meta le factura a ella los mensajes de la cuenta de WhatsApp que tiene la línea asociada, y ella te los cobra a ti. Con WeSpeak no hay línea de crédito de por medio: Meta te cobra directo a la tarjeta de tu cuenta (Cómo cargar o cambiar el método de pago).
- Tú no puedes editarla ni quitarla, y Meta no permite cambiar la línea de crédito de una cuenta de WhatsApp una vez asociada.
- Si esa empresa la da de baja, la cuenta se queda sin forma de pago: hasta que cargues tu tarjeta, Meta deja de entregar los mensajes que cobra.
Antes de conectar esa cuenta a WeSpeak, confirma con ese proveedor que te diste de baja definitiva y a qué cuenta de WhatsApp está asociada su línea, y cuéntaselo a tu asesor.
¿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.