Pular para o conteúdo principal
As conexões não oficiais do WhatsApp são soluções que emulam o protocolo do WhatsApp Web para vincular um número comum ao PanÐá Zap, sem passar pela aprovação da Meta e sem exigir uma conta empresarial verificada (WABA). Diferente da API oficial, elas não fazem parte da infraestrutura oficial da Meta: cada motor listado nesta página (Baileys, InfiniteAPI, Zapo, WWEBJS, Evolution, Evolution Go, Wuzapi, Z-API e Uazapi) usa uma engenharia diferente por baixo dos panos, mas todos compartilham o mesmo mecanismo de pareamento por QR Code, como se você estivesse conectando um novo dispositivo ao WhatsApp Web.
Risco de banimento: o uso de conexões baseadas em APIs não oficiais (Baileys, ZAPO, WebJS, Evolution, WUZAPI, Z-API, Uazapi e semelhantes) acarreta risco de banimento do número pelo WhatsApp, já que essas bibliotecas e serviços emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. O uso dessas ferramentas é de inteira responsabilidade da empresa que as utiliza. Para operações de larga escala, ou que exijam segurança máxima contra bloqueios, a recomendação é usar a API oficial (WABA), coberta na página Canais Meta Oficiais.

Comparativo rápido entre os motores

Fluxo comum de conexão por QR Code

Para todos os canais desta página, depois de concluída a configuração prévia específica de cada motor, o pareamento segue sempre o mesmo caminho:
  1. Em Administração > Canais > Adicionar Canal, crie um canal do tipo correspondente, seguindo o formulário do canal (nome, recursos do canal etc.).
  2. Gerar o QR Code: depois de salvar, localize o cartão do canal e clique em Novo QR Code. Uma janela se abre exibindo o código.
  3. Escanear no aparelho: abra o WhatsApp no celular, vá em Configurações (ou Ajustes) > Dispositivos Conectados > Conectar um dispositivo, e aponte a câmera do celular para o QR Code exibido na tela.
  4. Confirmar a conexão: aguarde alguns segundos enquanto o sistema sincroniza os dados. A janela mostra Conectado com sucesso!, fecha sozinha e o status do cartão muda para CONECTADO.
A janela mostra uma contagem regressiva (QR Code expira em, cerca de 45 segundos); quando o tempo acaba, o QR Code é renovado automaticamente. Se precisar, clique em Novo QR Code para gerar outro na hora. As seções abaixo detalham o que diferencia cada motor e quais etapas de configuração prévia (instalação, URL da API, Chave Global, contratação de serviço etc.) são exigidas antes desse fluxo comum.

Recursos avançados do formulário de criação

Além do fluxo comum acima, o formulário do canal libera alguns campos extras quando o tipo escolhido é um dos motores não oficiais desta página. Nem todo campo aparece para todo motor:
Essas opções ficam junto dos campos gerais de qualquer canal (Nome, Atribuições, Mensagem de Despedida, Webhook do Canal, Recursos do Canal etc.). Veja o formulário do canal para o detalhamento completo.

Canais disponíveis

Quem usa: AdministradorO que é: uma solução de integração não oficial baseada em uma biblioteca de código aberto que emula o protocolo do WhatsApp Web. Diferente da API oficial (WABA), o Baileys permite conectar um número de telefone comum ao PanÐá Zap sem aprovação prévia da Meta e sem conta empresarial verificada. É o motor não oficial mais usado na plataforma e reúne vários recursos complementares: Usar código de pareamento, Importação de Mensagens, Configurações Adicionais (Proxy), PIX, mensagens interativas (Resposta rápida, Lista e Botão PIX) e ligações via WaVoIP, quando esse recurso está liberado para a sua empresa.
Atenção, risco de banimento: o uso de conexões baseadas em APIs não oficiais (Baileys, WebJS, Evolution e semelhantes) acarreta risco de banimento do número pelo WhatsApp, já que essas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. O uso dessas ferramentas é de inteira responsabilidade da empresa que as utiliza. Para operações de larga escala, ou que exijam segurança máxima contra bloqueios, a recomendação é usar a API oficial (WABA).
Como configurar / usar (passo a passo):
  1. Em Administração > Canais > Adicionar Canal, crie um canal do tipo Baileys seguindo o formulário do canal (nome, recursos do canal etc.).
  2. Gerar o QR Code: depois de salvar, localize o cartão do canal e clique em Novo QR Code. Uma janela se abre exibindo o código.
  3. Escanear no aparelho: abra o WhatsApp no celular, vá em Configurações (ou Ajustes) > Dispositivos Conectados > Conectar um dispositivo, e aponte a câmera do celular para o QR Code exibido na tela. Como alternativa, ative Usar código de pareamento no formulário, informe o número e digite no celular o código exibido na tela, sem precisar escanear nada.
  4. Confirmar a conexão: aguarde alguns segundos enquanto o sistema sincroniza os dados. A janela fecha sozinha e o status do cartão muda para CONECTADO.
