Documentação 8 min de leitura

WhatsApp Cloud API Oficial da Meta

Conecte seu WhatsApp à API oficial da Meta diretamente pelo WordChats. Mais estabilidade, recursos exclusivos e a segurança de uma conexão oficial — tudo configurado em poucos cliques.

O que é a Cloud API?

A WhatsApp Cloud API é a forma oficial de conectar seu número de WhatsApp ao WordChats, usando a infraestrutura da própria Meta (empresa dona do WhatsApp, Facebook e Instagram). Diferente da conexão via QR Code, a Cloud API oferece:

Conexão oficial e segura
Maior estabilidade
Sem risco de banimento
Botões interativos nativos
Modo coexistência
Selo verificado (opcional)
WordChats é parceiro oficial de tecnologia Meta

O WordChats é um Tech Partner da Meta, o que significa que a integração é direta, sem intermediários. Você conecta seu WhatsApp com total segurança e suporte.

Cloud API vs. Conexão por QR Code

O WordChats oferece duas formas de conectar seu WhatsApp. Veja a diferença:

Para identificar a campanha, o conjunto ou o anúncio de um lead, consulte o guia de rastreamento de leads no WhatsApp. Esse recurso aproveita as referências recebidas na mensagem. A autorização para consultar anúncios na Meta é separada do login que conecta o WhatsApp Cloud API.

Característica
Cloud API
QR Code
Conexão oficial da Meta
Risco de banimento
Nenhum
Baixo
Estabilidade
Máxima
Boa
Botões interativos
Selo verificado
Celular precisa estar online
Não
Recomendado
Custo adicional
Por mensagem*
Nenhum
Configuração
5 minutos
1 minuto
* Sobre o custo por mensagem

Regras de 1º de outubro de 2026, conferidas em 22/09/2026: cada número comercial terá 1.000 mensagens de serviço gratuitas por mês, sem acumular saldo. Após a franquia, a tarifa no Brasil será R$ 0,035 por mensagem entregue na tabela em BRL. Templates de utilidade também serão cobrados dentro da janela de 24h. A gratuidade de entrega na janela elegível de 72h de anúncios permanece. Consulte as regras e tarifas oficiais da Meta.

Modo Coexistência

O modo coexistência permite usar a Cloud API e a conexão por QR Code ao mesmo tempo, no mesmo número. Isso é ideal para quem quer:

  • Enviar mensagens com botões interativos pela Cloud API
  • Manter a conexão por QR Code para receber e responder mensagens normalmente
  • Transição gradual — teste a Cloud API sem perder a conexão atual
Sem interrupção!

No modo coexistência, seu atendimento continua funcionando normalmente pela conexão QR Code enquanto você aproveita os recursos exclusivos da Cloud API para envios.

Pré-requisitos

Antes de começar, verifique se você tem tudo pronto:

Plano WordChats ativo com Cloud API habilitado
Uma conta no Facebook (pessoal, usada apenas para autenticação)
Um número de telefone que receberá o código de verificação por SMS
Não precisa de conta Meta Business Suite!

Se você ainda não tem uma conta empresarial na Meta, ela será criada automaticamente durante o processo. Basta ter um Facebook pessoal.

Importante sobre o número de telefone

O número precisa ser capaz de receber SMS para verificação. Se o número já estiver conectado ao WhatsApp Business App, será necessário desvinculá-lo antes. Números do WhatsApp pessoal funcionam normalmente.

Passo 1: Adicionar Conexão no WordChats

1

No painel do WordChats, siga este caminho:

Conexões Adicionar WhatsApp Cloud API ou Coexistência

Escolha o tipo de conexão:

  • Cloud API — Conexão 100% oficial. Ideal para quem quer usar apenas a API da Meta.
  • Coexistência — Usa Cloud API + QR Code no mesmo número. Ideal para transição gradual.

Passo 2: Dar um Nome à Conexão

2

Digite um nome para identificar esta conexão (ex: "WhatsApp Comercial", "Suporte Cloud API").

Depois, clique em "Adicionar". A conexão será criada com status "Pendente".

O que é o status "Pendente"?

Significa que a conexão foi criada, mas ainda falta vincular ao seu número de WhatsApp via Meta. O próximo passo é clicar em "Configurar".

