WhatsApp API de Negócios do WhatsApp
Construa mensagens, automação, suporte, autenticação e comércio do WhatsApp diretamente em seu produto. A WhatsApp Business API é a interface programática para a WhatsApp Business Platform: aplicações enviam e recebem mensagens, reagem a eventos, automatizam conversas, gerenciam modelos e criam experiências interativas.
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?»
Capacidade da API
A API do WhatsApp Business não é um endpoint de «enviar mensagem» com extras. Esta é a interface que você está realmente integrando — o canal que a Meta fornece, não uma lista de funcionalidades do 1MSG.
| 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. |
FAQ
Respostas que você pode citar sem o resto da página.
| Pergunta | Resposta | Tópico |
|---|---|---|
| O WhatsApp Business API é gratuito? | Não. O aplicativo WhatsApp Business é gratuito para download; a API é um produto diferente. A Meta cobra por mensagens do WhatsApp de acordo com seus preços atuais. Se você usar uma plataforma adicional, também pagará por essa plataforma. Não há um número único útil para «o preço da API» — veja O que custa. | Custo |
| O WhatsApp Business API é o mesmo que o WhatsApp Business? | Não. O WhatsApp Business geralmente se refere ao WhatsApp Business App: um aplicativo para celular para pequenas equipes que respondem manualmente. A WhatsApp Business API é uma infraestrutura para software. O mesmo mensageiro, produto diferente. | Nomeação |
| O que é WhatsApp Cloud API? | A Cloud API é a forma atual de usar a plataforma WhatsApp Business: a Meta hospeda a API, você envia solicitações e recebe webhooks. Quando as pessoas falam sobre a WhatsApp Business API hoje, elas quase sempre se referem à Cloud API. | Nomeação |
| Eu preciso de uma conta WhatsApp Business? | Sim. Uma Conta de Negócios do WhatsApp (WABA) está sob o seu portfólio de negócios da Meta e possui os números de telefone que você utiliza para enviar mensagens. A API não funciona com uma conta pessoal do WhatsApp. | Acessar |
| Posso usar meu número de WhatsApp existente? | Frequentemente, se o número puder ser registrado como um número de negócio na Plataforma WhatsApp Business. Um número que ainda está ativo no WhatsApp para consumidores geralmente precisa ser migrado ou liberado primeiro. As regras de registro da Meta são a fonte de verdade para um número específico. | Número |
| Posso usar o mesmo número no aplicativo WhatsApp e na API? | Sim, na coexistência: o mesmo número pode estar no WhatsApp Business App e na API. As pessoas utilizam o aplicativo; o software usa a API. O modo tem limites de recursos e sincronização de histórico — leia a documentação atual de coexistência da Meta antes de confiar em um recurso específico do aplicativo. | Coexistência |
| Vou perder minhas conversas ao migrar do aplicativo Business? | Você não perde o número. Você não deve assumir que mantém uma cópia completa e consultável por API de cada conversa no aplicativo. O histórico depende do caminho de migração. Confirme isso na Documentação da Meta para o seu caso; não escreva um plano de transição que precisa que conversas antigas apareçam no software automaticamente. | Migração |
| 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 |