WhatsApp Business API

Meta Cloud API · Oficial

Conectar API

✅ Meta Cloud API · WhatsApp Business Platform

Integre a API Oficial do WhatsApp na sua plataforma

Acesse diretamente a infraestrutura da Meta para enviar mensagens de texto, mídia, templates, botões interativos e muito mais — 100% oficial e em conformidade.

🚀 Conectar agora 📄 Docs Meta

2B+

Usuários ativos

98%

Taxa de abertura

v21.0

Versão atual da API

11

Tipos de mensagem

Recursos

O que a API oficial oferece

A Meta Cloud API hospeda a infraestrutura do WhatsApp — sem necessidade de servidor próprio, com escalabilidade e SLA garantidos pela Meta.

📨

Templates (HSM)

Envie mensagens pré-aprovadas de Marketing, Utilidade e Autenticação para iniciar conversas proativamente.

🔘

Mensagens Interativas

Botões de resposta rápida, listas, catálogos de produtos, flows e call-to-action com URL ou telefone.

🖼️

Mídia Rica

Imagens, vídeos, áudios, documentos, figurinhas e localização — tudo enviado por ID de mídia ou URL.

🤖

Webhooks em Tempo Real

Notificações instantâneas de mensagens recebidas, status de entrega (sent/delivered/read) e erros.

📊

Rastreamento de Conversão

Meça o impacto das suas campanhas com eventos de conversão e rastreamento de cliques em links.

🔒

Segurança & Conformidade

Criptografia end-to-end nativa, opt-in obrigatório, conformidade com LGPD e políticas da Meta.

Referência da API

Tipos de mensagem suportados

Endpoint único para todos os tipos: POST /{version}/{phone-number-id}/messages

💬 text

🖼️ image

🎥 video

🎵 audio

📄 document

📍 location

😄 sticker

❤️ reaction

🔘 interactive

📋 template

👤 contacts

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "text",
  "text": {
    "preview_url": false,
    "body": "Olá! Mensagem via API Oficial 🚀"
  }
}

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": { "code": "pt_BR" },
    // Para templates com variáveis:
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "João" }
        ]
      }
    ]
  }
}

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "image",
  "image": {
    // Por URL:
    "link": "https://exemplo.com/imagem.jpg",
    // OU por Media ID (após upload):
    "id": "1234567890",
    "caption": "Legenda opcional da imagem"
  }
}
// Válido também para: video, audio, document, sticker

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "interactive",
  "interactive": {
    "type": "button",  // "button" | "list" | "flow" | "catalog_message"
    "header": { "type": "text", "text": "Título opcional" },
    "body": { "text": "Escolha uma opção abaixo:" },
    "footer": { "text": "Rodapé opcional" },
    "action": {
      "buttons": [
        { "type": "reply", "reply": { "id": "btn1", "title": "Sim ✅" } },
        { "type": "reply", "reply": { "id": "btn2", "title": "Não ❌" } }
      ]
    }
  }
}

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "location",
  "location": {
    "longitude": -46.6333,
    "latitude": -23.5505,
    "name": "Avenida Paulista",
    "address": "Av. Paulista, 1000 - Bela Vista, São Paulo"
  }
}

POST/{v21.0}/{phone-number-id}/messages

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.xxxxxxxxxxxx",
    "emoji": "❤️"
  }
}

✅ Resposta HTTP 200 (sucesso)

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "5511999999999", "wa_id": "5511999999999" }],
  "messages": [{ "id": "wamid.HBgLNTUxMTk...", "message_status": "accepted" }]
}

Templates

Categorias de mensagem template

Todos os templates precisam ser aprovados pela Meta antes do uso. Cada categoria tem regras e preços diferentes.

Categoria	Uso	Exemplos	Janela
MARKETING	Promoções, ofertas, cupons	Novidades, campanhas, carrossel de mídia	24h (após opt-in)
UTILITY	Transacional, pós-compra	Confirmação de pedido, rastreio, lembrete	24h
AUTHENTICATION	Verificação de identidade	OTP, código de segurança, 2FA	Pré-definida

Configuração

Conecte suas credenciais WABA

Preencha com as informações do seu app em developers.facebook.com. Os dados ficam salvos localmente no seu navegador.

🔑 Credenciais da Meta Cloud API

App → WhatsApp → Configurações de API no painel de desenvolvedores

Phone Number ID * ID do número no Meta Business Manager

WABA ID (WhatsApp Business Account) * ID da conta WABA

Access Token Permanente * Token do usuário de sistema com permissão whatsapp_business_messaging. Nunca compartilhe.

Versão da API

Webhook Verify Token String usada para verificar seu endpoint

URL do Webhook (HTTPS) Endpoint que receberá notificações da Meta. Deve retornar HTTP 200 + challenge na verificação.

Painel de Envio

Envie mensagens de teste

Teste todos os tipos de mensagem diretamente pela interface, sem precisar escrever código.

Número de destino * DDI + DDD + número. Sem + ou espaços.

Tipo de mensagem

Mensagem *

Guia Rápido

Como obter as credenciais da Meta

Siga os passos para criar sua conta WABA e obter acesso à Cloud API.

1

Crie um App no Meta for Developers

Acesse developers.facebook.com/apps, clique em "Criar App" e escolha o tipo Business. Adicione o produto WhatsApp.

2

Obtenha o Phone Number ID e WABA ID

No painel do seu App → WhatsApp → Configurações de API. Você verá o ID do número de telefone e o ID da conta do WhatsApp Business.

3

Gere um Token de Acesso Permanente

No Meta Business Manager → Usuários do Sistema, crie um usuário de sistema, atribua permissões whatsapp_business_messaging e whatsapp_business_management e gere o token.

4

Configure o Webhook

No painel do App → WhatsApp → Configuração → Webhook, cole a URL do seu endpoint HTTPS. Assine os campos: messages, message_deliveries e message_reads. Seu endpoint deve responder ao GET de verificação com o parâmetro hub.challenge.

5

Crie e aprove Templates (se necessário)

Para iniciar conversas proativamente, acesse o Meta Business Manager → WhatsApp Manager → Gerenciar Templates. Aguarde aprovação da Meta (geralmente minutos a horas).

6

Preencha as credenciais e envie a primeira mensagem

Cole as credenciais na seção Configurar acima e use o Painel de Envio para testar sem escrever código.