O QR Code tem validade curta (a janela mostra a contagem regressiva, cerca de 45 segundos) e é renovado automaticamente; se precisar, clique em Novo QR Code para gerar outro.Benefícios e quando usar: é a opção não oficial mais tradicional e difundida, útil quando não há orçamento ou necessidade imediata da API oficial, e a empresa aceita o risco inerente de bloqueio.
O celular usado na conexão precisa ter internet estável e bateria carregada. Quedas de internet no celular causam desconexões intermitentes no painel, então evite usar essa modalidade em aparelhos com sinal fraco ou em constante economia de energia. Se o canal cair e ficar desconectado, experimente primeiro Revalidar sessão, no menu de três pontos do cartão: ela reconecta usando as credenciais salvas, sem novo QR Code. Se as falhas persistirem, Configurações, aba Sessões, tem o botão Resetar conexão Baileys, que recria a chave de autenticação do canal; use-o como último recurso antes de excluir e recriar o canal do zero.
Quem usa: AdministradorO que é: assim como o Baileys, uma solução de integração não oficial que emula o protocolo do WhatsApp Web e permite conectar um número comum sem aprovação da Meta. A diferença está na engenharia por trás da conexão: o ZAPO é construído sobre uma biblioteca TypeScript leve e de alto desempenho, projetada desde a base para escalar em múltiplas sessões simultâneas, com baixo consumo de memória e caminhos críticos otimizados (zero-copy). Na prática, isso significa menos uso de recursos do servidor e mais estabilidade em operações com grande volume de conexões ativas ao mesmo tempo. O ZAPO também dá controle mais fino sobre autenticação, transporte, o protocolo de criptografia (Signal), estado da aplicação e mídia.
Atenção, risco de banimento: vale o mesmo aviso do Baileys. Por ser uma conexão não oficial, há risco de banimento do número pelo WhatsApp, sob responsabilidade de quem utiliza.
Como configurar / usar (passo a passo): o fluxo de conexão é idêntico ao do Baileys: crie o canal do tipo Zapo (marcado com o selo Beta no seletor), gere o QR Code no card do canal (ou use Usar código de pareamento), escaneie em Dispositivos Conectados no celular e aguarde a confirmação (status CONECTADO). Assim como o Baileys, o Zapo aceita Importação de Mensagens, Configurações Adicionais (Proxy), PIX, mensagens interativas (Resposta rápida, Lista e Botão PIX) e Revalidar sessão.O que o ZAPO não traz para o painel: para economizar recursos do servidor, os canais ZAPO ignoram os Status publicados pelos contatos, as listas de transmissão e os canais do WhatsApp: nada disso é processado nem aparece no atendimento. As demais conversas seguem normais. Além disso, as mensagens recebidas entram numa fila com limite, o que evita picos de uso de CPU no servidor quando chegam muitas mensagens ao mesmo tempo.Benefícios e quando usar: indicado para operações que já usariam uma conexão não oficial no estilo Baileys, mas que têm um volume maior de sessões simultâneas e querem uma engenharia mais moderna e eficiente por trás da conexão.
Mesma recomendação de estabilidade do Baileys: internet estável e bateria carregada no celular conectado. Se a sua operação depende de acompanhar os Status dos contatos pelo painel, prefira outro motor.
Quem usa: AdministradorO que é: uma solução de integração não oficial baseada na biblioteca whatsapp-web.js. Diferente das outras integrações não oficiais, o WebJS funciona automatizando e simulando uma instância real do WhatsApp Web dentro de um navegador interno, rodando no servidor (headless browser). Isso permite usar todas as funcionalidades da interface web original do WhatsApp sem depender da API oficial. Por rodar um navegador em segundo plano, essa conexão pode exigir um pouco mais de processamento do servidor em comparação ao Baileys, mas em troca oferece maior fidelidade aos recursos disponíveis na versão oficial do WhatsApp para navegador. Assim como o Baileys e o Meow, o WebJS também suporta o Código de pareamento como alternativa ao QR Code, e pode ser configurado com Proxy dedicado.
Atenção, risco de banimento: mesmo aviso das demais conexões não oficiais.
Como configurar / usar (passo a passo): o fluxo é o mesmo já descrito no Baileys: criar o canal do tipo WWEBJS (é assim que o WebJS aparece no seletor), gerar o QR Code (ou usar o código de pareamento) no cartão do canal, escanear no celular em Dispositivos Conectados e aguardar a confirmação da conexão.Benefícios e quando usar: vale a pena considerar o WebJS quando a operação depende de algum recurso específico da interface web do WhatsApp que não esteja bem coberto pelo Baileys, e o servidor tem capacidade de processamento de sobra para rodar um navegador em segundo plano.
Por rodar um navegador headless, o consumo de recursos do servidor tende a ser maior. Se a operação tiver muitas conexões WebJS simultâneas, vale monitorar o desempenho do servidor com a equipe de infraestrutura da plataforma.
Quem usa: AdministradorO que é: uma solução de integração não oficial de alto desempenho que atua como um gateway entre o WhatsApp e o PanÐá Zap. Diferente das bibliotecas mais simples, a Evolution API acrescenta uma camada extra de gerenciamento e robustez às instâncias conectadas por QR Code, permitindo operação mais estável em cenários de grande volume de mensagens. As sessões são gerenciadas de forma desacoplada: mesmo que a interface do PanÐá Zap passe por uma atualização, as instâncias no servidor da Evolution permanecem conectadas, reduzindo a necessidade de reparear o número com frequência.
Atenção, risco de banimento: mesmo aviso das demais conexões não oficiais.
Como configurar / usar (passo a passo):
  1. Instalação da Evolution API: antes de qualquer configuração no painel, a Evolution API precisa estar instalada e em execução em um servidor. Por se tratar de um software de código aberto de terceiros, essa instalação (e sua manutenção contínua) normalmente é conduzida pela equipe técnica responsável pela infraestrutura da plataforma, e não pelo administrador do tenant diretamente. O importante para o administrador saber é que o suporte da plataforma não presta assistência para problemas de instalação, configuração ou funcionamento dessa API externa, já que se trata de software de terceiros sem garantia de estabilidade, segurança ou continuidade.
  2. Configuração no painel administrativo: acesse Configurações > Integrações > Evolution API, informe a URL da API (o endereço onde a instância está publicada, sem barra ”/” no final, já que isso causa falha na conexão) e cole a Global Key (chave de administração da instalação). Clique em Verificar Status da API e confirme que o sistema retorna sucesso; as alterações são salvas automaticamente.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Evolution, seguindo o formulário genérico. Este motor também aceita configuração de Proxy dedicado nas configurações adicionais do canal.
  4. Gerar o QR Code, escanear no aparelho e confirmar a conexão: mesmo fluxo já descrito no Baileys.
