A Matec utiliza a API oficial da Meta para integrar o WhatsApp aos atendimentos. Para ajudar nossos clientes a decidir pelo melhor modelo, este artigo explica as diferenças entre o WhatsApp Business App (aquele do QR Code, instalado no celular) e a API Oficial (Cloud API), detalha como funciona a janela de 24 h, explica os tipos de mensagens e templates, mostra exemplos com variáveis, traz links oficiais e destaca as vantagens de utilizar a API. Ao final, mostramos como integrar a API pelo matec chat e os cuidados para evitar problemas.
Observação sobre preços:
-
Desde 1 de julho de 2025 a Meta adota tarifação por mensagem, cobrando apenas quando um template de marketing, utilitário ou autenticação é entregue . Mensagens não‑template (texto, imagem, vídeo, etc.) enviadas dentro de uma janela de atendimento continuam sem custo .
-
Antes dessa data vigorava a cobrança por conversação de 24 horas e havia uma franquia de 1 000 conversas de serviço grátis por mês , além de conversas iniciadas por anúncios ou botões do Facebook que abriam uma janela gratuita de 72 h . A partir de 1 nov 2024 as conversas de serviço tornaram‑se gratuitas, e em 1 jul 2025 o modelo mudou para cobrança por mensagem .
-
As tarifas variam por país e categoria de mensagem (marketing, utilitária ou autenticação). Para consultar o valor por mensagem no Brasil ou em outros mercados, use a calculadora oficial no site da Meta .
1. Diferenças entre o WhatsApp Business App (QRCode) e a API Oficial
-
WhatsApp Business (QRCode)
-
API Oficial (Cloud API)
Dependência de aparelho
-
WhatsApp Business (QRCode)
-
Necessário um smartphone com acesso à internet ligado o tempo todo; se a bateria acabar ou o aplicativo fechar, as mensagens podem atrasar ou não chegar .
-
https://faq.whatsapp.com/3398056720476987 << Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."?
-
-
API Oficial (Cloud API)
- Roda em servidores da Meta e do provedor (Matec). Não depende de smartphone; a conexão é direta e confiável.
Número de usuários
-
WhatsApp Business (QRCode)
- O aplicativo só permite um telefone principal e até quatro dispositivos INDIVIDUAIS conectados; uso por vários atendentes simultâneos pode gerar inconsistências.
-
API Oficial (Cloud API)
- Permite acesso por múltiplos atendentes via sistemas como o matec chat; escalável.
Registro de erros
-
WhatsApp Business (QRCode)
- O WhatsApp Business comum não sinaliza se a mensagem falhar, então não informa o motivo; não há forma de identificar erros de entrega.
-
API Oficial (Cloud API)
- A API envia webhooks com status de envio, leitura e códigos de erro; é possível auditar e tratar falhas rapidamente, e ter conhecimento que a mensagem não chegou.
Confiabilidade
-
WhatsApp Business (QRCode)
-
Sujeita a falhas de conexão do aparelho, dificuldade para atualizar a chave de criptografia de ponta a ponta e mensagens “Aguardando esta mensagem” ou até mesmo não enviar ou receber mensagens .
-
https://faq.whatsapp.com/3398056720476987 << Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."?
-
-
API Oficial (Cloud API)
- As mensagens transitam diretamente pelos servidores do WhatsApp; as chaves de criptografia são gerenciadas pela API, reduzindo quase a 0 falhas de entrega.
Automação e integração
-
WhatsApp Business (QRCode)
-
Suporta respostas rápidas e etiquetas, mas não permite automações avançadas e fluxos de com botões interativos e IA generativa (IA Generativa pode causar banimento conforme documentação).
-
https://business.whatsapp.com/products/platform-pricing#:~:text=,publish our rates for transparency
-
-
API Oficial (Cloud API)
- Permite automatizar fluxos com botões interativos, IA generativa e sistemas de atendimento omnichannel (matec chat).
Escalabilidade e métricas
-
WhatsApp Business (QRCode)
- Limitado ao uso manual; não há métricas detalhadas de mensagens, qualidade ou limites.
-
API Oficial (Cloud API)
- Oferece webhooks, métricas de qualidade, análise de envios e limites por hora.
Risco de banimento
-
WhatsApp Business (QRCode)
-
Maior risco, pois a Meta proíbe uso de robôs não oficiais, múltiplos usuários no mesmo aparelho e envio em massa; denúncias e bloqueios podem banir o número sem aviso .
-
https://faq.whatsapp.com/5957850900902049 <<< Detalhes dos termos de uso do WhatsApp.
-
-
API Oficial (Cloud API)
- Menor risco; o uso é auditado e há métricas de qualidade. Ainda assim, é necessário seguir as políticas de uso, obter opt‑in e evitar spam.
Uso indicado
-
WhatsApp Business (QRCode)
- Individual (pessoa física que utiliza o celular de maneira corporativa) ou testes; não recomendado para operações de atendimento com vários agentes.
-
API Oficial (Cloud API)
- Empresas que precisam de atendimento profissional, automação e estabilidade.
2. Janela de atendimento (24 h)
Quando um usuário envia uma mensagem para a empresa, abre‑se uma janela de atendimento de 24 horas. Enquanto essa janela estiver aberta, a empresa pode responder com qualquer tipo de mensagem, inclusive texto, imagens, listas e botões . Cada nova mensagem do cliente reinicia a contagem da janela . Se a empresa não responder dentro de 24 h ou a janela fechar, ela só poderá enviar mensagens usando templates aprovados .
3. Categorias de mensagens e modelos (templates)
A API oficial classifica as mensagens em quatro categorias, que determinam quando você pode enviá‑las e se há cobrança:
-
Utility (Utilidade) – notificações transacionais (confirmação de pedido, atualizações de entrega). Podem ser enviadas a qualquer momento por meio de templates aprovados. Quando enviadas dentro da janela de 24 h não há custo ; fora da janela há cobrança por mensagem.
-
Marketing – promoções e anúncios. Sempre precisam de template aprovado e são cobradas por mensagem.
Os templates devem ser categorizados como MARKETING ou UTILITY . Eles são compostos por componentes (cabeçalho, corpo, rodapé e botões) e podem usar variáveis (placeholders {{1}}, {{2}}, etc.) para personalizar o conteúdo .
A seguir um exemplo de template de marketing com variáveis:
"category": "MARKETING"
"text": "Compre agora até {{1}} e use o código {{2}} para obter {{3}} de desconto em todos os produtos.",
Os parâmetros podem ser posicionais ({{1}}, {{2}}, etc.) ou nomeados (ex.: {{order_code}}) . No matec chat os campos variáveis podem ser preenchidos manualmente ao enviar a mensagem.
4. Preços e cobrança
-
Cobrança por mensagem: desde 1 de julho de 2025, a cobrança ocorre somente quando um template de marketing ou utilidade é entregue . Respostas utilitárias dentro da janela de 24 h não são cobradas .
-
Tarifas por país e categoria: as tarifas variam conforme o país e a categoria da mensagem. Você pode consultar os valores atualizados no rate card oficial .
-
Mensagens iniciadas pelo cliente: quando o cliente envia a primeira mensagem, abre‑se a janela de 24 h. As respostas da empresa dentro dessa janela são gratuitas e não consomem templates .
5. Vantagens da API Oficial
-
Estabilidade e independência de telefone: Como explicado na seção de diferenças, a API funciona diretamente nos servidores da Meta, eliminando a necessidade de um celular ligado o tempo todo e evitando erros de sincronização (“Aguardando esta mensagem” ou falhas por falta de conexão) .
-
Escalabilidade e multi‑usuário: É possível ter vários atendentes trabalhando simultaneamente no matec chat, com registro completo de conversas, controle de permissões e métricas de desempenho SEM RISCOS.
-
Envio de notificações (templates): Você pode programar envios automáticos de confirmação de pedidos, lembretes e códigos de verificação, com personalização por variáveis SEM RISCOS.
-
Webhooks e relatórios: A API fornece webhooks de entrega, leitura e erros, permitindo integrar com sistemas internos e monitorar cada mensagem enviada. No aplicativo do QR Code isso não é possível.
-
Menor risco de banimento: Usar a API de forma adequada (com opt‑in, conteúdo relevante e limitação de volume) reduz o a quase 0 risco de bloqueio. O WhatsApp proíbe automação não autorizada ou envio em massa de mensagens ; pela API você segue as políticas oficiais e tem métricas de qualidade.
-
Comodidade para o cliente: Com a API, o contato aparece como conta comercial verificada; é possível exibir nome e logo, aumentando a credibilidade.
6. Políticas e termos de utilização
Para utilizar o WhatsApp Business Platform você deve seguir a Política de Mensagens e os Termos de Serviço . Entre os pontos principais:
-
Opt‑in: só é permitido enviar mensagens para quem forneceu o número e consentiu em receber mensagens . Mantenha registro do consentimento e ofereça opção de cancelamento (opt‑out).
-
Uso de templates: fora da janela de 24 h, as mensagens devem utilizar um template aprovado . O WhatsApp pode revisar, pausar ou rejeitar templates .
-
Automação e escalonamento: durante a janela de atendimento, você pode usar automação, mas deve disponibilizar formas claras de escalar para um atendente humano .
-
Proibição de spam e fraude: não é permitido confundir ou enganar pessoas, nem enviar mensagens em massa não solicitadas . O uso de bots não oficiais ou multi‑usuário no aplicativo comum pode resultar em banimento do número .
-
Conteúdo permitido: não utilize mensagens para venda de produtos proibidos (tabaco, armas, drogas), conteúdos ilícitos ou que violem leis locais. Consulte a política de comércio e os guias de mensageria para mais detalhes .
7. Erros comuns e como evitá‑los
7.1 Mensagens “Aguardando esta mensagem” (aplicativo normal)
O aviso “Aguardando esta mensagem. Isto pode levar um tempo” aparece quando a chave de criptografia de ponta a ponta não pôde ser atualizada. Isso geralmente acontece porque a mensagem falhou ou o remetente reinstalou o WhatsApp, não está usando a versão mais recente ou trocou de dispositivo . Para resolver:
-
Peça ao remetente para abrir o WhatsApp e certifiquem‑se de que ambos estão online .
-
Verifique a conexão de internet (troque entre Wi‑Fi e dados móveis) .
-
Atualize o WhatsApp para a versão mais recente .
-
Solicite ao remetente que reenvie a mensagem ou acesse o WhatsApp no dispositivo principal .
-
Caso utilize o aplicativo comum com QR Code, mantenha o celular principal ligado e conectado; se o aparelho ficar offline por muito tempo, as mensagens podem atrasar ou não chegar.
7.2 Falhas no envio/recebimento (aplicativo normal)
No WhatsApp Business App, problemas de conexão, bateria, falta de espaço ou erros de atualização podem impedir o envio ou recepção de mensagens. Muitas vezes o aplicativo indica que a mensagem foi enviada, mas não há como capturar o erro. Para reduzir essas falhas:
-
Use um aparelho confiável: escolha um smartphone com boa performance e mantenha‑o carregado e conectado à internet.
-
Evite multiusuário: não compartilhe o QR Code com vários atendentes simultaneamente. O WhatsApp pode interpretar isso como uso não autorizado e banir o número .
-
Considere migrar para a API: na API oficial, as mensagens são gerenciadas por servidores e erros são reportados via webhooks; não há dependência do aparelho.
7.3 Banimento por uso indevido
O WhatsApp proíbe o uso de automação ou envio em massa sem consentimento . Isso inclui scripts de terceiros para disparo de mensagens, bots não certificados e compartilhar o mesmo número com vários atendentes no aplicativo comum. Para evitar banimentos:
-
Utilize apenas a API oficial.
-
Segmente e personalize as mensagens; evite conteúdo genérico para grandes listas.
-
Respeite a frequência de envios e os pedidos de opt‑out.
-
Acompanhe a qualidade do número e as métricas de mensagens no WhatsApp Manager ou através do provedor (Apenas na API Oficial).
8. Como se cadastrar na API Oficial
Para usar a API (Cloud API) é necessário ter um Business Manager verificado e seguir alguns passos. A Meta oferece um fluxo de Embedded Signup que facilita o processo, principalmente quando integrado ao matec chat. O resumo dos passos:
Você pode conceder acesso a equipe da matec para realizar este processo, consulte o guia no link:
https://chat.matec.ai/hc/matec-chat-duvidas/articles/1755821300-conceder-acesso-a-meta-para-matec
Importante: uma vez conectado à API, o número deixa de funcionar no aplicativo comum. Todas as mensagens passarão a trafegar via API e pelo matec chat. Para reverter, seria necessário remover o número da API e reativá‑lo no WhatsApp Business App (processo sujeito a bloqueio temporário).
9. Utilizando o WhatsApp no matec chat
Depois de concluir o cadastro da API, todas as interações são feitas dentro do matec chat. No painel de atendimento você poderá:
-
Receber mensagens de clientes e respondê‑las usando texto, imagens, áudios e botões. As mensagens de serviço dentro da janela de 24 h não geram custos.
-
Enviar templates aprovados, preenchendo as variáveis; o matec chat permite selecionar o template e inserir valores. Quando o template é entregue, a cobrança ocorrerá conforme a categoria.
-
Criar automações e chatbots para responder perguntas frequentes ou encaminhar para atendentes humanos.
-
Consultar métricas de atendimento, como tempo de resposta, volume de mensagens e qualidade do número. Para acompanhar a qualidade do número e limites de envio, acesse também o WhatsApp Manager no Business Manager.
10. Considerações finais
A API Oficial do WhatsApp Business oferece uma solução escalável, confiável e adequada para operações de atendimento profissional. Ela permite integrar sistemas, automatizar fluxos e garantir conformidade com as políticas do WhatsApp, além de fornecer relatórios detalhados e reduzir o risco de banimento. Apesar de envolver custos por mensagem (especialmente em templates de marketing e autenticação), as vantagens em estabilidade, automação e imagem profissional compensam.
O WhatsApp Business App (QRCode) continua útil para celulares corporativos individuais ou testes, mas apresenta limitações importantes: depende de um único aparelho conectado, não oferece relatórios, possui maior risco de banimento e não permite escalonamento. Para empresas que valorizam eficiência e qualidade no atendimento, a migração para a API oficial é altamente recomendada.