☁️ Canais

WhatsApp Cloud API: o que é, como funciona e quanto custa

O WhatsApp Business Cloud API é a forma oficial da Meta para integrar o WhatsApp com plataformas de atendimento como o Chatys. É a mesma infraestrutura usada por grandes empresas como iFood, Nubank e Magazine Luiza para atender milhões de clientes via WhatsApp — com compliance total, sem risco de banimento e com suporte oficial da Meta.

Neste artigo você vai entender o que é a Cloud API, por que ela é a única opção segura para uso corporativo, como funciona a cobrança por tipo de conversa, e o que é o Quality Rating que define os limites do seu número.

Menu de canais no Chatys

Menu "Canais" no Chatys — gerencie todos os seus números WhatsApp e outros canais conectados via API oficial

O Chatys usa exclusivamente a WhatsApp Cloud API oficial. Nenhum dos seus dados trafega por servidores de terceiros não autorizados pela Meta. Toda a comunicação é diretamente entre o Chatys e os servidores da Meta, garantindo segurança, conformidade com a LGPD e máxima estabilidade.

O que é a WhatsApp Cloud API

A WhatsApp Cloud API (anteriormente chamada de WhatsApp Business API ou WABA) é uma interface de programação disponibilizada pela Meta que permite que empresas enviem e recebam mensagens no WhatsApp de forma automatizada, em escala e com recursos avançados como templates, botões interativos, listas, catálogos e muito mais.

Diferente do WhatsApp Business app (o aplicativo instalado no celular), a Cloud API:

  • Não precisa de um celular ligado — roda nos servidores da Meta
  • Suporta múltiplos agentes simultâneos atendendo pelo mesmo número
  • Escala para milhares de conversas simultâneas sem degradação
  • Permite integração com CRMs, ERPs, plataformas de atendimento e automações
  • Oferece acesso a todos os recursos avançados: templates HSM, botões, listas, catálogos
  • Tem SLA de 99,9% de uptime garantido pela Meta

API oficial vs não oficial: diferenças críticas

Muitas ferramentas no mercado usam automação não oficial do WhatsApp (via reverse-engineering do WhatsApp Web), violando os Termos de Serviço da Meta. Entenda as diferenças críticas:

Característica Cloud API (Chatys) API não oficial
Risco de banimento permanente Nenhum Alto (imediato)
Templates HSM para broadcast Suportado Não suportado
Botões e mensagens interativas Nativo Workaround instável
Volume de mensagens/dia Até 100.000+ Muito limitado
Suporte oficial da Meta Sim, com SLA Nenhum
Conformidade com LGPD / GDPR Total Duvidosa
Risco real: O WhatsApp detecta automaticamente o uso de APIs não oficiais e bane números permanentemente — sem aviso prévio e sem possibilidade de recurso na maioria dos casos. Se você usa atualmente uma ferramenta não oficial, migre para a Cloud API o mais rápido possível antes de perder seu número comercial.

Tipos de conversa e cobrança da Meta

A Cloud API cobra por conversas, não por mensagens individuais. Uma conversa é uma janela de 24 horas durante a qual você e o cliente podem trocar quantas mensagens quiserem. Existem 4 tipos de conversa com custos diferentes:

Marketing — Você inicia para promover produtos, ofertas ou conteúdo

Custo aproximado em BRL (2025): ~R$0,35 a R$0,45 por conversa de 24h. Requer template HSM aprovado pela Meta.

Utility (Transacional) — Atualizações relacionadas a uma transação existente (confirmação de pedido, notificação de entrega, lembrete de cobrança)

Custo aproximado: ~R$0,06 a R$0,10 por conversa. Também requer template HSM.

Authentication (Autenticação) — OTP (senhas de uso único) e verificação de identidade

Custo aproximado: ~R$0,04 a R$0,06 por conversa. Tarifa mais baixa por ser de alto valor para segurança.

Service (Atendimento) — Cliente iniciou a conversa dentro da janela de 24h

Custo aproximado: ~R$0,02 a R$0,04 por conversa. A tarifa mais baixa — o cliente que iniciou já demonstrou interesse.

