Como enviar mensagem no WhatsApp usando a API Oficial da Meta

O problema que todo dev brasileiro enfrenta

Você precisa enviar mensagens de WhatsApp automaticamente. Talvez seja uma confirmação de pedido, um código de verificação, ou uma campanha de marketing. O primeiro instinto é googlar "api whatsapp grátis" e cair em soluções como Baileys, whatsapp-web.js, Z-API ou Evolution API.

Essas ferramentas funcionam lendo o QR Code do WhatsApp Web e simulando um navegador. O problema: a Meta detecta esse comportamento e bane seu número. Não é questão de "se", é questão de "quando". E quando acontece, você perde o número, o histórico de conversas e a confiança dos seus clientes.

Para projetos pessoais, tudo bem. Para um produto em produção com clientes pagando? É um risco que não vale a pena.

O que é a WhatsApp Business Platform (Cloud API)?

A WhatsApp Business Platform é a forma oficial que a Meta oferece para empresas enviarem mensagens em escala. Ela roda 100% na nuvem da Meta -- você não precisa de celular ligado, não precisa escanear QR Code, e não tem risco de banimento (desde que siga as políticas de uso).

O porém: configurar diretamente pela Meta é burocrático. Você precisa criar um app no Meta Developers, configurar um Facebook Business Manager, ativar o billing em dólares, lidar com webhooks complexos... e o suporte é em inglês, via ticket. Para uma empresa brasileira, isso pode levar semanas.

A alternativa: usar um BSP brasileiro

Um BSP (Business Solution Provider) é um parceiro oficial da Meta que simplifica todo esse processo. A AraraHQ é um BSP feito no Brasil, para desenvolvedores brasileiros. Ao invés de semanas de configuração, você faz o setup em minutos e paga em reais.

Na prática, muda o seguinte:

• Setup: Cria conta, conecta no Meta via popup embarcado, e tá pronto. Menos de 5 minutos.
• Cobrança: Em reais (R$), com nota fiscal. Sem IOF, sem spread cambial.
• Suporte: Em português, com engenheiros que entendem o produto. E-mail ou WhatsApp.
• SDK: TypeScript tipado, docs interativas, sandbox grátis.

Na prática: enviando sua primeira mensagem

import { Arara } from '@ararahq/sdk';

const arara = new Arara(process.env.ARARA_API_KEY!);

// Enviar template aprovado pela Meta
const resultado = await arara.messages.send({
  to: "5511999999999",
  type: "template",
  template: {
    name: "confirmacao_pedido",
    language: "pt_BR",
    components: [
      {
        type: "body",
        parameters: [
          { type: "text", text: "João" },
          { type: "text", text: "#4521" }
        ]
      }
    ]
  }
});

console.log("Enviado:", resultado.messageId);
// -> Enviado: wamid.HBgNNTUx...

Esse código envia uma mensagem de template (as únicas que podem ser enviadas fora da janela de 24h). O template precisa estar aprovado pela Meta -- você cria ele no dashboard da Arara e a aprovação costuma levar de alguns minutos a poucas horas.

E mensagens de texto livre?

A API Oficial da Meta tem uma regra importante: você só pode enviar mensagens livres (sem template) dentro de uma janela de 24 horas após o cliente te enviar uma mensagem. Isso se chama "session message" ou "service conversation".

// Cliente mandou mensagem -> janela aberta por 24h
await arara.messages.send({
  to: "5511999999999",
  type: "text",
  text: "Oi João! Seu pedido #4521 saiu pra entrega. 🚚"
});

// Também funciona com imagem, documento, áudio...
await arara.messages.send({
  to: "5511999999999",
  type: "image",
  image: {
    url: "https://seusite.com/comprovante-4521.png",
    caption: "Comprovante de envio"
  }
});

Recebendo mensagens (Webhooks)

Quando alguém manda mensagem pro seu número, a AraraHQ dispara um webhook pra URL que você configurou. O payload segue o padrão da Meta, mas limpo -- sem aqueles objetos aninhados desnecessários.

app.post("/webhook/whatsapp", (req, res) => {
  const { from, type, text, timestamp } = req.body;

  console.log(`Mensagem de ${from}: ${text?.body}`);

  // Aqui você processa a mensagem:
  // - Salva no banco
  // - Responde automaticamente
  // - Encaminha pra fila do suporte

  res.sendStatus(200); // Importante: responder rápido
});

Quanto custa?

A Meta cobra por "conversa", não por mensagem. Uma conversa é uma janela de 24h com um contato. O preço varia pelo tipo:

• Marketing (promoções, campanhas): a partir de R$ 0,60/conversa
• Utilidade (confirmações, rastreio, boletos): a partir de R$ 0,20/conversa
• Serviço (cliente inicia a conversa): R$ 0,10/conversa

Na AraraHQ, o plano Essencial começa em R$ 57/mês e esse valor é 100% revertido em créditos de API. Ou seja, você não paga mensalidade "jogada fora" -- tudo vira crédito de envio.

Próximos passos

Se você tá começando agora, o caminho é simples:

1. Cria sua conta na AraraHQ (leva 30 segundos)
2. Conecta sua conta da Meta pelo popup embarcado (2 minutos)
3. Pega sua API key no dashboard
4. Instala o SDK e envia sua primeira mensagem

Se já usa uma API não-oficial e quer migrar, leia nosso guia de riscos das APIs piratas. Se vem da Twilio, temos um passo a passo de migração.