Teste Grátis
API oficial · Cloud API da Meta

API oficial do WhatsApp com o seu número, em minutos

Sem fila de homologação, sem ticket de suporte e sem tirar o número do celular: você entra com a sua conta da Meta, aponta o número que já está no WhatsApp Business e faz o primeiro POST. A tarifa da Meta você paga direto para a Meta — a gente não coloca margem.

Sem cartãoSem fidelidadeR$ 99/mês por númeroTarifa da Meta sem margemMesma API do QR Code

POST /api/WhatsGw/Send
$ curl -X POST https://app.whatsgw.com.br/api/WhatsGw/Send \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "SUA_APIKEY",
    "phone_number": "5511999999999",
    "contact_phone_number": "5511988888888",
    "message_custom_id": "pedido-4821",
    "message_type": "text",
    "message_body": "Olá, Marina! Seu pedido 4821 saiu hoje 🚚",
    "check_status": 1
  }'
$ch = curl_init('https://app.whatsgw.com.br/api/WhatsGw/Send');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'apikey' => 'SUA_APIKEY',
    'phone_number' => '5511999999999',
    'contact_phone_number' => '5511988888888',
    'message_custom_id' => 'pedido-4821',
    'message_type' => 'text',
    'message_body' => 'Olá, Marina! Seu pedido 4821 saiu hoje 🚚',
    'check_status' => 1,
  ]),
]);
echo curl_exec($ch);
const r = await fetch('https://app.whatsgw.com.br/api/WhatsGw/Send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'SUA_APIKEY',
    phone_number: '5511999999999',
    contact_phone_number: '5511988888888',
    message_custom_id: 'pedido-4821',
    message_type: 'text',
    message_body: 'Olá, Marina! Seu pedido 4821 saiu hoje 🚚',
    check_status: 1
  })
});
console.log(await r.json());
import requests

r = requests.post('https://app.whatsgw.com.br/api/WhatsGw/Send', json={
    'apikey': 'SUA_APIKEY',
    'phone_number': '5511999999999',
    'contact_phone_number': '5511988888888',
    'message_custom_id': 'pedido-4821',
    'message_type': 'text',
    'message_body': 'Olá, Marina! Seu pedido 4821 saiu hoje 🚚',
    'check_status': 1,
})
print(r.json())
var http = new HttpClient();
var envio = new {
  apikey = "SUA_APIKEY",
  phone_number = "5511999999999",
  contact_phone_number = "5511988888888",
  message_custom_id = "pedido-4821",
  message_type = "text",
  message_body = "Olá, Marina! Seu pedido 4821 saiu hoje 🚚",
  check_status = 1
};
var resp = await http.PostAsJsonAsync(
  "https://app.whatsgw.com.br/api/WhatsGw/Send", envio);
Console.WriteLine(await resp.Content.ReadAsStringAsync());
Clique no código para selecionar tudo. Troque a API key e os telefones — o resto já é o payload real.
resposta{ "result": "success", "result_message": "…" }
Olá, Marina! Seu pedido 4821 saiu hoje 🚚
1 popupda própria Meta: entre com o Facebook, escolha o número, pronto — sem abrir o Business Manager
0% de margemna tarifa da Meta: ela cobra na sua conta, pelo preço de tabela em reais
1 endpoint/WhatsGw/Send para oficial e QR Code — trocar o tipo de conexão não muda o seu código
desde 20192 mil+ clientes, 500 mi+ mensagens processadas, disponibilidade acima de 99%
A parte chata

Você já tentou integrar direto na Meta?

App no painel de desenvolvedor, token temporário, usuário de sistema, webhook com verificação e assinatura, template no Business Manager — e, no fim, o número que a equipe usa fica de fora, porque manter o número no aplicativo exige credenciamento de parceiro. Aqui isso já está feito.

App credenciado na MetaVocê entra no popup oficial com a sua conta e conecta o número do WhatsApp Business — a configuração de parceiro é nossa.
Token, webhook e registroAPI key fixa no lugar de token que expira; os eventos da Meta chegam prontos no seu webhook; o registro do número é feito no retorno.
Templates pela APICrie, envie para aprovação e acompanhe o status sem abrir o Business Manager — e dispare pelo mesmo Send.
Antes de começar

Três coisas para ter à mão — e a conexão sai de primeira

Quase toda conexão oficial que trava, trava por falta de uma destas três. Confira antes de clicar.

Conta no Meta Business com forma de pagamento

É no seu portfólio empresarial que a Meta cobra as mensagens dela. Cadastre o cartão antes de conectar — sem forma de pagamento, o número fica pendente na Meta.

Onde: business.facebook.com → Configurações → Pagamentos.

O número no WhatsApp Business, com o celular por perto

No popup da Meta você escaneia um QR com o WhatsApp Business. O número continua no aparelho: a equipe segue atendendo e a sua aplicação envia e recebe pela API.

Alternativa: um número novo, sem WhatsApp instalado, vira uma conta dedicada na nuvem — mesma API.

Verificação do negócio: opcional para conectar

Não é exigida para começar. Sem ela, a Meta libera 250 contatos únicos por dia; a verificação sobe o limite, que cresce conforme a qualidade dos seus envios.