Dica de custo: O tipo "Service" é o mais barato e representa a maioria das conversas de atendimento ao cliente. Configure o Agente IA para responder dentro da janela de 24h (ideal: resposta em segundos), pois assim a conversa permanece classificada como Service em vez de evoluir para Marketing quando você precisar reengajar o cliente.

Quality Rating do número

A Meta monitora continuamente a qualidade do seu número com base nos feedbacks dos destinatários. O Quality Rating (Nível de Qualidade) tem impacto direto nos limites de envio e pode resultar em suspensão do número se cair muito.

Verde (Alto) — Excelente. Taxa de bloqueio abaixo de 1%. Sem restrições, acesso a todos os recursos e limites máximos.
Amarelo (Médio) — Atenção. Taxa de bloqueio entre 1% e 2%. Limites de envio podem ser reduzidos temporariamente. Revise a qualidade dos seus broadcasts.
Vermelho (Baixo) — Crítico. Taxa de bloqueio acima de 2%. O número pode ser suspenso ou ter limite reduzido a 250 conversas/dia. Ação imediata necessária.

Fatores que afetam negativamente o Quality Rating:

  • Clientes bloqueando seu número ou marcando como spam
  • Templates com linguagem enganosa ou muito agressiva de vendas rejeitados pelos destinatários
  • Envio de mensagens para números que não optaram por receber (compra de lista)
  • Alta frequência de envio sem valor real para o destinatário
  • Mensagens enviadas em horários inadequados (madrugada, feriados)
Central de Canais no Chatys — status do Quality Rating

Central de Canais — acompanhe o Quality Rating e os limites de envio de cada número conectado diretamente no Chatys

Limites de mensagens por nível

Todo número começa no Nível 1 quando é adicionado à Cloud API. Os limites aumentam progressivamente conforme o histórico de qualidade e uso:

1
Nível 1 (inicial): até 1.000 conversas únicas por dia. Para avançar: mantenha Quality Rating verde por 7 a 14 dias consecutivos com uso regular. O upgrade é automático.
2
Nível 2: até 10.000 conversas únicas por dia. Mesmo critério: qualidade verde + histórico de uso consistente por mais 7 a 14 dias.
3
Nível 3: até 100.000 conversas únicas por dia. Para chegar aqui: histórico longo de qualidade verde, verificação da conta Business no Meta e solicitação formal.
4
Nível 4 (ilimitado): sem limite de conversas por dia. Exige aprovação especial da Meta e é reservado para grandes corporações com volumes muito altos e histórico impecável.
Atenção ao iniciar broadcasts: Se você está no Nível 1 e tenta enviar um broadcast para 5.000 contatos, apenas as primeiras 1.000 mensagens serão entregues no dia. O restante é descartado ou gera erro. Planeje seus envios respeitando o nível atual do seu número e evolua gradualmente antes de grandes campanhas.

Templates HSM: o que são e para que servem

Templates HSM (Highly Structured Message) são mensagens pré-aprovadas pela Meta que você precisa usar para iniciar conversas com clientes que não entraram em contato nos últimos 24 horas. São obrigatórios para qualquer mensagem outbound (iniciada pela empresa).

Por que os templates existem:

  • A Meta quer garantir que as empresas não enviem spam para os usuários
  • Ao aprovar o template, a Meta verifica se a mensagem tem valor real e não é enganosa
  • Sem templates aprovados, você só pode responder a clientes que te enviaram mensagem primeiro (e dentro da janela de 24h)

Tipos de templates suportados no Chatys:

  • Texto simples: Mensagem de texto com variáveis dinâmicas ({{nome}}, {{numero_pedido}}, etc.)
  • Template com botões: Texto + até 3 botões (Resposta Rápida ou Link/Ligação)
  • Template com mídia: Imagem, vídeo ou documento + texto
  • Template de localização: Endereço com mapa integrado

Para criar e usar templates, consulte o artigo Templates HSM — criar, enviar e gerenciar.

Casos de uso — como aplicar no seu negócio

