Saltar al contenido principal
Canal de tipo 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/connect 1.1.1 o superior
  • Una ruta en tu backend que obtiene el código QR con la Secret Key

Conectar

Además del channelId, 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.
Sin 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 de GET /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.
La API devuelve 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.
Comprueba la sesión del usuario y que el canal le pertenece antes de llamar a la API. Una ruta que entrega el código QR de cualquier canal permite que alguien vincule su propio número a un canal ajeno.
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

Es una conexión no oficial, basada en WhatsApp Web. El riesgo de bloqueo del número es mayor que en la API Oficial, y el móvil debe mantener la sesión activa.
¿Necesitas funciones que solo tiene la API Oficial —plantillas, Flows, ventana de 24 h, menor riesgo de bloqueo—? Consulta Meta WhatsApp.