Dica: inicie a verificação no Meta Business em paralelo, enquanto já integra.
Como funciona

Da conta ao primeiro POST em quatro passos

Sem fila de aprovação nossa, sem ninguém “liberando” a sua conta. Você faz sozinho, no seu horário.

Crie a conta

E-mail ou conta Google, sem cartão. Vêm 25 mensagens grátis para testar.

Conecte com a Meta

Nova instância → Oficial → Iniciar conexão com a Meta. No popup: entre no Facebook, escolha o portfólio, escaneie o QR com o WhatsApp Business. O número continua no celular.

Copie a API key

Em Administração → Telefones. É fixa — nada de token que expira em 24 horas nem usuário de sistema.

Faça o primeiro POST

Copie o exemplo lá de cima, troque a chave e os telefones. Peça um “oi” do destinatário e a mensagem livre sai na hora.

Quem começa a conversa?

Se o cliente te escreveu nas últimas 24 horas, qualquer texto, imagem, vídeo, PDF ou localização sai pelo Send, como no exemplo do topo.

Para você iniciar a conversa, a Meta exige um template aprovado. Você cria e envia para aprovação pela própria API (NewTemplate → SendTemplateToProvider), acompanha com SyncTemplateStatus e dispara pelo mesmo Send com o bloco template. Cabeçalho com imagem, vídeo ou PDF e variáveis no corpo.

{
  "apikey": "SUA_APIKEY",
  "phone_number": "5511999999999",
  "contact_phone_number": "5511988888888",
  "message_custom_id": "pedido-4821",
  "message_type": "text",
  "message_body": "",
  "template": {
    "id": 22,
    "components": [
      { "type": "body",
        "parameters": [ { "type": "text", "text": "Marina" } ] }
    ]
  }
}
Coexistência

Seu número continua no celular. A API entra do lado.

  • Nada muda para a equipe: ela segue atendendo pelo WhatsApp Business no aparelho, enquanto a sua aplicação envia e recebe pela API — no mesmo número.
  • Histórico inteiro no seu sistema: o que a equipe digita no app também chega ao seu webhook, como mensagem enviada.
  • Sem segunda linha: nenhum chip novo, nenhuma portabilidade, nenhum “anota aí nosso novo número”.
  • Prefere uma conta dedicada na nuvem? Conecte um número sem WhatsApp instalado e a Meta registra como Cloud API. A API é a mesma.
  • A conta é sua: a WhatsApp Business Account fica no seu portfólio da Meta. Número e histórico são seus.

WhatsApp Business no celular

A equipe atende, responde áudio, manda foto — como sempre.

um número+55 11 99999-9999

Sua aplicação pela API

Notificação, cobrança, confirmação, bot — e o webhook de tudo.

Direto na Meta ou pelo WhatsGW?

O que muda quando você integra por aqui

A Cloud API é a mesma por baixo. O que o WhatsGW tira do seu caminho está na tabela — e o que continua seu também.

CritérioDireto na MetaPelo WhatsGW
Manter o número no WhatsApp Business do celularSó com credenciamento de parceiro na MetaIncluído — conecta pelo popup
Até o primeiro envioApp, token, usuário de sistema, webhook, templatePopup da Meta + 1 POST
AutenticaçãoToken temporário ou usuário de sistemaAPI key fixa
WebhookVocê hospeda o endpoint da Meta, com verificação e assinaturaSeu URL recebe o JSON pronto, com o seu message_custom_id
MídiaUpload para a Meta e envio pelo idURL ou base64 no próprio POST
TemplatesBusiness ManagerPela API ou pelo painel
Oficial e QR Code na mesma integraçãoNãoMesma API, escolha por número
Atendimento humano, CRM e agente de IA no mesmo númeroNãoInclusos no painel
Dono da conta WhatsApp Business (WABA)VocêVocê — ela fica no seu portfólio da Meta
Para integradores e SaaS

Conecte os clientes do seu sistema sem virar parceiro credenciado

  • Crie a instância pela API com type: 3 e receba um direct_link para mandar ao seu cliente.
  • O cliente conecta sozinho: abre o link, entra com a conta da Meta dele e aponta o número dele. Nada de configurar app ou token para cada um.
  • Você acompanha o status por GetInstance ou pelo webhook, e cada cliente paga a tarifa da Meta na conta dele.
  • Sem limite de números por conta. Acima de 25 números, condição especial.
// POST /api/WhatsGw/NewInstance
{
  "apikey": "SUA_APIKEY",
  "type": 3,
  "config": {
    "description": "Cliente 4821",
    "webhook_url": "https://seu-sistema.com.br/whatsgw"
  }
}

// resposta: mande o direct_link ao seu cliente
{
  "result": "success",
  "w_instancia_id": 138683,
  "tipo": 3,
  "direct_link": "https://app.whatsgw.com.br/W-….aspx"
}
Experiência de desenvolvedor

