--- title: "API de WhatsApp oficial vs não oficial | D-API" description: "API de WhatsApp oficial vs não oficial: compare custo, aprovação, risco e limites por critério e veja qual escolher em cada cenário, ou como usar as duas." url: https://d-api.cloud/api-whatsapp-oficial-vs-nao-oficial --- Guia da API de WhatsApp # API de WhatsApp oficial vs não oficial: qual escolher A API oficial é da Meta: exige conta verificada e template aprovado para iniciar conversa, e cobra por mensagem. A não oficial conecta o número por QR, sem aprovação, e costuma cobrar por conexão. A escolha depende de quem você vai contatar, em que volume e com que tolerância a risco. Por Time de engenharia D-APIAtualizado em 24 de set de 20265 min de leitura ## A diferença em uma frase Na oficial, você opera dentro das regras e da cobrança da Meta, em troca de estabilidade e respaldo. Na não oficial, você opera o próprio WhatsApp do número, com liberdade e custo previsível, em troca de assumir a responsabilidade pelo comportamento de envio. As duas são formas legítimas de ter uma [API de WhatsApp](https://d-api.cloud/); o erro é escolher sem olhar o cenário. ## Comparativo por critério | Critério | Oficial (Cloud API) | Não oficial (QR) | | --- | --- | --- | | Tempo até a primeira mensagem | Depende de cadastro e verificação na Meta | Minutos: criar sessão e ler o QR | | Número | Registrado na plataforma da Meta, conforme as regras dela | O número atual, que continua no celular | | Iniciar conversa | Só com template aprovado | Mensagem livre | | Cobrança | Por template, varia por categoria e país, mais taxa do provedor | Por conexão, sem custo por mensagem | | Grupos | Limitados | Criar, gerenciar participantes, enviar | | Risco de bloqueio | Baixo dentro das regras da Meta | Depende do padrão de envio e da infraestrutura | | Selo e perfil verificado | Possível, conforme critérios da Meta | Não se aplica | | Dependência | Regras e prazos da Meta | Qualidade do provedor | ## Quando escolher cada uma ### Escolha a oficial quando - **Você precisa iniciar conversa com quem nunca falou com você,** em escala, como avisos para uma base grande. Template aprovado é o caminho previsto para isso. - **O seu cliente ou o seu setor exige.** Bancos, seguradoras e empresas com área de compliance costumam pedir o canal oficial por contrato. - **O número é a marca.** Um número central de atendimento, com perfil verificado, que não pode correr risco de bloqueio. ### Escolha a não oficial quando - **Cada cliente seu conecta o próprio número.** É o caso típico de SaaS: o cliente lê um QR na sua tela e começa a usar, sem passar por cadastro na Meta. - **A conversa é contínua e já existe relação.** Atendimento, follow-up comercial, confirmação de agenda, suporte. - **Você precisa de grupos** ou de recursos do aplicativo comum que a oficial não cobre. - **O custo por mensagem inviabiliza o modelo de negócio,** como em operações com alto volume de mensagens por número. ### Use as duas quando O cenário mais comum em produtos maduros é misto: a maioria dos clientes na não oficial, pela velocidade de ativação e pelo custo, e alguns na oficial, por exigência deles ou para um fluxo específico, como notificações para quem ainda não iniciou conversa. Isso só é viável se a integração não precisar ser duplicada. ## Na D-API, as duas usam a mesma API A diferença fica na criação da sessão. O campo `type` aceita `unofficial` ou `cloud_api`, e o `sessionId` resultante funciona nas mesmas rotas de envio: ``` # Não oficial: conecta depois por QR curl -X POST https://api.d-api.cloud/api/v1/sessions \ -H "Authorization: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "loja-sp", "type": "unofficial" }' # Oficial: usa os dados da conta na Meta curl -X POST https://api.d-api.cloud/api/v1/sessions \ -H "Authorization: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "matriz-oficial", "type": "cloud_api", "wabaId": "SEU_WABA_ID", "phoneNumberId": "SEU_PHONE_NUMBER_ID", "accessToken": "SEU_ACCESS_TOKEN" }' ``` Depois disso, um envio de texto para `loja-sp` ou para `matriz-oficial` é a mesma chamada em `/api/v1/messages/send/text`. Na conexão oficial, o webhook pode vir no formato normalizado, igual ao da não oficial, ou no formato original da Meta, se o seu sistema já trabalha com ele. O que é exclusivo de um modelo continua exclusivo. O envio de template aprovado, em `/api/v1/messages/send/template`, só funciona em conexões `cloud_api`; numa sessão não oficial, a API responde com erro 400 e o código `NOT_CLOUD_API`. Isso deixa explícito, no próprio código, qual fluxo depende de qual modelo. ## Custo, risco e o que ninguém conta Dois pontos costumam ficar de fora das comparações. O primeiro: na oficial, o que determina o custo não é quantos números você tem, e sim quantas conversas você inicia. Um produto que manda lembretes todos os dias para uma base grande sente isso rápido. O detalhamento está em [quanto custa uma API de WhatsApp](https://d-api.cloud/quanto-custa-api-de-whatsapp). O segundo: na não oficial, o risco de bloqueio não é uma loteria. Ele depende de consentimento, volume e conteúdo, e a infraestrutura reduz o estrago quando algo dá errado. Na D-API, cada conexão roda isolada e com IP próprio, então o problema de um número não contamina os outros. As práticas que mais fazem diferença estão em [como evitar banimento na API de WhatsApp](https://d-api.cloud/como-evitar-banimento-api-whatsapp). Para ir fundo em cada modelo, veja as páginas da [API oficial de WhatsApp](https://d-api.cloud/api-oficial-de-whatsapp) e da [API não oficial de WhatsApp](https://d-api.cloud/api-nao-oficial-de-whatsapp). ## Perguntas frequentes ### A API não oficial é ilegal? Não se trata de lei, e sim das regras de uso do WhatsApp. A API não oficial conecta o número como um aparelho vinculado, do mesmo jeito que o WhatsApp Web. O risco real é de bloqueio do número quando o envio desrespeita essas regras, e por isso o comportamento de envio importa tanto. ### Posso usar o mesmo número nas duas APIs ao mesmo tempo? Em geral, cada número fica em um dos modelos. A conexão por QR depende do aplicativo no celular, e a Meta tem regras próprias sobre o que acontece com o aplicativo quando o número é registrado na plataforma oficial. Como essas regras mudam, confira a situação atual antes de migrar um número. ### Qual das duas é mais barata? Depende do volume e do tipo de mensagem. A oficial cobra por template enviado, então fica cara quando você inicia muitas conversas. A não oficial cobra por conexão, então o custo não muda com o volume. Para muitos números com volume alto, a não oficial costuma sair mais barata. ### Preciso reescrever a integração para trocar de uma para outra? Na D-API, não. O tipo é definido na criação da sessão, e as rotas de envio e o webhook normalizado são os mesmos. O que muda é o que só existe na oficial, como o envio de template aprovado. ### Qual é mais estável? A oficial tem a Meta como garantia de disponibilidade e não depende de um celular pareado. A não oficial depende da qualidade da infraestrutura do provedor: reconexão automática, isolamento entre números e IP por conexão fazem a diferença entre uma queda por mês e uma por dia. Teste a API de WhatsApp da D-API3 dias grátis, sem cartão.[Começar trial grátis](https://app.d-api.cloud/register) ## Continue lendo - [Guia da API de WhatsAppComo evitar banimento](https://d-api.cloud/como-evitar-banimento-api-whatsapp) - [Guia da API de WhatsAppAPI de WhatsApp com QR Code](https://d-api.cloud/api-whatsapp-qr-code) - [Guia da API de WhatsAppMúltiplos números no WhatsApp](https://d-api.cloud/api-whatsapp-multiplos-numeros) - [Guia da API de WhatsAppWebhook de WhatsApp](https://d-api.cloud/webhook-api-whatsapp) ## Teste a API de WhatsApp da D-API Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade. [Começar trial grátis](https://app.d-api.cloud/register)[Ver documentação](https://docs.d-api.cloud/)