Veja como empresas de diferentes segmentos utilizam esta funcionalidade na prática:

🛍️ E-commerce e lojas online

Uma empresa que usava bot de WhatsApp Web para broadcasts teve o número banido permanentemente numa sexta-feira de Black Friday — perdeu 50.000 contatos em 1 dia. Após migrar para a API oficial, nunca mais teve problemas e enviou 200.000 mensagens na Black Friday seguinte com 98% de taxa de entrega.

🏥 Clínicas e profissionais de saúde

A API oficial tem compliance nativo com LGPD e GDPR: dados trafegam pelos servidores seguros da Meta com criptografia end-to-end. Para clínicas com dados sensíveis de pacientes, é a única opção legalmente segura — qualquer outra solução expõe a empresa a riscos regulatórios graves.

🏠 Imobiliárias e construtoras

Uma imobiliária envia plantão de novos lançamentos para lista de 10.000 clientes interessados com taxa de entrega de 97%. O custo de R$ 0,08 por conversa de Utility representa R$ 800 para impactar 10.000 leads qualificados — ROI altíssimo comparado com anúncios pagos para a mesma audiência.

🍕 Restaurantes e food service

Startups em crescimento começam no Nível 1 da API (1.000 conversas/dia), suficiente para o início. Conforme o volume cresce, a Meta sobe automaticamente o limite de capacidade com base no histórico de uso limpo — sem necessidade de ação manual ou contratação de plano superior.

💼 Serviços, consultoria e SaaS

Redes de franquias exigem que cada unidade tenha seu próprio número verificado na API oficial. A marca mãe garante que todas as unidades usem a API correta, evitando que uma franquia cause dano à reputação da marca inteira com práticas de spam ou banimento de número.

Melhores práticas:
  • Mantenha o Quality Rating sempre verde: nunca compre listas de contatos e envie apenas para quem explicitamente optou por receber suas mensagens (opt-in confirmado).
  • Monitore a taxa de bloqueio no painel Meta — acima de 0,5% é sinal de alerta vermelho que pode comprometer o Quality Rating e limitar o volume de envios.
  • Nunca use templates genéricos: mensagens personalizadas com nome e contexto do cliente aumentam a taxa de leitura em até 3 vezes.

Problemas comuns

  • Número banido pela Meta — como proceder: Acesse developers.facebook.com, vá no seu app WhatsApp e verifique o status do número. Se aparece "Suspended" ou "Banned", registre um recurso através do suporte da Meta (business.facebook.com/help). O processo pode levar de 3 a 15 dias úteis. Enquanto espera, não tente usar o número em nenhuma outra ferramenta. Se o banimento for definitivo, você precisará de um novo número. Contate o suporte do Chatys para auxiliar no processo.
  • Quality Rating caindo mesmo com envios legítimos: Verifique se você está enviando mensagens para contatos que realmente optaram por receber (opt-in confirmado). Analise o conteúdo dos templates — mensagens muito promocionais têm maior chance de serem bloqueadas. Reduza a frequência de broadcasts temporariamente. Adicione sempre um link de opt-out claro nas mensagens de marketing. Em 7 a 14 dias de pausa nos broadcasts, o Quality Rating tende a recuperar.
  • Limite de envio atingido antes do esperado: O limite é de conversas únicas, não de mensagens. Se você enviar 5 mensagens para a mesma pessoa na mesma janela de 24h, conta como 1 conversa. Mas se você abrir 1.000 conversas com 1.000 clientes diferentes, atingiu o limite do Nível 1. Acompanhe o uso diário na Central de Canais do Chatys para planejar melhor.
  • Template rejeitado pela Meta — motivos comuns: Linguagem muito promocional sem contexto claro ("Oferta imperdível! Compre agora!"), uso de variáveis sem contexto suficiente ({{1}} sem deixar claro o que é), links externos suspeitos ou encurtados, e ausência de identificação clara da empresa. Reescreva o template com linguagem mais clara e objetiva, identificando a empresa no início da mensagem e fornecendo contexto sobre por que o cliente está recebendo aquela mensagem.

Este artigo foi útil?