REST puro, documentação viva e gente que integra todo dia

  • POST com JSON (ou form-urlencoded); GET quando couber. Sem SDK obrigatório.
  • Retorno assíncrono com check_status: entregue e lido chegam no seu webhook com o seu message_custom_id, para casar com o pedido.
  • Texto, imagem, vídeo, PDF e localização na oficial; templates com cabeçalho de mídia e variáveis no corpo.
  • Contrato OpenAPI para importar no Postman ou gerar o client; exemplos no GitHub em PHP, Node, Python, C# e Delphi.
  • Suporte técnico em português, de quem já conectou centenas de números na Meta.
PHPNode.jsPythonC#Delphicurl
Webhook · evento recebido
message_statusPOST no seu endpoint
{ "message_custom_id": "pedido-4821", "status": "read", "contact_phone_number": "5511988888888" }
✓ entregue 09:41✓✓ lido 09:43
/WhatsGw/Send/WhatsGw/GetTemplates/WhatsGw/NewTemplate/WhatsGw/SendTemplateToProvider/WhatsGw/SyncTemplateStatus/WhatsGw/NewInstance/WhatsGw/GetInstance/WhatsGw/PhoneState/WhatsGw/GetEvents
Preço previsível

R$ 99 por mês por número. A tarifa da Meta, pelo preço da Meta.

Pré-pago, sem fidelidade, sem taxa de setup. Mensagens ilimitadas do nosso lado; ou por mensagem, se preferir.

  • R$ 99/mês por número conectado — oficial ou QR Code, o mesmo preço
  • Ou por mensagem, escalonado: de R$ 0,120 a R$ 0,023 conforme o volume
  • API, webhooks, templates e chat multiatendente inclusos
  • 25 mensagens grátis para testar, sem cartão · acima de 25 números, condição especial

O que a Meta cobra — Brasil, por mensagem entregue

MarketingR$ 0,3217
Utilidade (pedido, cobrança, aviso)R$ 0,035
Autenticação (código)R$ 0,035
Atendimento (resposta livre na janela de 24 h) — 1.000 grátis por número por mêsR$ 0,035
Mensagem recebida do clienteR$ 0
Conversa iniciada por anúncio click-to-WhatsApp (72 h)R$ 0
Cobrado pela Meta direto na sua conta, sem repasse nem margem do WhatsGW. Tabela da Meta para o Brasil em outubro de 2026 — ela muda; confira a tabela oficial.
Perguntas frequentes

O que os desenvolvedores perguntam antes de conectar

Preciso tirar o número do WhatsApp Business do celular?

Não. O número continua no aparelho e a equipe segue atendendo por ele; a sua aplicação envia e recebe pela API no mesmo número (coexistência). Se preferir uma conta dedicada na nuvem, conecte um número sem WhatsApp instalado — a API é a mesma.

Preciso da verificação do negócio na Meta para conectar?

Não. Você conecta com a conta do Meta Business e uma forma de pagamento cadastrada. Sem verificação, a Meta libera 250 contatos únicos por dia; a verificação sobe o limite, que cresce com a qualidade dos envios.

Posso iniciar a conversa ou só responder?

Dentro de 24 horas depois da última mensagem do cliente, qualquer texto ou mídia sai pelo Send. Para iniciar a conversa, a Meta exige um template aprovado: você cria e envia para aprovação pela API (NewTemplate, SendTemplateToProvider), acompanha com SyncTemplateStatus e dispara pelo mesmo Send com o bloco template.

Quanto custa de verdade?

R$ 99 por mês por número conectado, com mensagens ilimitadas do nosso lado (ou o plano por mensagem, de R$ 0,120 a R$ 0,023). Além disso, a Meta cobra a tarifa dela direto na sua conta — no Brasil, R$ 0,035 por mensagem de utilidade, autenticação ou atendimento e R$ 0,3217 por mensagem de marketing, pela tabela de outubro de 2026. O WhatsGW não repassa nem acrescenta nada nessa parte.

A conta do WhatsApp Business (WABA) é minha ou do WhatsGW?

É sua: ela fica no seu portfólio do Meta Business. O número, os templates e o histórico são seus.

Que tipos de mensagem a conexão oficial aceita?

Texto, imagem, vídeo, documento (PDF e outros) e localização, por URL ou base64. Fora da janela de 24 horas, templates aprovados — com cabeçalho de imagem, vídeo ou documento e variáveis no corpo.

Já uso o WhatsGW por QR Code. Dá para migrar para a oficial?

Sim. Crie a instância oficial, conecte o número pelo popup da Meta e troque o phone_number nas suas chamadas. Endpoint, payload e webhook são os mesmos — e dá para manter os dois tipos na mesma conta.

Sou integrador. Como conecto os clientes do meu sistema?

Crie a instância pela API com type: 3 em NewInstance: a resposta traz um direct_link. Mande o link ao cliente; ele entra com a conta da Meta dele e conecta o número dele. Acompanhe por GetInstance ou pelo webhook. Cada cliente paga a tarifa da Meta na própria conta.

Conecte o seu número hoje

Crie a conta, entre com a sua conta da Meta e faça o primeiro POST. Sem cartão, sem fidelidade — e sem margem na tarifa da Meta.

API oficial · com o seu númeroConectar grátis
WhatsApp