Integrações

QR Code ou API oficial do WhatsApp: o que muda na prática

Capa da Tiqtech com o título QR Code ou API oficial do WhatsApp: o que muda na prática

Resposta direta: qual é a diferença entre os dois caminhos

A Meta documenta uma plataforma de mensagens comerciais por API, a Plataforma do WhatsApp Business. Na documentação oficial, QR code é outra coisa: um ponto de entrada que leva o cliente a abrir a conversa. QR Code ou API oficial, portanto, não são dois modos de ligar o mesmo número, e a comparação começa por separar os dois termos.

Todo fato aqui vem de página publicada pela Meta ou pelo WhatsApp, lida em 18/09/2026. Onde a documentação não responde, o texto diz que não responde.

O que a documentação oficial chama de QR code do WhatsApp

Na documentação da Business Management API, QR code é um recurso de entrada de conversa. A página descreve a mecânica: “customers can simply scan QR codes with their mobile device camera or type in a short link to begin a chat thread”, ou seja, o cliente aponta a câmera para o código, ou digita um link curto, e inicia uma conversa (QR codes e links curtos, verificado em 18/09/2026).

A mesma página dá o nome que a Meta usa para a função: “WhatsApp QR codes and short links create a digital doorstep for businesses, enabling them to stay connected with their existing customers and connect with new ones”, uma porta de entrada digital para a empresa. E publica um teto: “A single WABA phone number cannot be associated with more than 2,000 QR codes and short links”, um número não pode ter mais de 2.000 códigos e links curtos associados.

O mercado, porém, usa a expressão “QR Code” para outra coisa: o pareamento do número da empresa a um sistema externo pela leitura do código do WhatsApp Web. Nenhuma das páginas da Meta consultadas em 18/09/2026 publica esse segundo uso como produto, e este artigo não descreve o funcionamento de integrações de terceiros.

Quando um fornecedor diz que conecta “por QR Code”, ele não está falando do recurso documentado acima. São dois assuntos com o mesmo nome, e a primeira pergunta útil é qual deles está sobre a mesa.

O que a Plataforma do WhatsApp Business exige para funcionar

O nome oficial está no título da página do produto: “Plataforma do WhatsApp Business | APIs de mensagens comerciais”, apresentada como “Sua plataforma de mensagens comerciais para conquistar o engajamento do cliente” (página oficial, verificado em 18/09/2026).

A documentação de início da Cloud API lista o que precisa existir antes da primeira mensagem, em três passos literais (primeiros passos da Cloud API, verificado em 18/09/2026):

  • “Select an existing business portfolio or create a new one.”: selecionar uma carteira de negócios existente ou criar uma nova.
  • “Connect your app to a WhatsApp Business account. This connection allows your app to access the WhatsApp Cloud API.”: conectar o aplicativo a uma conta do WhatsApp Business, e é essa conexão que dá ao aplicativo acesso à Cloud API.
  • “Click the Start using the API button to set up the API by adding a phone number.”: configurar a API adicionando um número de telefone.

Repare no que a lista não tem: tela de atendimento. O produto é um conjunto de APIs, então a conversa é lida e respondida na ferramenta de quem integra. A decisão sobre a API vem sempre acompanhada de uma decisão sobre o software de atendimento, mapeada nas rotas de integração de um CRM.

Quanto custa, pelo que a Meta publica

A página oficial de preços mudou o modelo e traz a data da virada: “Effective July 1, 2025, Meta charges on a per-message basis”, a cobrança passou a ser por mensagem a partir de 1º de julho de 2025 (preços da plataforma, verificado em 18/09/2026). Material que ainda descreve cobrança por conversa está falando do modelo anterior.

O que é cobrado e o que não é, pela mesma página:

  • “All marketing template messages are charged.”: todo modelo de marketing é cobrado.
  • “All non-template messages are free”: mensagens fora de modelo são gratuitas.
  • “Utility templates delivered within an open customer service window are free.”: modelo de utilidade entregue dentro de uma janela de atendimento aberta é gratuito.

