Skip to main content
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, ZAPO, WebJS, Evolution, 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 genérico (nome, atribuições, recursos do canal etc.).
  2. Gerar o QR Code: depois de salvar as configurações iniciais, localize o card do canal e clique em Novo QR Code. Um modal 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. O modal fecha automaticamente e o status do card muda para CONNECTED.
O QR Code expira por segurança (geralmente em 60 segundos); se o tempo esgotar antes da leitura, clique em Novo QR Code novamente para gerar uma nova imagem. 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 de Adicionar 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: a disponibilidade varia conforme a tabela abaixo.
Essas opções ficam junto dos campos gerais de qualquer canal (Nome, Atribuições de ChatFlow/Fila/Usuário, Mensagem de Despedida, Webhook do Canal, Recursos do Canal como avaliação automática e transcrição de áudio). Consulte a página de Canais para o detalhamento do formulário genérico 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: por isso concentra a maior parte dos recursos complementares (Código de pareamento, Importar mensagem do Aparelho, integração de chamadas de voz via WaVoIP e o suporte nativo a Botões e Listas clicáveis).
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 genérico descrito em “Como Conectar um Canal” (nome, atribuições, recursos do canal etc.).
  2. Gerar o QR Code: depois de salvar as configurações iniciais, localize o card do canal e clique em Novo QR Code. Um modal 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, use o Código de pareamento e digite o código diretamente no celular, sem precisar escanear nada.
  4. Confirmar a conexão: aguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fecha automaticamente e o status do card muda para CONNECTED.
O QR Code expira por segurança (geralmente em 60 segundos); se o tempo esgotar antes da leitura, clique em Novo QR Code novamente para gerar uma nova imagem.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. É também o único motor não oficial com suporte nativo a mensagens interativas (Botões e Lista, com até vários botões de resposta rápida ou um menu com seções), a importação do histórico de mensagens do celular no momento da conexão, e a integração de chamadas de voz via WaVoIP.
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 a conexão apresentar falhas persistentes mesmo com o celular estável, existe um recurso de “Resetar Baileys” nas ferramentas de manutenção do sistema, 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 pelo formulário genérico, gere o QR Code no card do canal, escaneie em Dispositivos Conectados no celular e aguarde a confirmação (status CONNECTED). O código também expira em cerca de 60 segundos.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.
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 WebJS, gerar o QR Code (ou usar o Código de pareamento) no card 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” e o Código de pareamento.
Atenção, risco de banimento: mesmo aviso das demais conexões não oficiais.
Como configurar / usar (passo a passo):
  1. Instalação da WUZAPI (Meow API): assim como a Evolution API, essa API precisa estar instalada e publicada em um servidor antes de qualquer configuração no painel. Essa instalação self-hosted (que envolve preparar o servidor, compilar a aplicação e mantê-la rodando como um serviço persistente) é conduzida pela equipe técnica de infraestrutura da plataforma, não pelo administrador do tenant. É importante que o administrador saiba que, por ser um software de código aberto de terceiros, o suporte da plataforma não presta assistência para problemas de instalação, configuração ou funcionamento dessa API externa, sem garantia de estabilidade, segurança ou continuidade.
  2. Configuração no painel administrativo: acesse Configurações > Integrações > WuzAPI, informe a URL da API (endereço base da instalação) e a Chave Global (o token de administrador da instalação). Clique em Verificar Status da API e confirme o sucesso; as alterações são salvas automaticamente.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Wuzapi, seguindo o formulário genérico. Este motor aceita Código de pareamento como alternativa ao QR Code e configuração de Proxy dedicado.
  4. 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, informe a URL da API (padrão https://api.z-api.io, alterada apenas para instâncias self-hosted) e a Chave Global (o “Token de Segurança” gerado nas configurações da sua conta Z-API). Clique em Verificar Status da API e confirme o sucesso; as alterações são salvas automaticamente.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Z-API, seguindo o formulário genérico, e preencha os dois campos adicionais exigidos por essa integração: ID da Instância e Token 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, informe a URL da API (a URL do servidor da sua conta Uazapi) e a Chave Global (o “Admin Token” fornecido no painel da sua conta). Clique em Verificar Status da API e confirme o sucesso; as alterações são salvas automaticamente.
  3. Em Administração > Canais > Adicionar Canal, crie o canal do tipo Uazapi. 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 ID da Instância e 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 ID da Instância e 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.
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.

​
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.