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/connect1.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 dochannelId, 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.
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 deGET /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.
qrcode, a imagem do QR Code, e connected, que é true quando o número já está conectado. Repasse os dois como vieram.
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
Precisa de recursos que só a API Oficial tem — templates, Flows, janela de 24h, menor risco de bloqueio? Veja Meta WhatsApp.