Pular para o conteúdo principal
Canal do tipo Z_API_WHATSAPP. Conecta pelo QR Code, como o WhatsApp Web faz — sem Meta, sem aprovação, sem templates.
É o canal de maior volume da plataforma. Se você vem da Z-API, é este o modelo que você já usa.

Requisitos

  • Um número de WhatsApp com o app instalado no celular
  • Acesso ao celular para escanear o QR Code
  • @omnizapi/connect 1.1.1 ou superior
  • Uma rota no seu backend que busca o QR Code com a Secret Key

Conectando

O WhatsApp Web pede, além do channelId, a função getQRCode. O SDK abre a janela de conexão, a janela pede o QR Code à sua página e o SDK chama o seu getQRCode para responder. O usuário escaneia o QR Code pelo WhatsApp do celular, em Aparelhos conectados.
Sem o getQRCode, o connect rejeita com OmnizapiError de código INVALID_OPTIONS e fecha a janela antes de carregar a conexão. Os outros canais ignoram o getQRCode, então você pode passá-lo sempre. O domínio da sua página precisa estar nos domínios autorizados da SDK. É para eles que a janela manda o pedido de QR Code.

A rota no seu backend

O QR Code vem de GET /v1/channels/{id}/zapi/qr-code/image, que exige a Secret Key. Por isso a busca acontece no seu backend, e a chave nunca vai para o navegador.
A API devolve qrcode, a imagem do QR Code, e connected, que é true quando o número já está conectado. Repasse os dois como vieram.
Confira a sessão do usuário e se o canal pertence a ele antes de chamar a API. Uma rota que entrega o QR Code de qualquer canal permite que alguém ligue o próprio número a um canal que não é dele.
Até a versão 1.0.4, o SDK só entregava o QR Code à janela dentro do próprio painel. Em qualquer outro domínio, a janela fechava logo ao abrir e o connect devolvia success: false com reason: "not_completed". Atualize para a 1.1.1 ou superior.

O que muda no WhatsApp Web

É uma conexão não oficial, baseada no WhatsApp Web. O risco de bloqueio do número é maior do que na API Oficial, e o celular precisa manter sessão ativa.
Precisa de recursos que só a API Oficial tem — templates, Flows, janela de 24h, menor risco de bloqueio? Veja Meta WhatsApp.