Escolha a API oficial quando o requisito central for operar no canal oficial e aceitar seus processos, modelos e cobranças. Escolha QR Code quando a prioridade for integrar rapidamente um número como dispositivo vinculado e sua empresa aceitar conscientemente os riscos desse modelo.
O que é a API oficial do WhatsApp?
É a infraestrutura oferecida pela Meta para empresas integrarem o WhatsApp aos próprios sistemas. A Cloud API é hospedada pela Meta; a empresa configura conta, ativos, número, permissões e fluxos conforme as regras vigentes da plataforma.
Em conversas iniciadas pela empresa, modelos de mensagem e categorias podem ser aplicáveis de acordo com a política atual. Custos e regras mudam ao longo do tempo, por isso uma projeção financeira deve usar a documentação oficial vigente, o país e o tipo de conversa da operação.
Quando esse caminho costuma fazer sentido
- Política interna exige integração oficial.
- A organização aceita o processo de configuração e revisão da Meta.
- Templates e regras oficiais cabem no fluxo comercial.
- A escala e a governança justificam o desenho mais formal.
- O time consegue acompanhar alterações de política e cobrança.
O que é uma conexão por QR Code?
É uma integração independente que conecta o número como um dispositivo vinculado. O usuário lê um QR Code e a infraestrutura mantém a sessão, transforma operações em API e recebe eventos do canal.
A Relya usa esse modelo. Ela não é a API oficial da Meta, não é afiliada ao WhatsApp e não deve ser apresentada como oficial. A vantagem prática é ativar um número existente de forma direta. A contrapartida é assumir risco de sessão, mudanças técnicas e eventuais restrições decididas pelo WhatsApp.
Quando esse caminho pode fazer sentido
- É necessário testar ou integrar com velocidade.
- O número já existe e a operação quer vinculá-lo.
- O time precisa de painel e API sem manter a própria pilha.
- O volume é controlado e os contatos esperam as mensagens.
- A empresa aceita um fornecedor independente e tem plano de contingência.
Não existe técnica capaz de garantir “zero bloqueio”. O WhatsApp decide sobre contas e sessões. Cadência, origem dos contatos e resposta dos destinatários importam, mas não anulam esse risco.
Comparação lado a lado
| Questão | API oficial | QR Code independente |
|---|---|---|
| É oficial? | Sim, quando contratada/configurada no ecossistema oficial. | Não. É uma integração de dispositivo vinculado. |
| Ativação | Exige configuração empresarial e técnica conforme o processo vigente. | Normalmente começa com leitura de QR Code. |
| Número existente | Depende das opções e regras de migração/coexistência vigentes. | O próprio número é vinculado à sessão. |
| Mensagens iniciadas pela empresa | Sujeitas às regras e modelos oficiais aplicáveis. | Operação semelhante ao dispositivo conectado, ainda sujeita a termos e políticas. |
| Preço | Pode incluir cobrança da Meta e do provedor. | Geralmente mensalidade da infraestrutura por número. |
| Estabilidade de contrato | API documentada oficialmente. | Depende da adaptação do fornecedor às mudanças do canal. |
| Risco de desconexão | Não depende de sessão por QR. | Sessão pode desconectar e exigir reconexão. |
| Compliance | Costuma ser a escolha exigida por organizações mais reguladas. | Precisa de avaliação jurídica, de segurança e de risco própria. |
Uma regra simples para escolher
- Liste os requisitos que não podem mudar. Oficialidade, prazo, número existente, templates, volume, custo e compliance.
- Separe “quero” de “preciso”. Ativação rápida pode ser desejo; integração oficial pode ser requisito contratual.
- Simule uma falha. Se a sessão QR desconectar, o que acontece com a fila e com o atendimento?
- Calcule o custo total. Inclua mensalidade, mensagens, desenvolvimento, plantão e impacto de indisponibilidade.
- Faça um piloto reversível. Um número, um fluxo, métricas claras e plano de saída.
Para pequenas integrações e validação de produto, QR Code pode reduzir a barreira inicial. Para operações cujo contrato exige canal oficial, não tente “compensar” com boas práticas: escolha a API oficial.
É possível começar em um modelo e migrar?
Sim, desde que seu sistema não fique amarrado ao formato de um único fornecedor. Crie uma camada interna com operações como enviarTexto, enviarMidia e receberStatus. Guarde identificadores do seu negócio separadamente dos identificadores do provedor.
Também normalize estados. Um provedor pode chamar um evento de delivered; outro, de DELIVERY. Seu sistema deve registrar um estado interno e guardar o evento original para auditoria. Isso diminui o custo de migração e permite até usar modelos diferentes em números distintos.
Se a escolha for a Relya, leia o guia completo da API e o guia de custos. A documentação deixa explícito que a conexão é independente.
Fontes e atualização
As condições da API oficial podem mudar. Consulte as fontes da Meta antes da decisão final. A descrição da Relya corresponde ao produto em 14/07/2026.