Cómo conectar tu número de WhatsApp Business escaneando un QR, qué cambia al hacerlo, y cómo desconectarlo o reactivar la recepción.
La forma recomendada de conectar WhatsApp es la Coexistencia: escaneas un código QR y tu número sigue funcionando en la app de WhatsApp Business de tu celular y, al mismo tiempo, en Orkestal. No tienes que soltar tu teléfono ni migrar tus chats.
Hay también una conexión manual para quien administra su propia app de Meta.
Antes de conectar#
Meta revisa estos puntos mientras escaneas el QR. Si alguno falla, la ventana se cierra sin explicar por qué y hay que empezar de nuevo. Por eso Orkestal te pide confirmarlos antes de habilitar el botón.
- La app de WhatsApp Business en la versión 2.24.17 o más nueva. Es el mínimo que exige Meta. Revísalo en el celular: WhatsApp Business → Configuración → Ayuda → Información de la aplicación. Si es más vieja, actualízala desde la tienda de aplicaciones.
- El número ya debe estar en uso en la app. La Coexistencia conecta un número que ya usas en WhatsApp Business, con sus chats. Los números recién dados de alta, o con la app recién instalada, son el motivo más común de rechazo: déjalos trabajando algunos días antes de conectarlos.
- Pon tu foto de perfil y los datos del negocio antes de conectar. Después de conectar solo se editan desde la app, no desde Orkestal.
- Identifica la cuenta de Meta correcta. Inicia sesión con la persona que tiene control total del Business Portfolio (portafolio de negocio) que posee ese WhatsApp. Que esa persona administre varias empresas no es problema: eliges el portafolio correcto dentro del flujo. Cambiar de perfil o de Página de Facebook no concede acceso al WABA.
También ten en cuenta:
- Un solo número por cuenta de Orkestal en Coexistencia.
- No desinstales ni reinstales WhatsApp Business. Para Meta, reinstalar la app es motivo de desconexión y tendrías que repetir todo el proceso.
- Deja la app abierta y el celular desbloqueado mientras sincroniza. El código QR caduca en segundos.
Conectar paso a paso#
- Ve a Canales y busca la tarjeta de WhatsApp Business.
- En el bloque Coexistencia, marca las casillas de confirmación.
- Si tu plan ya usó todos sus canales incluidos, acepta el cargo por canal adicional.
- Pulsa Conectar por QR. Se abre el inicio de sesión de Meta. No se te pedirán WABA ID, Business ID ni tokens.
- Inicia sesión, elige el portafolio de negocio y la cuenta de WhatsApp, y escanea el QR con tu app de WhatsApp Business.
- Cuando termina, Orkestal te avisa que el número quedó conectado y empieza a sincronizar tus contactos e historial.
Después de conectar#
Agrega un método de pago en WhatsApp Manager#
Tu número queda conectado y ya recibes mensajes, pero para poder enviarlos Meta necesita un método de pago en tu cuenta de WhatsApp Business. Es tu propia cuenta y solo tú puedes agregarlo. El aviso de Orkestal incluye un botón directo a WhatsApp Manager y desaparece solo cuando lo agregas.
Historial y contactos#
Orkestal sincroniza tus contactos y el historial de conversaciones individuales de la app (hasta 180 días, por fases y una sola vez). Los chats de grupo no se sincronizan.
Lo que escribes desde el celular también aparece#
Los mensajes que envías desde la app de WhatsApp Business quedan registrados en la conversación de Orkestal. Si respondes a mano un chat, la IA se pausa en él: mira Relevo humano.
Qué cambia en tu WhatsApp al conectar#
- El número queda con un límite fijo de 20 mensajes por segundo.
- Las listas de difusión se desactivan; las que ya tenías quedan de solo lectura.
- En chats individuales se apagan los mensajes temporales, «ver una vez» y la ubicación en tiempo real.
- Los chats de grupo no se sincronizan: siguen viviendo solo en tu app.
- WhatsApp para Windows y para WearOS no funcionan con Coexistencia, y los dispositivos vinculados «companion» se desvinculan al conectar.
- Por la API tampoco hay llamadas, catálogo, estados ni canales.
Mantén activa tu app#
Meta puede desconectar números de Coexistencia inactivos. Abre la app de WhatsApp Business al menos cada 14 días. Orkestal te avisa en el panel cuando no ha visto actividad reciente de WhatsApp Business: abre la app y úsala ese día.
Desconectar un número#
Desconectar en Orkestal detiene el envío y la recepción, pero para quitar el vínculo por completo hazlo también desde el celular:
- En Canales, pulsa Desconectar en la tarjeta de WhatsApp y confirma. Tus conversaciones se conservan.
- En WhatsApp Business, abre Configuración.
- Ve a Cuenta → Business Platform.
- Elige Desconectar y confirma. Meta avisa a Orkestal, que apaga el canal automáticamente.
Si dejas de recibir mensajes#
Orkestal vigila la recepción de tu número y muestra un aviso arriba del panel cuando detecta un problema:
| Aviso | Qué significa | Qué hacer |
|---|---|---|
| WhatsApp no está recibiendo mensajes | Meta dejó de entregarle a Orkestal los mensajes de tu número | Pulsa Reactivar recepción; suele resolverse en segundos |
| Los mensajes se están enviando a otro sistema | Meta manda tus mensajes a otra dirección | Reactiva la recepción; si el aviso vuelve, revisa el diagnóstico en Configuración → WhatsApp |
| WhatsApp perdió su autorización | Meta ya no acepta la autorización guardada: no entran ni salen mensajes | Reconectar WhatsApp |
| Lleva demasiado tiempo sin recibir mensajes | Tu número recibe mensajes a diario y lleva mucho más de lo normal sin ninguno | Si tus clientes sí te escriben, reactiva la recepción |
Después de reactivar, manda un mensaje de prueba a tu número para confirmar.
Quién responde en WhatsApp#
En Configuración → WhatsApp → Quién responde en WhatsApp eliges el modo del canal:
- Agente Orkestal: la IA de Orkestal contesta (lo normal).
- Agente externo (n8n o webhook): tu propio sistema genera las respuestas. Mira Agente externo.
- Solo atención humana: nadie contesta automáticamente; tu equipo atiende desde la bandeja.
Conexión manual (avanzada)#
Si administras tu propia app de Meta, puedes conectar con credenciales en lugar del QR. En Canales → WhatsApp Business → Conexión manual (avanzado) necesitas:
| Campo | De dónde sale |
|---|---|
| Phone Number ID | WhatsApp Manager, configuración de la API |
| WhatsApp Business Account ID (WABA ID) | WhatsApp Manager → Configuración de la API. No es el ID del portafolio de negocio de Business Manager: con ese, los mensajes funcionan pero las plantillas no se sincronizan |
| Permanent Access Token | Un token permanente de un usuario de sistema (System User) en Business Settings, con los permisos de WhatsApp |
| Webhook Verify Token | Un valor que tú eliges |
Después pega la Callback URL y el Verify Token que muestra Orkestal en la configuración de Webhooks de tu app de Meta (producto WhatsApp).
Dudas frecuentes#
¿Puedo seguir contestando desde mi celular? Sí, ese es el objetivo de la Coexistencia.
¿Pierdo mis chats? No. Tus chats individuales siguen en la app y se sincronizan a Orkestal.
¿Puedo conectar dos números? No en la misma cuenta: Orkestal admite una cuenta por canal, o sea un número de WhatsApp. Para cambiar de número, desconecta el actual y conecta el otro. Mira Canales, resumen.
¿Por qué no puedo escribirle a un cliente? Seguramente pasaron más de 24 horas desde su último mensaje. Mira Reglas de WhatsApp.