Passo 3: Conectar com a Meta

3

Na lista de conexões, clique no botão "Configurar" ao lado da conexão que você criou. A tela de configuração vai abrir:

  1. Clique no botão azul "Conectar com Meta"
  2. Uma janela do Facebook vai abrir para login
  3. Faça login com sua conta do Facebook
  4. Selecione ou crie sua conta empresarial (Business Portfolio)
  5. Selecione ou crie sua conta do WhatsApp Business
  6. Adicione o número de telefone e verifique com o código SMS
  7. Confirme e pronto!
Conectar com Meta
Conta Empresarial
Conectado!
Conexão estabelecida!

Quando o status mudar para "Conectado", seu WhatsApp está integrado via Cloud API. As mensagens já começam a chegar no WordChats.

Pop-up bloqueado?

Se a janela do Facebook não abrir, seu navegador pode estar bloqueando pop-ups. Permita pop-ups para o site do WordChats e tente novamente.

Passo 4: Testar a Conexão!

4

Tudo configurado! Envie uma mensagem para o número conectado e veja a mensagem chegar no WordChats:

Teste de conexão
Olá, gostaria de mais informações!
10:30
Olá! Seja bem-vindo! Como posso ajudar você hoje?
Ver Produtos Falar com Atendente Horário de Funcionamento
10:30
Ver Produtos
10:31
Funcionou!

Perceba os botões interativos na resposta — um recurso exclusivo da Cloud API! O cliente toca no botão para responder, sem precisar digitar.

Quanto Custa?

A Cloud API tem um modelo de custos transparente definido pela Meta. Vamos explicar de forma simples:

Mensagens de Serviço

Franquia em outubro

Até 30/09/2026, respostas de serviço na janela de 24h são gratuitas. Em outubro, cada número terá 1.000 mensagens de serviço gratuitas por mês, sem acumulação; o excedente será cobrado por entrega.

Atualização — conferida na Meta em 22/09/2026

Regras de 1º de outubro de 2026, conferidas em 22/09/2026: cada número comercial terá 1.000 mensagens de serviço gratuitas por mês, sem acumular saldo. Após a franquia, a tarifa no Brasil será R$ 0,035 por mensagem entregue na tabela em BRL. Templates de utilidade também serão cobrados dentro da janela de 24h. A gratuidade de entrega na janela elegível de 72h de anúncios permanece. Consulte as regras e tarifas oficiais da Meta.

Entendendo as categorias e valores (Brasil)

Tabela oficial para o Brasil com vigência em 01/10/2026, conferida em 22/09/2026. Valores em BRL, por mensagem entregue. Confira a moeda e as condições da sua conta Meta.

Serviço

Resposta livre enviada dentro da janela de 24h. Gratuita até setembro. Em outubro: R$ 0,035 por entrega após 1.000 mensagens gratuitas por número/mês, sem desconto por volume.

Utilidade

Templates de utilidade: R$ 0,035 por entrega no Brasil (tarifa base em BRL). A partir de outubro, também são cobrados dentro da janela de 24h. A janela elegível de anúncios é uma exceção.

Marketing

Templates de marketing: R$ 0,3217 por entrega no Brasil (tarifa em BRL). A categoria é determinada pela Meta conforme o conteúdo.

Autenticação

Templates de autenticação: R$ 0,035 por entrega no Brasil (tarifa base em BRL).

Descontos por volume

Utilidade e autenticação têm tarifas por faixa de volume, específicas por mercado e categoria. Serviço não tem desconto por volume. Consulte a tabela oficial para o nível aplicável à sua conta.

Como funciona a cobrança?

Regras de 1º de outubro de 2026, conferidas em 22/09/2026: cada número comercial terá 1.000 mensagens de serviço gratuitas por mês, sem acumular saldo. Após a franquia, a tarifa no Brasil será R$ 0,035 por mensagem entregue na tabela em BRL. Templates de utilidade também serão cobrados dentro da janela de 24h. A gratuidade de entrega na janela elegível de 72h de anúncios permanece. Consulte as regras e tarifas oficiais da Meta.

Exemplo de atendimento em outubro