Benefícios e quando usar: indicada para operações com volume de mensagens maior do que o confortável em Baileys, WebJS ou ZAPO simples, já que a camada extra de gerenciamento da Evolution tende a segurar melhor picos de uso e sobrevive a atualizações da plataforma sem exigir novo pareamento.
Se você já possui uma instância criada diretamente na Evolution, basta criar um canal no PanÐá Zap com o mesmo nome exato da instância: o sistema sincroniza e configura o webhook automaticamente. Não use caracteres especiais (como underline) no nome da instância, pois isso pode causar falhas de sincronização, e saiba que o nome da instância não pode ser alterado depois de criado. Como é um software de código aberto mantido fora da plataforma, problemas de instabilidade ou indisponibilidade da própria Evolution API não são cobertos pelo suporte padrão; trate-a como uma dependência externa de responsabilidade da sua operação (ou da equipe de infraestrutura contratada para mantê-la). Se a integração parar de receber mensagens sem motivo aparente, o primeiro passo de diagnóstico é usar a opção Revalidar Webhook no card do canal, antes de abrir um chamado de suporte.
Quem usa: AdministradorO que é: outra solução de integração não oficial, que se diferencia por ser desenvolvida em Go (Golang), linguagem conhecida pela alta performance e eficiência no gerenciamento de concorrência. Tecnicamente, funciona como um serviço “headless” (sem interface gráfica), o que reduz bastante o consumo de memória RAM e de processamento no servidor, se comparado aos emuladores de navegador como o WebJS. Internamente também é referido como Meow: é o nome que aparece em alguns pontos do sistema, como a opção Revalidar Webhook (Meow).
Atenção, risco de banimento: mesmo aviso das demais conexões não oficiais.
Como configurar / usar (passo a passo):
  1. Verifique a integração: abra Configurações, aba Integrações, item WuzAPI. Se a tela mostrar o aviso Provedor global ativo, o serviço já é fornecido pela plataforma e você não precisa preencher nada: siga para o passo 2. Sem esse aviso, é preciso ter uma instalação própria da WuzAPI (self-hosted, de responsabilidade da sua operação, sem cobertura do suporte da plataforma) e informar a URL da API e a Global Key; use Verificar Status da API para confirmar (as alterações são salvas automaticamente).
  2. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Wuzapi. Este motor aceita Usar código de pareamento (ou o campo Número para pareamento (opcional)) como alternativa ao QR Code e Configurações Adicionais (Proxy).
  3. Gerar o QR Code, escanear no aparelho e confirmar a conexão: mesmo fluxo já descrito no Baileys.
