API Oficial doWhatsApp Business
Envie mensagens em escala, crie automações e conecte seu negócio ao WhatsApp com a API oficial da Meta. Sem risco de bloqueio, com suporte a templates, mensagens interativas e muito mais.
O que é a API Oficial do WhatsApp?
A WhatsApp Business Platform (Cloud API) é a solução oficial da Meta para empresas que precisam enviar mensagens em escala, com segurança e sem risco de bloqueio. Diferente do app comum ou do WhatsApp Web, a API oficial permite automações, integrações e envio de templates aprovados.
WhatsApp Business App
- 1 dispositivo
- Envio manual
- Sem integração
- Sem templates
- Até 256 contatos por lista
API Oficial (Cloud)
- Dispositivos ilimitados
- Envio em massa automatizado
- Integrações via API
- Templates aprovados
- Escala ilimitada
WhatsApp Web / QR
- 4 dispositivos
- Envio semi-automático
- Integrações limitadas
- Risco de bloqueio
- Sem templates oficiais
Vantagens da API Oficial
Recursos exclusivos que só a API oficial do WhatsApp oferece.
Escala ilimitada
Envie milhares de mensagens por dia sem risco de bloqueio ou banimento da conta.
Templates aprovados
Crie modelos de mensagem aprovados pela Meta para iniciar conversas a qualquer momento.
Mensagens interativas
Botões de resposta rápida, listas de opções e CTAs que aumentam o engajamento.
Automações
Chatbots, respostas automáticas e fluxos inteligentes integrados ao seu sistema.
Multiagente
Múltiplos atendentes na mesma conta, com filas, setores e distribuição automática.
Integração com CRM
API REST completa para conectar com qualquer sistema, ERP ou CRM existente.
Como funciona
Em 4 passos simples você está pronto para enviar mensagens via API oficial.
Criar conta Meta Business
Acesse business.facebook.com e crie sua conta de negócios gratuita.
Verificar empresa
Envie documentação da empresa para verificação pela Meta (leva 1-3 dias).
Conectar no OmniWhats
Na página de conexões, selecione "WhatsApp Cloud API" e autorize via OAuth.
Começar a enviar
Crie templates, configure automações e comece a atender seus clientes.
Categorias de mensagem
A Meta classifica as conversas do WhatsApp em 4 categorias, cada uma com preços e regras diferentes. Entender quando usar cada uma é essencial para otimizar seus custos e comunicar com eficiência.
Marketing
Promoções e campanhas
Utilidade
Avisos transacionais
Autenticação
Códigos e verificação
Serviço
Atendimento (grátis!)
Marketing
TEMPLATE OBRIGATÓRIOMensagens de marketing são usadas para iniciar conversas com conteúdo promocional, ofertas, novidades ou qualquer comunicação que não se enquadre em utilidade ou autenticação. É a categoria mais comum para campanhas de engajamento e vendas.
Quando usar
Exemplos de uso
Black Friday
Envie cupons exclusivos para sua base de clientes
Lançamento de produto
Apresente novidades com imagens e botão de compra
Reengajamento
Recupere clientes inativos com oferta personalizada
Pesquisa NPS
Pergunte ao cliente como foi a experiência de compra
Dica: Templates de marketing têm a maior taxa de rejeição na aprovação. Evite linguagem agressiva, promessas exageradas e sempre inclua opção de opt-out. Personalize com variáveis para aumentar o engajamento.
Exemplo de template
Olá {{nome}}! 🎉
Temos uma oferta especial para você: *30% OFF* em toda a loja este fim de semana!
Use o cupom *OMNI30* no checkout.
Visualização ilustrativa
Utilidade (Utility)
TEMPLATE OBRIGATÓRIOMensagens de utilidade são atualizações transacionais que o cliente espera receber. Estão diretamente relacionadas a uma ação que o cliente já realizou, como uma compra, agendamento ou solicitação. Têm preço menor que marketing.
Quando usar
Exemplos de uso
Pedido confirmado
Informe número do pedido, itens e previsão de entrega
Rastreamento
Envie atualizações automáticas de status da entrega
Lembrete de pagamento
Avise sobre boletos próximos do vencimento
Confirmação de consulta
Confirme data, horário e local do agendamento
Dica: Mensagens de utilidade têm aprovação mais rápida que marketing. O segredo é que o conteúdo deve ser esperado pelo cliente — ou seja, relacionado a uma ação prévia. Se você está enviando algo que o cliente não pediu, provavelmente é marketing.
Exemplo de template
Olá {{nome}}, seu pedido #{{numero}} foi confirmado! ✅
📦 *Itens:* {{itens}}
💰 *Total:* R$ {{valor}}
🚚 *Previsão:* {{data_entrega}}
Acompanhe pelo link abaixo:
Pedido realizado via omniwhats.com
Visualização ilustrativa
Autenticação
TEMPLATE OBRIGATÓRIOMensagens de autenticação são exclusivas para envio de códigos de verificação (OTP), confirmação de identidade e autenticação em dois fatores. A Meta oferece um template específico para essa categoria com formatação padronizada.
Quando usar
Exemplos de uso
Código de verificação
Envie OTP de 6 dígitos para validar o cadastro
Login 2FA
Confirme acesso com código temporário
Reset de senha
Envie código para redefinição de senha
Verificação de transação
Confirme operação financeira com código único
Dica: A Meta oferece um formato padrão para templates de autenticação com botão 'Copiar código'. Use-o para maior taxa de aprovação. O código deve ter expiração curta (5-15 min) e não pode ser reutilizado.
Exemplo de template
*{{codigo}}* é seu código de verificação.
Este código expira em 10 minutos.
Não compartilhe com ninguém.
Este código foi solicitado por você
Visualização ilustrativa
Serviço
SEM TEMPLATEGRATUITAMensagens de serviço são respostas enviadas dentro da janela de 24 horas após o cliente enviar uma mensagem. Não precisam de template aprovado e são completamente gratuitas. Essa é a forma mais econômica de se comunicar pelo WhatsApp!
Quando usar
Exemplos de uso
Suporte técnico
Resolva problemas do cliente no chat ao vivo
Dúvidas sobre produto
Responda perguntas sobre estoque, preços, tamanhos
Orçamento personalizado
Envie proposta comercial solicitada pelo cliente
Pós-venda
Auxilie com trocas, devoluções ou instruções de uso
Dica: Aproveite ao máximo a janela de 24h! Responda rápido para resolver tudo dentro do período gratuito. No OmniWhats, você vê um indicador visual quando a janela está prestes a fechar, para que nenhuma conversa fique sem resposta.
Exemplo de template
Olá! Obrigado por entrar em contato 😊
Sobre sua dúvida: sim, temos o produto em estoque nas cores *azul*, *preto* e *branco*.
O valor é R$ 89,90 com frete grátis para sua região. Deseja que eu reserve um para você?
Visualização ilustrativa
Resumo comparativo
| Característica | Marketing | Utilidade | Autenticação | Serviço |
|---|---|---|---|---|
| Precisa de template? | Sim | Sim | Sim | Não |
| Custo por conversa (BR) | ~R$ 0,50 | ~R$ 0,20 | ~R$ 0,17 | Grátis |
| Inicia conversa? | Sim | Sim | Sim | Não (resposta) |
| Janela necessária? | Não | Não | Não | Sim (24h) |
| Mídia permitida? | Sim | Sim | Não | Sim |
| Aprovação Meta? | Minutos-horas | Minutos | Minutos | N/A |
| Ideal para | Vendas e campanhas | Notificações | Segurança | Atendimento |
* Preços aproximados para o Brasil (maio/2025). Consulte a tabela oficial da Meta para valores atualizados.
Entendendo a janela de conversa
A Meta define regras de quando você pode enviar mensagens e a que custo.
Cliente envia mensagem
Quando o cliente inicia a conversa, abre-se uma janela de 24 horas para responder gratuitamente (categoria Serviço).
Após 24h sem resposta do cliente
A janela fecha. Para recontatar o cliente, é necessário usar um template aprovado (categorias Marketing, Utilidade ou Autenticação), que tem custo por mensagem.
Click-to-WhatsApp Ads (CTWA)
Conversas iniciadas via anúncios CTWA (Facebook/Instagram) abrem uma janela de 72 horas com templates gratuitos. A janela para mensagens livres continua sendo 24h. Após 24h, use templates (gratuitos por 72h) para reabrir a conversa.
Janela normal
24h
Respostas gratuitas
CTWA Templates
72h
Templates grátis via ads
Fora da janela
Template
Mensagem pré-aprovada
Chamadas de voz direto do WhatsApp
A Meta liberou (jul/2026) a API oficial de chamadas de voz do WhatsApp Business. Seu atendente atende e origina chamadas diretamente no OmniWhats, sem app externo, sem redirecionamento, com áudio em Opus HD.
Cliente liga pra você
Chamada iniciada pelo cliente é 100% gratuita, em qualquer país. Aparece pro atendente no painel na hora — ele atende direto no navegador.
Você liga pro cliente
Chamada iniciada pelo negócio precisa de autorização prévia do cliente e é cobrada por bloco de 6 segundos apenas quando conectada. Toques sem atender não geram custo.
Autorização por 7 dias
Antes da primeira ligação, o cliente aceita uma solicitação interativa no WhatsApp. A autorização vale ~7 dias e renova a cada chamada atendida.
Recursos do módulo no OmniWhats
- Modal centralizado com foto e nome do contato
- Seletor de microfone e caixa de som por atendente
- Áudio Opus HD (48 kHz), com cancelamento de eco
- Gravação automática (WebM/Opus) no player do histórico
- Página /configuracoes/chamadas com quem ligou, atendeu e duração
- Encaminhamento multi-tenant automático via biz_opaque_callback_data
Como funciona o custo
- Cliente → você: sempre grátis, em qualquer país.
- Você → cliente: cobrado por bloco de 6s apenas se atendida. Toques sem resposta = R$ 0,00.
- Solicitação de autorização: uma mensagem interativa (utility conversation). Valor varia por país; a Meta permite 1 solicitação a cada 24h e até 2 em 7 dias por contato.
- Rate limits: 100 chamadas iniciadas por dia por contato, 1.000 chamadas concorrentes por WABA.
- Bloqueios de saída: WABAs nos EUA, Canadá, Egito, Vietnã ou Nigéria não podem originar chamadas (só receber).
Fonte oficial: developers.facebook.com/…/whatsapp/calling/pricing
Detalhe importante
Se o cliente recusar 4 chamadas seguidas, a autorização é revogada e ele precisa autorizar de novo. Não desperdice ligações — use a autorização para casos onde o cliente está de fato esperando o retorno.
Limites de tamanho para mídias
Estes são os limites definidos pela Meta WhatsApp Cloud API. Eles não são impostos pelo OmniWhats — são regras oficiais que todo envio pela API precisa respeitar, independente da plataforma usada.
Imagens
JPEG, PNG
WebP e GIF são convertidos automaticamente pelo OmniWhats antes do envio.
Vídeos
MP4, 3GPP
Codec de vídeo H.264 e áudio AAC para máxima compatibilidade.
Áudio
AAC, M4A, AMR, MP3, OGG (Opus)
Mensagens de voz gravadas no navegador são convertidas automaticamente.
Documentos
PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT
Maior limite entre todos os tipos — ideal para envio de contratos e relatórios.
Stickers
WebP (estáticos ou animados)
Stickers animados devem ter no máximo 10 segundos.
E se o arquivo exceder o limite?
Quando um arquivo excede o limite da Meta, a mensagem é bloqueada antes do envio e você recebe um aviso claro informando o tamanho real do arquivo e o limite aplicável. Para imagens, o OmniWhats otimiza automaticamente antes do envio (convertendo para JPEG ou PNG e comprimindo quando necessário) — na grande maioria dos casos, o upload passa sem intervenção.
Fonte oficial: developers.facebook.com/docs/whatsapp/cloud-api/reference/media
Calcule o custo da sua campanha
Estime o investimento necessário para suas campanhas de WhatsApp com base no volume e categoria de mensagem.
Configurar campanha
Resultado estimado
Custo por mensagem
Custo total (mensal)
$62.50
≈ R$ 356,25
Custo mensal estimado
$62.50
≈ R$ 356,25
Comparativo por categoria (mensal)
Respostas a mensagens recebidas nas últimas 24h não têm custo.
Conversas via CTWA: 24h para mensagens livres + 72h de templates grátis.
Tabela de preços por país
Preços por conversa em USD. Mensagens de serviço (respostas em até 24h) são sempre gratuitas.
| Serviço | ||||
|---|---|---|---|---|
| 🇿🇦África do Sul | $0.0400 | $0.0065 | $0.0065 | GRÁTIS |
| 🇩🇪Alemanha | $0.1365 | $0.0200 | $0.0200 | GRÁTIS |
| 🇸🇦Arábia Saudita | $0.0450 | $0.0113 | $0.0113 | GRÁTIS |
| 🇦🇷Argentina | $0.0618 | $0.0260 | $0.0260 | GRÁTIS |
| 🇧🇷BrasilVOCÊ | $0.0625 | $0.0080 | $0.0315 | GRÁTIS |
| 🇨🇦Canadá | $0.0250 | $0.0040 | $0.0040 | GRÁTIS |
| 🇨🇱Chile | $0.0889 | $0.0200 | $0.0200 | GRÁTIS |
| 🇨🇴Colômbia | $0.0125 | $0.0008 | $0.0008 | GRÁTIS |
| 🇪🇬Egito | $0.1073 | $0.0113 | $0.0113 | GRÁTIS |
| 🇦🇪Emirados Árabes | $0.0370 | $0.0094 | $0.0094 | GRÁTIS |
| 🇪🇸Espanha | $0.0615 | $0.0094 | $0.0094 | GRÁTIS |
| 🇺🇸Estados Unidos | $0.0250 | $0.0040 | $0.0040 | GRÁTIS |
| 🇵🇭Filipinas | $0.0430 | $0.0076 | $0.0076 | GRÁTIS |
| 🇫🇷França | $0.1432 | $0.0200 | $0.0200 | GRÁTIS |
| 🇮🇳Índia | $0.0107 | $0.0014 | $0.0014 | GRÁTIS |
| 🇮🇩Indonésia | $0.0430 | $0.0020 | $0.0020 | GRÁTIS |
| 🇮🇱Israel | $0.0370 | $0.0050 | $0.0050 | GRÁTIS |
| 🇮🇹Itália | $0.0691 | $0.0094 | $0.0094 | GRÁTIS |
| 🇲🇾Malásia | $0.0860 | $0.0113 | $0.0113 | GRÁTIS |
| 🇲🇽México | $0.0305 | $0.0085 | $0.0085 | GRÁTIS |
| 🇳🇬Nigéria | $0.0516 | $0.0076 | $0.0076 | GRÁTIS |
| 🌐Outros países | $0.0732 | $0.0113 | $0.0113 | GRÁTIS |
| 🇵🇰Paquistão | $0.0476 | $0.0050 | $0.0050 | GRÁTIS |
| 🇵🇪Peru | $0.0703 | $0.0200 | $0.0200 | GRÁTIS |
| 🇵🇹Portugal | $0.0615 | $0.0094 | $0.0094 | GRÁTIS |
| 🇰🇪Quênia | $0.0350 | $0.0076 | $0.0076 | GRÁTIS |
| 🇬🇧Reino Unido | $0.0529 | $0.0094 | $0.0094 | GRÁTIS |
| 🌍Resto da África | $0.0225 | $0.0040 | $0.0040 | GRÁTIS |
| 🌎Resto da América Latina | $0.0740 | $0.0113 | $0.0113 | GRÁTIS |
| 🌏Resto da Ásia | $0.0732 | $0.0113 | $0.0113 | GRÁTIS |
| 🇪🇺Resto da Europa | $0.1365 | $0.0200 | $0.0200 | GRÁTIS |
| 🇷🇺Rússia | $0.0802 | $0.0094 | $0.0094 | GRÁTIS |
| 🇹🇷Turquia | $0.0109 | $0.0030 | $0.0030 | GRÁTIS |
Valores em USD por conversa. Fonte: Tabela de preços Meta WhatsApp Business Platform 2026.
Perguntas Frequentes
Tire suas dúvidas sobre a API Oficial do WhatsApp.
O WhatsApp Web usa engenharia reversa para se conectar, o que pode resultar em bloqueio da conta. A API Oficial é fornecida diretamente pela Meta, é segura, permite envios em massa e não tem risco de banimento.
A API em si é gratuita. Você paga apenas pelas conversas iniciadas por você (templates). Respostas a mensagens recebidas dentro de 24h são gratuitas (categoria Serviço). Os preços variam por país e categoria.
A criação da conta Meta Business é instantânea. A verificação da empresa leva de 1 a 3 dias úteis. Após aprovação, a conexão com o OmniWhats é feita em minutos via OAuth.
Sim! Você pode migrar seu número existente para a API Oficial. Porém, durante a migração, o número será desconectado do WhatsApp Business App ou WhatsApp pessoal.
Templates são modelos de mensagem pré-aprovados pela Meta. São obrigatórios para iniciar conversas fora da janela de 24h. Podem conter variáveis, botões e mídia. A aprovação leva minutos a poucas horas.
Contas novas começam com limite de 250 conversas/dia. Conforme você demonstra qualidade (poucos bloqueios), o limite sobe automaticamente para 1.000, depois 10.000 e finalmente ilimitado.
A Meta monitora a taxa de bloqueio e reclamações. Se a qualidade cair, seu limite de envio pode ser reduzido. Por isso é importante enviar conteúdo relevante e respeitar os opt-ins.
Não. A Meta exige que os contatos tenham dado consentimento (opt-in) para receber mensagens. Enviar spam pode resultar em restrições na conta.
Comece a usar a API Oficial do WhatsApp
Conecte seu negócio ao WhatsApp com a infraestrutura oficial da Meta. Sem risco de bloqueio, com escala ilimitada e suporte completo.