API oficial do WhatsApp: o que é e por que usar
A API oficial do WhatsApp é a WhatsApp Cloud API, o jeito autorizado pela Meta de ligar um número a sistemas, CRMs e agentes de IA. A FlashConnect é Tech Provider da Meta, com acesso avançado aprovado em 3 de outubro de 2026, e conecta o seu número pelo cadastro oficial da Meta, sem QR code de WhatsApp Web. Pela API, você responde livremente até 24 horas depois da última mensagem do cliente; fora disso, só com template aprovado pela Meta.
Atualizado em
O que é a API oficial do WhatsApp?
A WhatsApp Cloud API é o serviço da própria Meta para empresas mandarem e receberem mensagens no WhatsApp por meio de sistemas. A Meta hospeda tudo: o número fica registrado na plataforma dela, as mensagens recebidas chegam ao seu sistema por webhook (um aviso automático pela internet) e as respostas saem por uma chamada à API.
Na prática, isso permite que uma equipe inteira atenda o mesmo número pelo computador, que um agente de IA responda de madrugada e que o seu CRM saiba quando cada mensagem foi entregue e lida. A Meta cobra por mensagem enviada, por categoria, conforme a tabela oficial de preços da Meta. Veja quanto custa somando tudo em planos e preços da FlashConnect.
O que é um Tech Provider da Meta?
Tech Provider é a empresa de tecnologia autorizada pela Meta a conectar números de outras empresas à API oficial, pelo cadastro incorporado (Embedded Signup): uma janela oficial da Meta em que o dono do número faz login no Facebook e autoriza a conexão, sem passar senha para ninguém. Para isso, a empresa precisa ter o negócio verificado pela Meta e passar pela análise do app (App Review), como descreve o guia da Meta para Tech Providers.
- A FlashConnect é um produto da Castilho IA Tecnologia Ltda, empresa verificada pela Meta.
- O App Review foi aprovado em 3 de outubro de 2026, com acesso avançado às permissões de mensagens e de gestão de contas do WhatsApp.
- A conta do WhatsApp continua no nome da sua empresa. Você paga as mensagens direto à Meta, no seu cartão, e pode desconectar quando quiser.
Qual a diferença entre a API oficial e as soluções por QR code?
Existem ferramentas que conectam o WhatsApp lendo o QR code do WhatsApp Web e automatizando o aplicativo por fora. Elas não são autorizadas pela Meta. Os Termos de Serviço do WhatsApp proíbem acessar o serviço por meios automatizados ou não autorizados.
| API oficial (Cloud API) | Conexão por QR code | |
|---|---|---|
| Como conecta | Cadastro oficial da Meta, com login no Facebook | Leitura do QR code do WhatsApp Web |
| Autorizada pela Meta | Sim | Não |
| Regras de envio | Janela de 24h, templates aprovados e limite diário de novos contatos | Sem regras formais, o que facilita abuso e denúncias |
| Status de entrega e leitura | Enviados pela Meta por webhook | Dependem de automação do aplicativo |
| Custo das mensagens | Cobrado pela Meta, por categoria | Sem cobrança da Meta, mas fora das regras dela |
A API oficial reduz o risco de bloqueio, mas não o elimina: a Meta pode limitar ou bloquear qualquer número que viole as políticas dela, por exemplo com muitas denúncias de spam.
Quer comparar ferramentas lado a lado? Veja os comparativos de soluções de WhatsApp.
O que é a janela de 24 horas do WhatsApp?
É a regra principal da API oficial. Cada vez que o cliente manda uma mensagem, abre-se uma janela de 24 horas em que você responde livremente: texto, foto, áudio, documento, botões. Passadas as 24 horas desde a última mensagem dele, a empresa só pode puxar a conversa com um template aprovado pela Meta.
A FlashConnect confere a janela antes de enviar. Se ela já fechou, o envio é barrado com o aviso JANELA_EXPIRADA, sem gastar uma chamada na Meta, e o painel sugere usar um template. Em coexistência, as mensagens que você manda pelo app do celular não passam pela API e não seguem essa regra.
O que são templates do WhatsApp?
Template é um modelo de mensagem que a Meta analisa antes de você poder usar. Ele pode ter cabeçalho, corpo com variáveis (como o nome do cliente), rodapé e botões. Cada template tem uma categoria:
- Marketing: promoções, novidades, convites.
- Utilidade: confirmação de pedido, lembrete de consulta, aviso de entrega.
- Autenticação: códigos de verificação.
A Meta pode mudar a categoria que você escolheu, e o preço segue a categoria final. Na FlashConnect você cria templates pelo painel, pela API ou pedindo à sua IA, e acompanha o status (em análise, aprovado, reprovado com o motivo, pausado). Detalhes em como criar templates na FlashConnect.
O que é o messaging limit?
É o número máximo de contatos diferentes com quem o seu número pode iniciar conversa em 24 horas. Responder quem falou com você não conta. O limite sobe em degraus (250, 1 mil, 10 mil, 100 mil e ilimitado) conforme o volume e a qualidade dos envios.
A qualidade é medida pela Meta em verde, amarelo ou vermelho, a partir de bloqueios e denúncias. Qualidade vermelha derruba o limite. O painel da FlashConnect mostra a qualidade e o limite de cada número, e contatos que pediram para não receber mensagens são bloqueados no envio de template (aviso OPT_OUT).
Por que a API oficial importa para a sua empresa?
- Menos risco para o número: você segue as regras da Meta em vez de depender de uma brecha.
- Equipe e IA no mesmo número: várias pessoas e agentes de IA atendem pela mesma caixa de entrada.
- Você mantém o celular: com a coexistência, o app WhatsApp Business continua funcionando.
- Dados confiáveis: entrega, leitura e falhas chegam da própria Meta.
- Integração aberta: API REST, webhooks e conexão com o Claude e outras IAs.
Pronto para começar? Veja como conectar o seu número na API oficial.
Perguntas frequentes
A API oficial do WhatsApp é paga?
Sim. A Meta cobra por mensagem enviada, conforme a categoria (marketing, utilidade, autenticação e serviço) e o país do contato, direto no cartão que você cadastra na Meta. A assinatura da FlashConnect é cobrada à parte, por número conectado.
Preciso trocar de número para usar a API oficial?
Não. Com a coexistência, você conecta o número que já usa no app WhatsApp Business e ele continua funcionando no celular.
A API oficial acaba com o risco de banimento?
Não acaba, mas reduz. A conexão é autorizada pela Meta, sem QR code de WhatsApp Web. A Meta ainda pode limitar ou bloquear números que violam as políticas dela, por exemplo com muitas denúncias de spam.
O que acontece se eu tentar responder depois de 24 horas?
Pela API, só é possível enviar um template aprovado pela Meta. A FlashConnect barra o envio de texto livre com o aviso JANELA_EXPIRADA antes de chamar a Meta.
Quanto tempo a Meta leva para aprovar um template?
Depende da Meta. O template entra como em análise e a FlashConnect atualiza o status sozinha quando a Meta aprova, reprova ou pausa, mostrando o motivo da reprovação.
O que significa a FlashConnect ser Tech Provider?
Significa que a Meta verificou a empresa e aprovou o app para conectar números de outras empresas à API oficial pelo cadastro incorporado. A aprovação saiu em 3 de outubro de 2026.
Quer usar a FlashConnect?
O acesso está sendo liberado por convite. Fale com a gente no WhatsApp.
Pedir convite no WhatsApp