Benefícios e quando usar: por ser mais leve em consumo de recursos (arquitetura headless em Go), é uma boa opção para operações com muitas conexões simultâneas rodando no mesmo servidor.
Mesma observação da Evolution API: trata-se de uma dependência de código aberto mantida fora do produto principal, sem cobertura do suporte padrão para falhas da própria API. Se a integração parar de receber mensagens sem motivo aparente, use primeiro a opção Revalidar Webhook (disponível para os canais Meow) antes de abrir um chamado de suporte.
Quem usa: AdministradorO que é: uma solução de integração não oficial, mas com uma diferença importante em relação às anteriores: é um serviço pago e gerenciado por uma empresa externa (a própria Z-API), e não uma instalação própria.Como configurar / usar (passo a passo):
  1. Contratar a Z-API: antes de qualquer configuração no painel, é preciso contratar o serviço diretamente no site da Z-API. Diferente das APIs auto-hospedadas, a instância precisa ser criada primeiro no painel de controle da própria Z-API; o PanÐá Zap não cria instâncias na Z-API, apenas se conecta a instâncias já existentes.
  2. Configuração no painel administrativo: acesse Configurações > Integrações > Z-API e informe a URL da API (padrão https://api.z-api.io, alterada apenas para instâncias self-hosted) e a Global Key (o “Token de Segurança” gerado nas configurações da sua conta Z-API). As alterações são salvas automaticamente. Se a tela mostrar o aviso Provedor global ativo, a configuração da plataforma tem prioridade e os campos desta tela podem ser ignorados.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Z-API e, na seção Z-API do formulário, preencha API Token e Number ID (Instance ID) com os dados da instância (obtidos no painel da sua conta Z-API).
  4. Gerar o QR Code, escanear no aparelho e confirmar a conexão: mesmo fluxo já descrito no Baileys.
Benefícios e quando usar: indicada para quem prefere terceirizar a hospedagem e a manutenção técnica da conexão não oficial para uma empresa especializada, pagando por isso, em vez de manter uma instalação própria (como Evolution ou Wuzapi).
Como é um serviço pago de terceiros, eventuais instabilidades, limites de uso ou cobranças adicionais seguem os termos comerciais da própria Z-API, e não da plataforma PanÐá Zap. Se a integração parar de receber mensagens sem motivo aparente, use a opção Revalidar Webhook (disponível para os canais Z-API) antes de abrir um chamado de suporte.
Quem usa: AdministradorO que é: outra solução de integração não oficial paga e gerenciada por uma empresa externa (a própria Uazapi), no mesmo espírito da Z-API.Como configurar / usar (passo a passo):
  1. Contratar a Uazapi: antes de qualquer configuração no painel, é preciso contratar o serviço diretamente no site da Uazapi.
  2. Configuração no painel administrativo: acesse Configurações > Integrações > UazAPI e informe a URL da API (a URL do servidor da sua conta Uazapi) e a Global Key (o “Admin Token” fornecido no painel da sua conta). As alterações são salvas automaticamente. Se a tela mostrar o aviso Provedor global ativo, a configuração da plataforma tem prioridade e os campos desta tela podem ser ignorados.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Uazapi. Na seção UaZapi do formulário, existem duas formas de vincular a conexão:
    • Criar uma nova instância: dê um nome à conexão (ex: “Cliente A”) e deixe os campos Number ID (Instance ID) e API Token em branco. Ao salvar, o PanÐá Zap cria a nova instância diretamente na sua conta Uazapi e preenche as credenciais automaticamente.
    • Conectar a uma instância já existente: siga os mesmos passos, mas preencha Number ID (Instance ID) e API Token com os dados de uma instância que já exista na sua conta Uazapi.
  4. Este motor também aceita configuração de Proxy dedicado nas configurações adicionais do canal.
  5. Gerar o QR Code, escanear no aparelho e confirmar a conexão: mesmo fluxo já descrito no Baileys.
Benefícios e quando usar: assim como a Z-API, é indicada para quem prefere terceirizar a infraestrutura da conexão não oficial; a possibilidade de criar a instância direto pelo formulário do PanÐá Zap (sem precisar abrir o painel da Uazapi antes) é um diferencial de praticidade para quem está conectando muitos números. É também, junto com o Baileys, um dos motores com suporte nativo a Botões e Lista como mensagens interativas.Como o status do canal é conferido: o status do canal Uazapi é conferido a cada 10 minutos (o ícone de ajuda ao lado de API Token, no formulário do canal, traz este resumo). Se a Uazapi responder que a instância está desconectada, que o token é inválido ou que a instância não existe, o canal é marcado como desconectado na hora. Se ela passar mais de 30 minutos dizendo que a instância está conectando ou pausada, ou recusando o acesso, o canal é revalidado e, se não voltar, marcado como desconectado. Mensagens que chegarem enquanto ele estiver desconectado não entram. Se a instância voltar a responder conectada em até 24 horas, o canal religa sozinho.
Por ser um serviço pago de terceiros, condições comerciais, limites de uso e disponibilidade seguem os termos da própria Uazapi. Se a integração parar de receber mensagens sem motivo aparente, use a opção Revalidar Webhook (disponível para os canais UazAPI) antes de abrir um chamado de suporte.
Quem usa: AdministradorO que é: integração não oficial com a Evolution Go API, que conecta um número comum por QR Code no mesmo modelo da Evolution API, com configuração própria.
Atenção, risco de banimento: mesmo aviso das demais conexões não oficiais.
Como configurar / usar (passo a passo):
  1. Configuração no painel administrativo: acesse Configurações > Integrações > Evolution Go e informe a URL da API e a Global Key da instalação; use Verificar Status da API para confirmar (as alterações são salvas automaticamente). Se a tela mostrar o aviso Provedor global ativo, a configuração da plataforma tem prioridade. Sem nenhuma configuração, o tipo aparece com o alerta Integração não configurada e o sistema não deixa criar o canal.
  2. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Evolution Go. O nome do canal não pode ser alterado depois da criação. Este motor aceita o campo Número para pareamento (opcional) e Configurações Adicionais (Proxy).
  3. Gerar o QR Code, escanear no aparelho e confirmar a conexão: mesmo fluxo já descrito no Baileys.
Se o cartão mostrar o botão Passkey, a conta do WhatsApp exige verificação por chave de acesso: clique nele e siga a janela (abrir o WhatsApp Web e confirmar com biometria ou PIN; é preciso ter a extensão Passkey Linker instalada no navegador).Recursos: Revalidar Webhook (Evo Go) no menu do cartão, mensagens interativas pelo menu Interativo UazAPI no atendimento e ligações via WaVoIP, quando esse recurso está liberado para a sua empresa.
Quem usa: AdministradorO que é: um canal Baileys criado já com a biblioteca InfiniteAPI. No seletor ele aparece como InfiniteAPI; depois de criado, o cartão mostra o canal como Baileys, com um ícone que indica a biblioteca InfiniteAPI. Vale o mesmo aviso de risco de banimento do Baileys. A tela descreve essa biblioteca como voltada a mensagens interativas, com suporte a botões, listas, carrossel e catálogo.Como configurar / usar (passo a passo): em Administração > Canais > Adicionar Canal, selecione InfiniteAPI e siga o mesmo fluxo de conexão do Baileys (QR Code ou código de pareamento).Armazenamento das chaves da sessão (Arquivos ou SQLite): só o Administrador vê esta opção, e só em canal Baileys que usa a biblioteca InfiniteAPI. Ela fica no campo Armazenamento do estado de sessão (auth), dentro da seção recolhível InfiniteAPI (ao criar o canal, já aberta) ou Lib Baileys (ao editar). Passe o mouse no ícone de ajuda ao lado do nome do campo para ver a explicação completa. As opções são:
  • Arquivos (padrão): as chaves da sessão do WhatsApp ficam em muitos arquivos no servidor.
  • SQLite (auth.db) - recomendado: as chaves ficam em um único arquivo (auth.db), evitando o acúmulo de milhares de arquivos.
Ao criar o canal, escolha a opção e crie normalmente. Para trocar em um canal já criado, abra Editar, escolha a nova opção e clique em Aplicar armazenamento (botão próprio do campo, que só habilita quando a escolha é diferente da atual; Salvar alterações não aplica a troca). O canal é reconectado automaticamente, a troca acontece na próxima conexão e não exige novo QR Code. Se a migração para o SQLite não for concluída, o canal continua em Arquivos e reconecta sem novo QR Code, e aparece o aviso Migração para SQLite não concluída. Canal mantido em Arquivos e reconecta sem novo QR.
Logo depois da troca, algumas mensagens de grupo podem demorar a aparecer enquanto o WhatsApp refaz as chaves de cada grupo, e o primeiro envio em cada grupo leva um pouco mais. No SQLite, as chaves ficam no servidor sem a criptografia usada em Arquivos: proteja o acesso ao servidor e às cópias de segurança.
Quando o servidor não tem o componente do SQLite: a opção SQLite (auth.db) - recomendado aparece desabilitada, com a mensagem de que o SQLite está indisponível neste servidor por falta de um componente do sistema, e os canais usam Arquivos até a atualização. Se o canal já estava marcado como SQLite, o campo mostra um aviso informando que ele está funcionando com Arquivos: nada se perde, e quando o sistema for atualizado com o componente o canal passa para o SQLite sozinho na próxima vez que iniciar, sem novo QR Code (essa primeira inicialização pode demorar um pouco mais). Nos dois casos, fale com o suporte do PanÐá Zap para atualizar o sistema.

Recursos comuns entre os motores

Alguns recursos aparecem em mais de um motor não oficial, e vale ter uma visão consolidada de onde cada um está disponível: Benefícios e quando usar: use esta tabela como referência rápida na hora de escolher entre os motores não oficiais quando um recurso específico (mensagens interativas, ligações de voz, código de pareamento) for decisivo para a operação, em vez de reler o detalhamento de cada canal individualmente.
Para o passo a passo completo de conexão de canais oficiais (API WABA via OAuth ou BSP), consulte a página Canais Meta Oficiais. Para os demais tipos de canal (Telegram, e-mail, Webchat e marketplaces), consulte Outros Canais.