API oficial do WhatsApp Business API Cloud a partir de R$ 39/canalAPI de Negócios do WhatsApp
Conecte seu número de negócios ao WhatsApp Cloud API através do 1MSG — mensagens, webhooks e modelos sem precisar construir a infraestrutura você mesmo.
Mesmo mensageiro. Três produtos diferentes.
WhatsApp Business API não é outro aplicativo do WhatsApp. É a infraestrutura que os desenvolvedores usam para conectar o WhatsApp ao software. O Business App é um produto que você usa. A Business API é a infraestrutura com a qual você constrói. Se uma ou duas pessoas atendem um número limitado de clientes manualmente, o Business App é suficiente. Wrappers e emuladores não oficiais não são a Business API: eles correm o risco de banimentos de número, quedas de sessão e são inadequados para qualquer coisa que você não possa perder.
| Comparado com | Aplicativo WhatsApp Empresarial | WhatsApp Business API |
|---|---|---|
| Projetado para | Pequenas empresas | Mensagens de negócios escaláveis e software |
| Interface | App | API |
| Respostas manuais | Principalmente | Opcional |
| Automação | Básico | Completo |
| Integração de backend | Limitado | Sim |
| CRM / suporte técnico | Limitado | Sim |
| Desenvolvedores necessários | Não | Geralmente |
| Escalar | Equipes pequenas | Aplicações e negócios |
Hoje é chamado de API de Nuvem
As pessoas buscam pelo WhatsApp Business API e se referem ao Cloud API na Plataforma de Negócios. Essa fórmula é suficientemente próxima para navegar pela Documentação — com um porém: a plataforma é mais ampla do que um único ponto de mensagem. Uma vez que os nomes se estabilizarem, a verdadeira questão é por que deixar um aplicativo gratuito.
- WhatsApp Plataforma de Negócios
O nome da Meta para toda a pilha de negócios no WhatsApp — números, contas, modelos, mensagens e o restante.
- API de Nuvem
Como você se comunica com essa plataforma hoje: a Meta a hospeda, você envia solicitações e recebe webhooks. Você não gerencia um servidor WhatsApp.
- API Local
A geração anterior, autohospedada. O envio de mensagens por meio dela foi descontinuado. Se um tutorial ainda disser para você instalar On-Premises, está descrevendo um stack que você não deve construir.
Por que usar a WhatsApp Business API
Mantenha o app quando você mudar, deixe seu backend ver qual anúncio iniciou o chat e execute o número a partir do software — não de um telefone. A automação, os hooks do CRM e a escalabilidade aparecem mais tarde nesta página. Este bloco é a parte que a maioria dos artigos ainda erra — ou nunca menciona.
| O que as pessoas sentem falta | O que a API realmente adiciona | Na prática |
|---|---|---|
| Trocar não retira o aplicativo | O mesmo número pode funcionar no app e na API ao mesmo tempo: as pessoas continuam respondendo onde já trabalham, e o software envia notificações e lida com entradas por fora. Você está adicionando a API. Você não está confiscando o chat que sua equipe já utiliza. | A coexistência tem limites — quais recursos do app permanecem disponíveis, como o histórico sincroniza. Verifique a documentação da Meta para a lista atual antes de contar com um específico. |
| Seu backend vê qual anúncio iniciou o chat | Um anúncio Click-to-WhatsApp no Facebook ou Instagram pode abrir um chat com o Business App. O produto do anúncio não é exclusivo da API. O que a API adiciona é o evento: o webhook que entrega a primeira mensagem também carrega qual anúncio e qual fonte iniciaram a conversa. | Atribua a conversa e responda ou direcione-a no software, em vez de combinar anúncios com chats manualmente. |
| O número vive em software | O aplicativo de negócios vive em um telefone. A API não. O número é um objeto em seus sistemas: nenhum aparelho precisa ficar online, vários aplicativos e vários agentes podem usá-lo ao mesmo tempo, e o canal não depende de quem está segurando o dispositivo hoje. | O canal não depende de um aparelho ficar online. |
O que você pode construir
Se você já conhece o trabalho, o restante desta página é sobre a implementação. Estes são os trabalhos que as equipes realmente realizam na WhatsApp Business API. Navegue por todos os casos de uso em /use-cases.
Como funciona
Duas direções, um modelo. Se você implementar apenas o outbound, construiu apenas metade de um canal. Cliente ↔ WhatsApp ↔ WhatsApp Cloud API ↔ seu backend — e do backend: CRM, IA, Suporte.
- 1 · Saída
Seu aplicativo envia solicitações de API. A saída é uma chamada HTTP: uma mensagem, um modelo, um upload de mídia. O WhatsApp não está consultando seu servidor.
- 2 · Entrega
O WhatsApp entrega a mensagem. A infraestrutura da Meta a coloca no telefone do usuário. Você não opera esse caminho.
- 3 · Webhooks
Webhooks enviam eventos de volta. Mensagens de entrada e os status que informam se uma mensagem foi enviada, entregue, lida ou falhou, chegam como callbacks. Seu aplicativo reage. Ele não pergunta «algo novo?»
O que você pode construir
Se você já conhece o trabalho, o resto desta página é a implementação. Estes são os trabalhos que as equipes realmente entregam na WhatsApp Business API.
| Grupo | Para que serve | O que você realmente recebe |
|---|---|---|
| Mensagens | Envie e receba mensagens pelo WhatsApp. | O texto é o começo, não o produto. A mesma API envia e recebe imagens, vídeos, áudios e documentos — você faz upload e download de mídia em vez de anexá-la de um telefone — além de localização, contatos, reações e adesivos. |
| Experiências interativas | Transforme uma conversa em uma interface. | Botões de resposta, listas, chamadas para ação e respostas estruturadas coletam uma escolha sem analisar texto livre. Fluxos do WhatsApp são mini-formulários nativos dentro da conversa: reserva, aplicações, pesquisas, registro, onboarding — o usuário não sai do WhatsApp para enviar um formulário. |
| Modelo e mensagens de saída | Inicie conversas que o canal realmente entregará. | Um negócio que escreve mensagens iniciais usa modelos que a Meta revisou: Utilitário, Autenticação, Marketing. Modelos existem porque o WhatsApp é um canal com permissão. A revisão acontece antes da primeira mensagem de saída, não após uma reclamação. Mensagens de sessão e mensagens de modelos não são intercambiáveis no seu código. |
| Eventos e webhooks | Reaja enquanto a conversa está acontecendo. | Webhooks entregam mensagens recebidas; status de enviado, entregue, lido e falhado; erros; respostas a mensagens interativas; pedidos; eventos de chamada; eventos de conta; e o contexto de clique quando uma conversa começou a partir de um anúncio. O aplicativo que ignora webhooks pode enviar. Ele não consegue operar. |
| Comércio | Coloque um catálogo no tópico. | Catálogos de produtos, mensagens de um único produto e múltiplos produtos, carrosséis, pedidos e configurações de comércio permitem que alguém navegue e compre sem ser enviado a uma loja aleatória. O catálogo é um objeto de negócios, não um PDF que você anexa. |
| Chamando | Coloque a voz do WhatsApp no mesmo backend que o chat. | Receba e faça chamadas do WhatsApp a partir do seu aplicativo. Conecte um PABX ou um centro de atendimento — incluindo via SIP — quando o canal de voz deve pertencer ao mesmo registro do cliente que o histórico. |
| Gestão de negócios | Gerencie a conta do WhatsApp como software, não como uma configuração do telefone. | Números de telefone, perfis empresariais, contas do WhatsApp Business, modelos, códigos QR e configuração de conta são objetos da API. O Cadastro Embutido é a janela nativa da Meta para conectar o WhatsApp de um cliente ou de uma filial sem um ticket. |
| Escala e operações | Saiba o que o canal permitirá antes de prometer uma data de lançamento. | Limites de mensagem, classificação de qualidade e throughput — incluindo aumentos automáticos de capacidade — determinam quanto você pode enviar. Os status de entrega e erros informam o que realmente aconteceu. Os números atuais estão na documentação da Meta porque mudam. |
Você não pode só mandar mensagem para todo mundo
WhatsApp não é uma lista que você faz upload. Se a integração assumir que uma planilha de números é suficiente para iniciar a conversa, estará errada no primeiro dia — no código, não apenas na política. Uma conversa não precisa começar na caixa de entrada: um anúncio Click-to-WhatsApp, um código QR ou um botão em seu site ainda é o usuário iniciando o thread. Alguns desses pontos de entrada utilizam uma janela de atendimento diferente. A ideia é estável; os cronômetros não são — use a documentação da Meta, não um número desta página.
- Iniciado pelo cliente
A pessoa escreveu primeiro. Dentro da janela de atendimento ao cliente, você pode responder de forma livre. Quando a janela fechar, você volta aos modelos.
- Iniciado pela empresa
Você escreve primeiro apenas com um modelo aprovado, por uma razão que a pessoa pode razoavelmente esperar.
- Aceitar
Eles concordaram em ouvir você e esperam o tipo de mensagem que você está enviando. A opção de aceite não é uma brecha em torno dos modelos.
O que custa
Não existe um único «preço da WhatsApp Business API». Há uma estrutura de custos. As tarifas mudam; essa forma não muda. Seu custo *total* = cobranças de mensagem do WhatsApp + cobranças da plataforma ou sua própria infraestrutura. Os preços para 1MSG estão no cabeçalho e rodapé do site. Eles não são repetidos aqui.
| Camada | O que você paga | O que isso significa |
|---|---|---|
| Meta | Você paga pelas mensagens do WhatsApp. | O valor depende do tipo de mensagem, do mercado e do modelo de preços atual da Meta — que já mudou e mudará novamente. Esta página não cita tarifas. |
| Uma plataforma | Assinatura, markup, taxa de número, configuração — muitas vezes uma mistura. | Compare a conta completa, não apenas uma linha em uma tabela de preços. |
| Direto para a Nuvem API | Não há fatura do fornecedor. | Ainda há uma conta: hospedagem, um banco de dados, armazenamento de mídia, filas, monitoramento e o tempo de engenharia para manter essa pilha correta quando a API mudar. |
Construa você mesmo ou use uma plataforma
Uma API te dá capacidades. Não te dá um produto. Se você se conectar diretamente à API do WhatsApp na Nuvem, você obtém os primitivos para construir seu próprio produto WhatsApp. Você decide como as mensagens são armazenadas, exibidas, roteadas e integradas ao resto da sua pilha. Twilio, 1MSG, respond.io e outros existem porque essa segunda parte é trabalho real — não porque o WhatsApp é diferente dependendo do fornecedor. A diferença aparece como tempo para produção, o que você paga para manter as coisas funcionando e quem está acordado quando os webhooks falham às 2 da manhã. A API na Nuvem não é pior. É incompleta como produto. A forma como você obtém acesso é uma questão separada de como você armazena mensagens: seu próprio aplicativo Meta, um BSP ou um Provedor de Tecnologia. Um BSP não é obrigatório. Através de um Provedor de Tecnologia, o WABA e o número podem continuar sendo seus, com o Cadastro Embutido como o fluxo de conexão.
| Camada | WhatsApp Business API fornece para você | Uma plataforma adiciona |
|---|---|---|
| O canal | Mensagens, webhooks, modelos, mídia, Flows, chamadas, objetos de negócios. | Uma caixa de entrada, histórico de conversas, ferramentas para agentes, integrações com CRM, automação, análises, registros, tentativas, gerenciamento de usuários, ganchos de IA, faturamento e ferramentas para desenvolvedores. |
Por que 1MSG
O WhatsApp fornece a rede de comunicação. A 1MSG fornece a infraestrutura de desenvolvedor ao redor dela. Use a 1MSG quando você quiser o canal e uma camada de produção ao redor — não um número alugado e não um ano escrevendo filas.
- Seu WABA, não uma linha alugada
Conecte-se com o Cadastro Integrado. A Conta do WhatsApp Business e o número de telefone permanecem seus. O acesso direto é como a plataforma é construída, não um plano secundário.
- Histórico que você pode consultar
A API da nuvem entrega mensagens. Ela não oferece um armazenamento de conversas. A 1MSG mantém o histórico disponível através da API, para que você não precise criar um banco de dados para lembrar o conteúdo da conversa de ontem.
- Mídia que sobrevive ao webhook
As URLs de mídia do WhatsApp têm validade curta. Os arquivos ficam na plataforma, então você não precisa se preocupar com o link ou gerenciar seu próprio armazenamento.
- Webhooks que tentam novamente
Uma chamada perdida é uma entrada perdida se ninguém a colocar na fila. O 1MSG coloca a entrega do webhook na fila e tenta novamente, garantindo que o tráfego de produção não seja um POST sem garantias.
- Envie antes que o número esteja pronto
Número de teste, sandbox, API, SDK e Documentação incluem conectar, webhooks e a primeira mensagem sem esperar.
- Operar o canal em um só lugar
Modelos, várias contas e números, faturamento e suporte — o trabalho que a API Cloud deixa do seu lado da conexão.
Tudo que você precisa para construir no WhatsApp
A versão burocrática dessa história é um mês de tickets da Meta antes de um Olá Mundo. A versão funcional é uma lista de verificação curta, e então uma primeira mensagem. O que você precisa: um portfólio de negócios da Meta, uma Conta Comercial do WhatsApp, um número de telefone comercial, verificação de número, verificação de negócios quando a Meta exigir — não em todos os casos, um token de acesso e um endpoint de webhook. Um número de teste e uma conexão de sandbox cobrem, webhooks e a primeira mensagem sem sua própria linha. A lista de verificação é como a produção se parece, não o preço da tentativa. Transferindo um número do Aplicativo Comercial: você mantém o número. O histórico de conversas no aplicativo não se torna automaticamente um histórico completo que sua API pode consultar — confirme isso na documentação da Meta para a sua configuração.
| Passo | O que fazer | Notas |
|---|---|---|
| 1 | Crie ou conecte uma conta do WhatsApp Business | WABA faz parte do seu portfólio de negócios da Meta. |
| 2 | Adicione o número de telefone da sua empresa | Um número que ainda está ativo no WhatsApp consumidor geralmente precisa ser migrado ou liberado primeiro. |
| 3 | Conecte a API | Embedded Signup é o fluxo de conexão nativo. |
| 4 | Configurar webhooks | Inbound e status chegam como callbacks. O recebimento não é um produto separado. |
| 5 | Envie sua primeira mensagem | Comece pelo quickstart: https://help.1msg.io/platform-1msg/getting-start/quick-start |
| 6 | Construa sua integração | Modelos, roteamento, CRM, agentes, bots — o produto em torno do canal. |
Os desenvolvedores precisam de mais do que a API Cloud
A WhatsApp Cloud API da Meta oferece as funções essenciais para enviar e receber mensagens. A 1MSG a complementa com a infraestrutura em torno da WhatsApp Business API, para que você possa se concentrar em seu produto e entregar rapidamente.
| Capacidade | WABA | Com 1MSG |
|---|---|---|
| Histórico de mensagens | Você constrói isso | API para histórico de mensagens |
| Armazenamento de mídia | Armazenado por 30 dias | Sem limite de tempo |
| Registro de entrega | Você constrói isso | Incluído |
| Modelos | Configuração manual | Modelo automático incluído |
| Suporte | Autoatendimento | Incluído |
| Observabilidade | Você constrói isso | Em breve |
| Implantação de aplicativo | Você hospeda isso | Em breve |
| Posso executar anúncios Click-to-WhatsApp com a API? | Sim. Anúncios que abrem um chat no WhatsApp funcionam com o App Business e com a API. Com a API, o primeiro webhook de entrada pode incluir qual anúncio e qual fonte iniciaram a conversa, para que você possa atribuir e gerenciá-lo em código. | Ads |
| Quão rápido posso enviar mensagens? | O atravessamento segue os limites de mensagens e a classificação de qualidade, não um canal ilimitado. A capacidade pode aumentar automaticamente à medida que o número permanece em boas condições. Os limites atuais estão na documentação da Meta; eles não estão impressos aqui porque mudam. | Limites |
| Eu preciso de um Facebook Business Manager verificado? | Você precisa de um portfólio de negócios do Meta. A verificação de número é necessária. A verificação de negócios é obrigatória em alguns casos, não como um primeiro passo universal. Se o Meta pedir isso na sua conta, você não pode pular; se não pedir, não bloqueie seu projeto com o boato de que todos devem verificar no primeiro dia. | Acessar |
| Quanto tempo leva para ter acesso? | Conectar um número e enviar uma primeira mensagem pode ser rápido — especialmente com um número de teste. A verificação de negócios, revisão de modelo e movimentação de uma linha de produção levam mais tempo quando a Meta está envolvida. Não há um SLA que sirva para todos de forma honesta. | Acessar |
| Como posso obter o ✔️ (conta de negócio oficial)? | O tique verde é o status de Conta de Negócios Oficial. A Meta o concede a marcas que atendem aos seus critérios; conectar a API não o produz, e nem escolher um provedor específico. Trata-se do negócio que a Meta vê, não do método de integração. | Marca |
| Posso enviar mensagens para qualquer pessoa? | Não. Você não pode carregar um banco de dados e enviar mensagens. Ou a pessoa começou a conversa (e você está dentro do período de atendimento) ou você envia um modelo aprovado que ela tenha um motivo para receber, com opt-in para esse tipo de mensagem. | Regras |
| O WhatsApp API pode receber mensagens? | Sim. Mensagens de entrada chegam em webhooks, juntamente com status de entrega e leitura. O recebimento não é um produto separado. | Capacidades |
| Posso usar a API do WhatsApp para suporte ao cliente? | Sim. Entrada, roteamento, agentes, bots e histórico são usos padrão da API. O suporte é uma construção, não um modo que você alterna no WhatsApp. | Casos de uso |
| Posso conectar a API do WhatsApp a um CRM? | Sim. Essa é uma das principais razões para usar a API em vez do aplicativo: as conversas se tornam registros no sistema que você já utiliza. | Casos de uso |
| O WhatsApp API suporta chatbots de IA? | A API entrega mensagens e eventos. Você anexa qualquer modelo ou agente que desejar. O WhatsApp não hospeda seu assistente; ele carrega a conversa. | Casos de uso |
| O WhatsApp API pode fazer chamadas? | Sim. As capacidades de chamada da WhatsApp Business Platform permitem que aplicações recebam e façam chamadas de voz pelo WhatsApp, inclusive para um PBX ou centro de contato. | Capacidades |
| O WhatsApp API suporta pagamentos? | Ele suporta catálogos, mensagens de produtos e pedidos. Os pagamentos nativos no chat dependem do que a Meta ativou em um mercado específico. Não prometa finalização da compra global desta página. | Capacidades |
| O WhatsApp Business API é seguro e está em conformidade com o GDPR? | As mensagens do WhatsApp são criptografadas de ponta a ponta no mensageiro. Sua integração ainda armazena o que você optar por manter — histórico, mídia, logs — e esse processamento é sua responsabilidade (e de seu provedor) sob o GDPR. A criptografia em trânsito no WhatsApp não substitui um DPA, regras de retenção ou controle de acesso nos sistemas ao redor da API. | Segurança |
| O que aconteceu com a API On-Premises do WhatsApp? | On-Premises era a geração anterior auto-hospedada. O envio de mensagens por meio dele foi descontinuado. O novo trabalho vai através da API Cloud. | Nomeação |
| Eu preciso de um BSP para usar a API do WhatsApp? | Não. Você pode usar seu próprio aplicativo do Meta, um BSP ou um Provedor de Tecnologia. Um BSP é um caminho, não um requisito. Com um Provedor de Tecnologia, o WABA e o número podem continuar sendo seus. | Acessar |
| Posso migrar meu número para outro provedor? | Se você possui a Conta do WhatsApp Business e o número, normalmente você pode transferi-los para outro provedor. Se o número é alugado de um BSP, você está no processo desse BSP. A propriedade é a questão a ser resolvida antes de você integrar, e não depois que estiver ao vivo. | Acessar |