Z_API_WHATSAPP. Se conecta mediante el código QR, igual que WhatsApp Web: sin Meta, sin aprobación y sin plantillas.
Es el canal con más volumen de la plataforma. Si vienes de Z-API, este es el modelo que ya usas.
Requisitos
- Un número de WhatsApp con la app instalada en el móvil
- Acceso al móvil para escanear el código QR
@omnizapi/connect1.1.1 o superior- Una ruta en tu backend que obtiene el código QR con la Secret Key
Conectar
Además delchannelId, WhatsApp Web necesita la función getQRCode. El SDK abre la ventana de conexión, la ventana le pide el código QR a tu página y el SDK llama a tu getQRCode para responder. El usuario escanea el código QR desde WhatsApp en el móvil, en Dispositivos vinculados.
getQRCode, connect rechaza con un OmnizapiError de código INVALID_OPTIONS y cierra la ventana antes de cargar la conexión. Los demás canales ignoran getQRCode, así que puedes pasarlo siempre.
El dominio de tu página tiene que estar en los dominios autorizados del SDK. Es a ellos a los que la ventana envía el pedido del código QR.
La ruta en tu backend
El código QR viene deGET /v1/channels/{id}/zapi/qr-code/image, que exige la Secret Key. Por eso la consulta ocurre en tu backend, y la clave nunca llega al navegador.
qrcode, la imagen del código QR, y connected, que es true cuando el número ya está conectado. Reenvía los dos tal como llegaron.
Hasta la versión 1.0.4, el SDK solo entregaba el código QR a la ventana dentro del propio panel. En cualquier otro dominio, la ventana se cerraba nada más abrirse y
connect devolvía success: false con reason: "not_completed". Actualiza a la 1.1.1 o superior.Qué cambia en WhatsApp Web
¿Necesitas funciones que solo tiene la API Oficial —plantillas, Flows, ventana de 24 h, menor riesgo de bloqueo—? Consulta Meta WhatsApp.