A janela de atendimento dura 24 horas e abre com a mensagem do cliente. A página acrescenta a regra de resposta: “If you respond within 24 hours using any type of message, the message will be free, and a Free Entry Point window will be opened”, responder dentro de 24 horas com qualquer tipo de mensagem é gratuito e abre uma janela de ponto de entrada gratuito, de 72 horas.

Falta uma parte da conta, e ela não está em página da Meta: o preço final depende também do fornecedor que intermedeia a conexão.

O que os Termos do WhatsApp proíbem

Os Termos de Serviço do WhatsApp têm data de vigência publicada de 4 de janeiro de 2021 e listam condutas proibidas na seção “Acceptable Use Of Our Services”. Quatro delas tocam este artigo (Termos de Serviço, verificado em 18/09/2026):

  • “sending illegal or impermissible communications such as bulk messaging, auto-messaging, auto-dialing, and the like”: enviar comunicações ilegais ou não permitidas, como mensagens em massa, mensagens automáticas e discagem automática.
  • “reverse engineer, alter, modify, create derivative works from, decompile, or extract code from our Services”: fazer engenharia reversa, alterar, modificar, criar obras derivadas, descompilar ou extrair código dos serviços.
  • “gain or attempt to gain unauthorized access to our Services or systems”: obter ou tentar obter acesso não autorizado aos serviços ou sistemas.
  • “create accounts for our Services through unauthorized or automated means”: criar contas por meios não autorizados ou automatizados.

Isso é texto de contrato, não previsão de punição. Nenhuma página da Meta consultada em 18/09/2026 descreve o que acontece com um número conectado por ferramenta não autorizada, então este guia não afirma consequência nenhuma.

É também a única resposta possível para “qual API do WhatsApp é não oficial”. A Meta publica o que os Termos proíbem e o que documenta como caminho suportado, não uma lista de fornecedores reprovados. Este artigo não nomeia empresa nessa chave.

Usar o app e a API no mesmo número: o que a Meta documenta

A escolha nem sempre é entre um caminho e outro. A Meta documenta o modo Coexistence, em que o mesmo número funciona no app WhatsApp Business e na Cloud API ao mesmo tempo. A página define o público: permite “business customers to onboard using their existing WhatsApp Business app account and phone number”, empresas que já usam o app entram com a mesma conta e o mesmo número (onboarding de usuários do app, verificado em 18/09/2026).

Quatro pontos dessa página mudam o desenho da operação:

  • Histórico. “WhatsApp keeps messaging history between both apps in sync”: o WhatsApp mantém o histórico de mensagens sincronizado entre os dois aplicativos.
  • Vazão. “business phone numbers that are in use with both the WhatsApp Business app and Cloud API have a fixed throughput of 20 mps”: números em uso nos dois têm vazão fixa de 20 mensagens por segundo.
  • Cobrança. “messages sent by the business via the WhatsApp Business app will continue to be free, but messages sent via Cloud API will be subject to Cloud API pricing”: o que sai pelo app segue gratuito e o que sai pela Cloud API entra na tarifa da Cloud API.
  • Saída. “clients can use the WhatsApp Business app to disconnect from Cloud API by navigating to the Settings > Account > Business Platform and clicking the Disconnect Account button”: a desconexão é feita no próprio app, no caminho Configurações > Conta > Plataforma de negócios.

A quem o app se destina, pela página oficial do produto: “O app WhatsApp Business foi criado especialmente para os proprietários de pequenas empresas” (app WhatsApp Business, verificado em 18/09/2026).

Coexistence não transforma o app em central de atendimento. Ela evita que a empresa troque de número para começar a usar a API, e é por isso que a pergunta binária nem sempre é a certa.

Tabela de decisão: cada linha com a fonte e a data

Cada linha traz o que a página oficial publica e o endereço dela. Critério sem fonte oficial está na seção seguinte.

