# API Oficial vs API Não Oficial {% hint style="success" %} A **API Oficial (WABA)** é a conexão direta e garantida pela Meta (dona do WhatsApp), oferecendo máxima estabilidade e segurança, mas com custos por conversa. As **APIs Não Oficiais** são conexões alternativas, sem custo inicial de mensagem, mas sem garantia de estabilidade. **O Z-PRO suporta ambas as opções**, dando a você liberdade para escolher a que melhor se adapta ao seu modelo de negócio. {% endhint %} O Z-PRO suporta quatro categorias de conexão com o WhatsApp, cada uma com diferentes níveis de estabilidade, custo e responsabilidade: 1. **API Oficial (WABA):** A conexão direta e garantida pela Meta, com máxima estabilidade e custos por conversa. 2. **APIs Não Oficiais Nativas (via QR Code):** Conexões incluídas no Z-PRO (Baileys e WWebJS), sem custo adicional, mas com responsabilidade de estabilidade do usuário. 3. **APIs Não Oficiais Gerenciadas (Pagas):** Serviços de terceiros (Z-API, Uazapi) que oferecem a conexão como um serviço pago, com suporte e estabilidade gerenciados por eles. 4. **APIs Não Oficiais Auto-hospedadas (Self-Hosted):** Aplicações externas (Evolution API) que o usuário instala e gerencia em seu próprio servidor. **A escolha da API de conexão do WhatsApp é uma das decisões técnicas e de negócio mais importantes para a sua operação. Ela define o equilíbrio entre custo, controle e confiabilidade do seu serviço.** ## **1. API Oficial (WABA - WhatsApp Business API)** A API Oficial é o caminho legítimo, construído e mantido pela própria Meta para que empresas se comuniquem em escala. **✅ Principais Vantagens:** * **Estabilidade Garantida:** Por ser a solução oficial, ela é extremamente confiável, com garantia de funcionamento de 100% da parte da Meta e do Z-PRO. * **Máxima Segurança:** A comunicação é criptografada e segue todas as políticas de segurança da Meta. * **Credibilidade e Acesso a Recursos:** Usar a API Oficial transmite profissionalismo e segurança. Além disso, garante acesso antecipado a novas funcionalidades que a Meta lança para o ambiente de negócios, como novos tipos de botões e formatos de mensagem. **⚠️ Pontos a Considerar:** * **Custo por Conversa:** A Meta cobra por "janelas de conversa" de 24 horas. As primeiras 1.000 conversas iniciadas pelo cliente por mês são gratuitas, mas as demais são pagas. Clique aqui se quer entender sobre os custos: * **Processo de Aprovação:** Requer a criação de uma conta no Gerenciador de Negócios da Meta e a verificação da empresa. Explicamos nesse vídeo: *** ## **2. APIs Não Oficiais Nativas (Conexão via QR Code)** Estas são as opções de conexão não oficial **incluídas por padrão no Z-PRO**, ativadas através da leitura de um QR Code. **✅ Vantagens:** * **Sem Custo Adicional:** O uso destas APIs está incluso no valor da licença do Z-PRO. * **Simplicidade de Conexão:** A ativação é rápida e direta pelo painel administrativo. **⚠️ Pontos a Considerar:** * **Instabilidade:** Por não serem oficiais, estão sujeitas a desconexões quando o WhatsApp atualiza sua plataforma. * **Risco de Bloqueio:** A utilização de qualquer sistema não oficial infringe os Termos de Serviço do WhatsApp, o que representa um risco contínuo de o número ser banido. * **Responsabilidade do Usuário:** A estabilidade da conexão é de responsabilidade do administrador da plataforma. **As duas tecnologias nativas disponíveis são:** * **Baileys:** Interage diretamente com o protocolo WebSocket (WAM) do WhatsApp. É uma abordagem mais leve e com melhor performance, mas historicamente apresenta menor compatibilidade com o gerenciamento de conversas em grupos. * **WWebJS:** Simula a interface do WhatsApp Web em um navegador no servidor. É uma tecnologia mais pesada e mais lenta para carregar, mas tende a ter maior compatibilidade com todas as funcionalidades, incluindo grupos. O Z-PRO oferece ambas as opções para que o administrador escolha a tecnologia mais adequada à sua necessidade. *** ## **3. APIs Não Oficiais Auto-hospedadas (Self-Hosted)** Estas são aplicações de código aberto que você mesmo instala e gerencia em seu próprio servidor, de forma separada do Z-PRO. * **Exemplos:** Evolution API, Wuzapi (Meow) **✅ Vantagens:** * **Custo Reduzido:** Não há mensalidades para o uso da API em si, apenas os custos de manter seu servidor. * **Controle Total:** O administrador tem total governança sobre a instalação e os dados da API externa. **⚠️ Pontos a Considerar:** * **Responsabilidade Total:** O usuário é o único responsável por instalar, manter, atualizar e garantir a estabilidade da API externa. * **Complexidade Técnica:** Exige um maior conhecimento técnico para a instalação e manutenção. *** ## **4. APIs Não Oficiais Gerenciadas (Pagas)** Estas são soluções oferecidas como um serviço (SaaS) por empresas externas especializadas. Elas criam e mantêm a conexão não oficial, cobrando uma mensalidade pelo serviço. * **Exemplos:** [Z-API](https://www.z-api.io/), [Uazapi](https://uazapi.dev/) **✅ Vantagens:** * **Estabilidade Gerenciada:** A empresa provedora da API é responsável por manter a conexão funcionando, reduzindo a carga de manutenção do administrador do Z-PRO. * **Suporte Externo:** O usuário conta com o suporte técnico da empresa que fornece a API para resolver problemas de conexão. **⚠️ Pontos a Considerar:** * **Custo Mensal:** Há uma taxa de assinatura recorrente paga diretamente ao provedor da API. * **Risco de Bloqueio:** Embora gerenciadas, ainda operam sob os mesmos riscos de qualquer API não homologada pela Meta. {% hint style="warning" %} **Status Atual no Z-PRO:**\ As integrações com as APIs **Z-API** e **Uazapi** estão atualmente em **fase de desenvolvimento e testes** em nossa plataforma. {% endhint %} ### Riscos Por questões de flexibilidade, habilitamos o suporte para APIs não oficiais no sistema. No entanto, é importante destacar que o uso de APIs não oficiais pode apresentar riscos como: * **Desconexões frequentes** * **Perda de mensagens enviadas ou recebidas** * **Instabilidade no funcionamento** {% hint style="danger" %} Reforçamos que **não garantimos a estabilidade ou o suporte pleno** para conexões realizadas por APIs não oficiais. Recomendamos fortemente o uso da **API Oficial do WhatsApp** para garantir a melhor experiência e evitar problemas operacionais. {% endhint %} ### Informações e Recomendações * Antes de conectar seu WhatsApp no sistema, remova a conexão com o WhatsApp Web. * Depende do smartphone. * Necessita de reconexão periódica. * Para o perfeito funcionamento, mantenha o telefone sincronizado sempre ligado e conectado a internet, desative o descanso de tela e mantenha o app do WhatsApp aberto * Arquive pelo celular conversas dispensáveis ou mais antigas * Recomendamos o uso do navegador Chrome e do sistema operacional Windows * Não abrir o WhatsApp Web com o número sincronizado na plataforma em outro navegador. Caso isso aconteça, o funcionamento poderá ser impactado ### **Conexão de Múltiplos Números na API Não Oficial e Riscos Associados** Ao conectar múltiplos números de WhatsApp na mesma aplicação e compartilhar o mesmo endereço de IP e infraestrutura física (como uma VPS), há um risco significativo de que o WhatsApp identifique essa prática como um comportamento irregular. Isso pode resultar em: * Marcações do IP ou da infraestrutura pela Meta * Desconexões frequentes e redução da estabilidade * Risco de banimento permanente de números conectados * Bloqueios em cascata, afetando todos os clientes na mesma plataforma Além disso, o uso de campanhas de disparo em massa intensifica esses problemas, já que tais atividades são frequentemente detectadas como abuso, aumentando as chances de marcação da infraestrutura e dos números envolvidos. {% hint style="warning" %} **Importante:** Uma vez que a infraestrutura seja marcada pelo WhatsApp, todos os números conectados à plataforma podem sofrer consequências em cascata. Recomendamos seguir as melhores práticas e, sempre que possível, priorizar o uso da **API Oficial do WhatsApp** para garantir maior estabilidade e segurança para sua operação. {% endhint %} #### Recomendações: 1. **Escala Horizontal:** Avalie separar números em diferentes aplicações ou servidores para distribuir a carga e reduzir o compartilhamento do IP. 2. **Uso de Proxies:** Configure proxies dedicados para isolar as conexões e minimizar os riscos de detecção e marcação de infraestruturas compartilhadas. 3. **Evite Disparos em Massa:** Sempre utilize práticas éticas e que respeitem os termos de uso do WhatsApp. {% hint style="info" %} Se tiver dúvidas ou precisar de suporte para configurar a API Oficial, nossa equipe está à disposição para ajudar! {% endhint %} ## Bloqueios e Banimentos {% hint style="danger" %} **Existe alguma possibilidade do WhatsApp bloquear meu número?** SIM, A POSSIBILIDADE EXISTE! {% endhint %} ### **O WHATSAPP NÃO TOLERA SPAM!** O WhatsApp leva o combate ao spam muito a sério, o que faz com que a plataforma seja mais valorizada do que o SMS. Já percebeu como ignoramos mensagens acumuladas no SMS, mas paramos tudo para ver um WhatsApp? Isso acontece porque as mensagens geralmente vêm de contatos conhecidos, e promoções são bem menos frequentes por lá. ## Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."? {% embed url="" %} Às vezes, o aviso acima poderá ser exibido no lugar de uma mensagem. No WhatsApp, suas mensagens pessoais são protegidas com a criptografia de ponta a ponta. Dessa forma, elas ficam somente entre você e a pessoa com quem você está conversando. Ninguém mais pode ler nem ouvir o conteúdo dessas conversas, nem mesmo o WhatsApp. Existem alguns motivos para que uma mensagem seja substituída pelo aviso "Aguardando mensagem. Essa ação pode levar alguns instantes.": * Não foi possível entregar a mensagem. * Você ou a outra pessoa reinstalou o WhatsApp recentemente. * Você ou a outra pessoa não está usando a [versão mais recente do WhatsApp](https://faq.whatsapp.com/5481509731946576?helpref=faq_content). * Você trocou de celular e instalou o WhatsApp em um dispositivo novo usando o mesmo número de telefone. É possível seguir algumas etapas para tentar solucionar o problema. ### Acesse o WhatsApp Abra o app e peça para que a outra pessoa acesse o WhatsApp ao mesmo tempo que você. ### Verifique sua conexão à internet Confira se sua conexão à internet é estável. Experimente alternar sua conexão entre rede Wi-Fi e dados móveis. Se não houver uma rede Wi-Fi disponível ou se a rede de dados móveis estiver instável, procure um local onde sua conexão funcione melhor.Saiba como resolver problemas de conexão no WhatsApp [neste artigo](https://faq.whatsapp.com/852892549070029?helpref=faq_content). ### Atualize o WhatsApp Confira se você e a pessoa com quem você está conversando têm a versão mais recente do WhatsApp instalada no dispositivo. Saiba como atualizar o WhatsApp [neste artigo](https://faq.whatsapp.com/5481509731946576/?helpref=faq_content). ### Peça para que a pessoa envie a mensagem novamente Caso a mensagem não tenha sido entregue, peça para que a outra pessoa envie a mensagem novamente. ### Use seu dispositivo principal Acesse o WhatsApp no seu dispositivo Android ou iOS principal. O dispositivo principal é o celular usado para registrar sua conta do WhatsApp.Observação: para que os demais dispositivos permaneçam conectados à sua conta, é necessário acessar o WhatsApp no seu celular principal a cada 14 dias. ### Desconecte o dispositivo e conecte-o novamente Siga as etapas apresentadas [neste artigo](https://faq.whatsapp.com/1317564962315842?helpref=faq_content) para desconectar seu dispositivo conectado e conectá-lo novamente. ### **Respondendo às Suas Principais Dúvidas** **1. O que exatamente o Z-PRO garante?**\ Nós oferecemos **100% de garantia de funcionalidade e estabilidade para a API Oficial**. Para as APIs não oficiais, nós garantimos que nossa plataforma está pronta para se conectar, mas o funcionamento e a estabilidade da conexão em si dependem de fatores externos que estão fora do nosso controle. **2. Se a API Oficial é melhor, por que alguém usaria a Não Oficial?**\ Principalmente por dois motivos: **custo e simplicidade inicial**. Para quem está começando, testando uma ideia ou tem um volume muito baixo de mensagens, a API não oficial permite iniciar uma operação sem o custo por conversa e com menos burocracia. **3. Qual é o custo real da API Oficial?**\ A cobrança é feita pela Meta e varia por país. Ela se baseia em "conversas" de 24 horas. Por exemplo, no Brasil, uma conversa iniciada pela empresa custa alguns centavos de dólar. Para ver a tabela de preços oficial e atualizada, você pode consultar diretamente a página da Meta: [**Página de Preços da API do WhatsApp**](https://developers.facebook.com/docs/whatsapp/pricing?locale=pt_BR) **4. Usar a API Não Oficial pode bloquear meu número?**\ Sim, o uso de qualquer sistema não oficial vai contra os termos de serviço do WhatsApp. O risco de bloqueio sempre existirá. Por isso, para operações críticas e de longo prazo, a recomendação é sempre a API Oficial. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ajuda.zdg.com.br/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.