Exemplo em outubro: 2.000 respostas de serviço entregues por um número, fora da janela gratuita de anúncios, menos 1.000 da franquia = 1.000 × R$ 0,035 = R$ 35,00 de tarifas da Meta. A assinatura do WordChats é separada.

Pagamento e moeda da conta

A tabela em BRL já está disponível para contas elegíveis no Brasil. Antes de outubro, confira a forma de pagamento: após esgotar a franquia, mensagens de serviço não serão entregues sem pagamento válido. Consulte a documentação oficial da Meta.

Recursos Exclusivos da Cloud API

Além de tudo que o WordChats já oferece, a Cloud API desbloqueia recursos adicionais:

Botões Interativos

Envie mensagens com botões de resposta rápida e listas de opções. O cliente toca para responder.

Selo Verificado

Solicite o selo verde de verificação para seu número. Transmite confiança e profissionalismo.

Sem Depender do Celular

A conexão é via servidor da Meta. Não depende do celular estar ligado ou conectado à internet.

Integração oficial sujeita às políticas

A Cloud API é o canal oficial de integração. A conta continua sujeita às políticas, à qualidade e aos limites da Meta; consentimento e respeito às solicitações de saída são necessários.

Perguntas Frequentes

Preciso pagar algo ao WordChats para usar a Cloud API?

A funcionalidade de Cloud API está incluída no seu plano WordChats (verifique se seu plano possui esse recurso). Os custos de mensagem template são cobrados pela Meta diretamente na sua conta Meta Business — o WordChats não cobra taxa adicional.

Posso usar Cloud API e QR Code ao mesmo tempo?

Sim! É exatamente para isso que existe o modo Coexistência. Você mantém a conexão por QR Code para o atendimento do dia a dia e usa a Cloud API para recursos como botões interativos e disparos oficiais.

Meu número vai parar de funcionar no WhatsApp do celular?

Ao usar apenas Cloud API (sem coexistência), o número é migrado para a plataforma Business da Meta. Ele não ficará mais disponível no WhatsApp pessoal do celular, mas continuará funcionando no WordChats. No modo coexistência, o WhatsApp pessoal continua normalmente.

Como funciona a cobrança de mensagens de serviço?

Regras de 1º de outubro de 2026, conferidas em 22/09/2026: cada número comercial terá 1.000 mensagens de serviço gratuitas por mês, sem acumular saldo. Após a franquia, a tarifa no Brasil será R$ 0,035 por mensagem entregue na tabela em BRL. Templates de utilidade também serão cobrados dentro da janela de 24h. A gratuidade de entrega na janela elegível de 72h de anúncios permanece. Consulte as regras e tarifas oficiais da Meta.

A Meta mudou o modelo de cobrança?

Sim. Até junho/2025, a Meta cobrava por conversa (janela de 24 horas). Desde julho/2025, a cobrança passou a ser por mensagem template entregue. Mensagens de serviço (respostas a clientes) ficaram gratuitas até 30/09/2026 e passam a ser cobradas após 1.000 mensagens gratuitas por número/mês a partir de 1º de outubro de 2026. Veja os detalhes.

Preciso de um CNPJ para usar a Cloud API?

Não! Você pode começar com uma conta pessoal no Facebook. A Meta criará automaticamente uma conta empresarial durante o processo de configuração. Para recursos avançados como o selo verificado, pode ser necessário verificar sua empresa posteriormente.

A IA e as automações funcionam com a Cloud API?

Sim, tudo funciona! Agentes de IA, fluxos automatizados, filas, CRM, follow-up, remarketing — todas as funcionalidades do WordChats são compatíveis com a Cloud API.

Posso voltar para a conexão por QR Code depois?

Sim! Você pode desconectar a Cloud API e criar uma nova conexão por QR Code a qualquer momento. O processo é reversível.

Como faço para conseguir o selo verde (verificado)?

O selo verde é concedido pela Meta após verificação da sua empresa. Após conectar via Cloud API, acesse o Meta Business Suite e solicite a verificação empresarial. O processo envolve envio de documentos e pode levar alguns dias.

Precisa de ajuda?

Nossa equipe está pronta para ajudar você a configurar a Cloud API. Entre em contato pelo WhatsApp!