Critério de decisão O que a documentação oficial publica Fonte (verificado em 18/09/2026)
Quem abre a conversa o QR code documentado serve para o cliente iniciar a conversa (“begin a chat thread”); a janela de atendimento de 24 horas abre com a mensagem do cliente QR codes e preços
O que é cobrado cobrança por mensagem desde 1º de julho de 2025; modelos de marketing cobrados; mensagens fora de modelo gratuitas; modelo de utilidade dentro da janela aberta gratuito preços
O que a plataforma exige carteira de negócios, conta do WhatsApp Business conectada ao aplicativo e número adicionado na configuração da API primeiros passos da Cloud API
O que o contrato proíbe mensagens em massa e automáticas, engenharia reversa, acesso não autorizado e criação de contas por meio automatizado Termos de Serviço
Usar app e API no mesmo número documentado, com histórico sincronizado, vazão fixa de 20 mensagens por segundo, cobrança separada e desconexão pelo próprio app onboarding de usuários do app
Quantos QR codes por número no máximo 2.000 códigos e links curtos por número QR codes

O que ainda não tem resposta em página oficial

Três pontos ficaram sem confirmação nas consultas de 18/09/2026, e este guia não preenche nenhum deles.

As páginas da Central de Ajuda do WhatsApp sobre dispositivos conectados não devolveram o corpo do texto nas duas tentativas do dia, só o título. Sem o texto, o artigo não afirma quantos dispositivos podem ficar conectados ao mesmo número nem em quanto tempo o aparelho principal precisa se reconectar.

Nenhuma página da Meta consultada descreve o que acontece com um número conectado por ferramenta não autorizada. O que existe é a proibição contratual citada acima, sem descrição de consequência.

O preço final cobrado da empresa também não está publicado pela Meta. O que o fornecedor cobra por licença, por número ou por usuário é contrato dele, e precisa ser pedido por escrito antes da assinatura.

Onde isso encosta no seu CRM

Escolher o caminho é uma decisão; ligar o número à ferramenta que a equipe usa todo dia é outra.

Quem usa ou avalia o Bitrix24 encontra o que a plataforma documenta, o que chega ao cartão do cliente em cada rota e quem cobra o quê nos caminhos documentados para levar o WhatsApp ao CRM.

Se a dúvida ainda é anterior, o mapa de rotas citado acima organiza a escolha antes do fornecedor.

Perguntas frequentes

Qual é a API oficial do WhatsApp?

É a Plataforma do WhatsApp Business, nome que a Meta usa no título da própria página do produto e apresenta como plataforma de mensagens comerciais por API. Para funcionar, ela exige uma carteira de negócios, uma conta do WhatsApp Business conectada ao aplicativo e um número adicionado na configuração da API, conforme a documentação oficial lida em 18/09/2026.

Quanto custa usar a API oficial do WhatsApp?

A Meta cobra por mensagem desde 1º de julho de 2025. Todo modelo de marketing é cobrado, mensagens fora de modelo são gratuitas e o modelo de utilidade entregue dentro da janela de atendimento aberta pelo cliente também é gratuito. O preço final depende ainda do fornecedor que intermedeia a conexão, e esse valor não está nas páginas da Meta.

Qual a melhor API oficial do WhatsApp?

A pergunta não admite ranking, porque existe uma plataforma oficial: a Plataforma do WhatsApp Business. O que varia é o fornecedor que intermedeia a conexão e a ferramenta onde o atendimento acontece. Este artigo não recomenda fornecedor: o critério útil é comparar o que cada um entrega no seu sistema.

Próximo passo

Antes de trocar de caminho, três respostas precisam estar prontas: quem abre a conversa no seu processo, o que a operação envia fora da janela de 24 horas e onde o time vai ler e responder as mensagens.

Com elas na mão, o passo seguinte é olhar a ferramenta que recebe as conversas. Quem trabalha com o CRM do Bitrix24 segue para o guia do WhatsApp dentro do CRM; quem prefere discutir o desenho antes de contratar pode falar com a Tiqtech sobre o canal de atendimento.

Voltar ao blog