WhatsApp Cloud API: um guia para iniciantes sobre o plano gratuito

A WhatsApp Cloud API parece intimidadora, mas a ideia central é simples: é a forma da Meta, com hospedagem gratuita, de enviar e receber mensagens do WhatsApp a partir do seu próprio software. Este guia explica o que é, o que é genuinamente gratuito e como enviar sua primeira mensagem — sem o jargão.

O que a Cloud API é de fato

A WhatsApp Cloud API faz parte da WhatsApp Business Platform. Em vez de digitar mensagens em um celular, seus sistemas as enviam e recebem de forma programática. A Meta a hospeda na nuvem, então você não roda nenhum servidor de WhatsApp por conta própria — uma grande mudança em relação à antiga API on-premise.

Ela viabiliza o que o app gratuito do WhatsApp Business não consegue fazer:

• Confirmações de pedido, atualizações de entrega e lembretes automatizados.
• Uma caixa de entrada compartilhada onde vários atendentes cuidam das conversas a partir de um único número.
• Chatbots e integrações com CRM/helpdesk.
• Marketing em escala para usuários com opt-in.

Se você só precisa de conversas recebidas a partir de um link, não precisa disto — um link wa.me do nosso gerador de link do WhatsApp gratuito já basta. A Cloud API é para automação e escala.

Hospedagem gratuita vs. envio gratuito — não confunda

Duas coisas "gratuitas" diferentes acabam se misturando:

1. A hospedagem é gratuita. Diferente da antiga API on-premise, a Meta hospeda a Cloud API sem custo. Nenhum servidor para alugar.
2. O envio tem um plano gratuito mais uso pago. O WhatsApp cobra por conversa (uma janela de 24 horas), com algumas conversas gratuitas e outras pagas, dependendo da categoria.

Uma grande mudança chegou em 2025: conversas de serviço iniciadas pelo usuário passaram a ser gratuitas — quando um cliente manda mensagem para você e você responde dentro da janela de serviço, isso geralmente não é cobrado. Categorias iniciadas pela empresa, como marketing e (em muitos casos) utilidade/autenticação, são pagas. As franquias e os preços exatos mudam e variam por país, então sempre confirme as tarifas atuais nas docs de preços da Meta em vez de confiar em um número fixo.

Categorias de conversa em termos simples

A cobrança gira em torno das categorias de conversa:

• Serviço — o cliente inicia a conversa; você responde dentro de uma janela de 24 horas. Em grande parte gratuita desde a mudança de 2025.
• Marketing — você promove de forma proativa (ofertas, lançamentos). Paga, e exige opt-in + templates aprovados.
• Utilidade — atualizações transacionais ligadas a uma ação (pedido enviado, lembrete de agendamento). Usa templates; o preço varia.
• Autenticação — códigos de uso único e verificação. Usa templates.

A regra prática: respostas de serviço iniciadas pelo cliente são a faixa barata/gratuita; marketing iniciado pela empresa é a faixa paga.

Mensagens de sessão vs. mensagens de template

• Dentro da janela de serviço de 24 horas (depois que um usuário te manda mensagem), você pode enviar mensagens em formato livre.
• Fora dessa janela, ou para iniciar uma conversa, você precisa enviar uma mensagem de template pré-aprovada. Os templates impedem que empresas mandem spam para usuários sem contato prévio.

O que você precisa para começar

Para enviar sua primeira mensagem, você vai configurar:

1. Uma conta Business da Meta (Facebook).
2. Um app da WhatsApp Business Platform no painel de desenvolvedor da Meta.
3. Um número de telefone registrado na plataforma (um número de teste é fornecido para começar).
4. Credenciais de API — um token e o ID do seu número de telefone.

A Meta fornece um número de teste e uma pequena franquia para você experimentar antes de entrar no ar.

Enviando sua primeira mensagem (a estrutura dela)

Uma vez configurado, o envio é uma requisição HTTP à Graph API da Meta. Conceitualmente:

POST https://graph.facebook.com/v22.0/${PHONE_NUMBER_ID}/messages
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "972541234567",
  "type": "text",
  "text": { "body": "Olá, aqui é da Cloud API!" }
}

Para mandar mensagem a alguém que não te contatou primeiro, troque type: "text" por uma mensagem template referenciando um template aprovado. Substitua ${PHONE_NUMBER_ID} e ${ACCESS_TOKEN} pelos seus próprios valores, e note que a versão da API (v22.0 aqui) muda ao longo do tempo.

Recebendo mensagens: webhooks

As mensagens recebidas chegam por um webhook — uma URL que você hospeda e que a Meta aciona sempre que um usuário te manda mensagem. Você verifica o webhook uma vez e, depois, a Meta envia os eventos de mensagem para ele. É assim que bots e caixas de entrada compartilhadas "ouvem" os clientes.

Um iniciante deve usá-la?

Faça duas perguntas:

• Preciso de automação ou de uma caixa de entrada de equipe? Se não, fique com o app gratuito do WhatsApp Business.
• Estou enviando em escala para usuários com opt-in? Se sim, a Cloud API é o caminho em conformidade.

Muitas pequenas empresas chegam à Cloud API por meio de um Provedor de Solução de Negócios (como Twilio, 360dialog ou MessageBird) ou de uma ferramenta no-code, que esconde a maior parte da API bruta. Para um caminho no-code, veja Automatize o WhatsApp com Zapier e Make e, para planejar custos, preços da API do WhatsApp Business.

Principais lições

• A hospedagem é gratuita; o envio tem um plano gratuito mais categorias pagas.
• Conversas de serviço iniciadas pelo usuário são, em grande parte, gratuitas desde 2025.
• Marketing/utilidade/autenticação usam templates aprovados e costumam ser pagas.
• Iniciantes sem necessidade de automação não precisam da API — um link wa.me cobre as conversas recebidas.

Comece simples com um link do WhatsApp gratuito e evolua para a Cloud API quando a automação exigir.