Dos formas de conectar un número, según lo que necesites.
Escaneas un QR con tu WhatsApp, como WhatsApp Web. Sigues usando tu app de WhatsApp normalmente — no se migra el número. Sin app de desarrollador de Meta, sin esperas de revisión. Un número solo puede estar conectado a un owner a la vez (409 si ya está en uso).
/connect/wasender/accounts/:id/wasender/qrSi ya tienes un número dado de alta en Meta Business (WABA), lo conectas pasando tus credenciales directamente — no hay flujo OAuth para esta opción.
/connect/whatsapp-cloudYa no. Desde mayo de 2025 Meta ofrece Coexistencia: el mismo número vive a la vez en la app de WhatsApp Business y en la Cloud API, con los mensajes espejados en tiempo real en ambos sentidos. Se activa por Embedded Signup escaneando un QR desde la app — así lo hace Kommo. El caso antiguo en el que registrar el número en la API lo sacaba de la app solo pasa con el registro directo (sin el flujo de coexistencia).
Límites de coexistencia: no sincroniza grupos; se desactivan mensajes temporales, "ver una vez", ubicación en vivo y edición; listas de difusión pasan a solo lectura; throughput fijo de 20 msg/s. No disponible en Nigeria ni Sudáfrica. Zoosial hoy conecta con credenciales ya emitidas (Opción B arriba); el onboarding de coexistencia con QR aún no está implementado — ver notas internas en docs/WHATSAPP.md.
/accounts/:id/whatsapp/sendLos mensajes entrantes disparan el webhook message.received — ver Webhooks y el ejemplo completo en Quickstart.
curl -X POST https://zoosial.com/connect/whatsapp-cloud \ -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \ -d '{"profileId":"prof_123","phoneNumberId":"1234567890","accessToken":"EAAG..."}'