WhatsApp Business API: como funciona, passo a passo e sem jargão

30 de outubro de 2026 · 11 min de leitura · Equipe Linee

O que acontece por trás da API oficial do WhatsApp: as peças da conta, o caminho de uma mensagem, a janela de 24 horas, os modelos aprovados e como a Meta cobra. Com o passo a passo para começar.

A WhatsApp Business API funciona assim: o número da empresa é registrado na plataforma oficial da Meta e ligado a um sistema de atendimento. As mensagens dos clientes chegam a esse sistema, onde o time responde junto. Dentro de 24 horas após cada mensagem do cliente, a resposta é livre; fora disso, só com modelos aprovados.

Parece simples, e é. O que complica é que quase ninguém explica as peças do meio: por que o número sai do celular, quem aprova as mensagens, quando a Meta cobra e o que muda para quem atende. Neste guia você entende o caminho completo de uma conversa na API oficial, do primeiro "oi" do cliente até a fatura no fim do mês.

O que é a WhatsApp Business API

O nome oficial é Plataforma do WhatsApp Business. A Meta chama de API (um jeito de dois sistemas conversarem entre si) porque ela não tem tela própria: não existe um aplicativo "WhatsApp API" para baixar. O que existe é uma conexão entre o número da sua empresa e o sistema onde o time atende.

Hoje essa conexão roda na nuvem da própria Meta, na chamada WhatsApp Cloud API. Segundo a documentação oficial da plataforma, consultada em 30 de outubro de 2026, ela permite enviar e receber mensagens de texto, fotos, documentos, botões e listas, fazer e receber chamadas e até criar grupos.

Se a sua dúvida é a diferença entre o aplicativo e a API, escrevemos um comparativo completo em WhatsApp Business ou API: a diferença e quando cada um faz sentido. Aqui o foco é o que acontece por dentro.

As peças da API oficial do WhatsApp da Meta

Para a API funcionar, a Meta pede quatro peças. Você não precisa montar nenhuma delas sozinho, mas vale saber o que cada uma faz:

1. Portfólio empresarial (o antigo Gerenciador de Negócios). É a "pasta" da empresa dentro da Meta, onde ficam todas as contas. Verificar a empresa nesse portfólio libera mais recursos, como mais volume de envio e o selo de conta oficial.
2. Conta do WhatsApp. É a presença da empresa no WhatsApp: os números, o nome que aparece para o cliente e quem tem acesso.
3. Conta de mensagens. Guarda os modelos de mensagem, a cobrança e a forma de pagamento.
4. Um sistema conectado. É o programa que recebe e envia as mensagens pela API. Pode ser feito pela própria empresa, com programadores, ou contratado pronto, numa plataforma de atendimento.

Na prática, quase toda empresa usa a quarta peça pronta. É ela que vira a tela do atendente, com caixa de entrada, filas e histórico.

Número oficial da empresa: o que muda com o seu número

O número continua sendo o da empresa, com o mesmo DDD. O que muda é onde ele "mora". Pela página oficial sobre números comerciais, o número precisa:

• ser seu;
• ter código do país e DDD;
• conseguir receber ligação ou SMS, para a Meta confirmar que ele é seu.

Depois de registrado na API, o número continua fazendo ligações e recebendo SMS normalmente, mas deixa de funcionar no aplicativo comum do WhatsApp. Se ele já está em uso num WhatsApp, a regra geral é apagar a conta do aplicativo antes de registrar.

Existe uma exceção importante. A Meta permite manter o aplicativo WhatsApp Business e a API no mesmo número, desde que a conexão seja feita por um parceiro oficial e o aplicativo esteja atualizado. As conversas ficam sincronizadas entre os dois. A regra está na documentação de quem já usa o aplicativo. Antes de migrar, pergunte à plataforma escolhida se ela oferece esse caminho.

Ao registrar o número, a empresa também define o nome de exibição (o que o cliente vê), o perfil comercial (endereço, site, descrição) e um PIN de segurança. Empresas que cumprem os requisitos da Meta podem pedir o selo de conta oficial, o tique azul ao lado do nome.

Como funciona a WhatsApp Business API na prática

Imagine uma loja que atende pelo número oficial. Um cliente escreve às 10h perguntando se tem o produto em estoque. Veja o caminho dessa conversa:

1. O cliente manda a mensagem pelo WhatsApp de sempre. Para ele, nada muda.
2. A Meta recebe e repassa a mensagem para o sistema conectado ao número, na hora.
3. A mensagem cai na caixa de entrada do time. Um atendente pega a conversa, ou um atendente de IA responde primeiro e passa para uma pessoa quando precisa.
4. A janela de 24 horas abre. Até as 10h do dia seguinte, a loja pode responder com qualquer mensagem: texto, foto, áudio, botões.
5. Cada nova mensagem do cliente renova a janela. Se ele escrever de novo às 15h, o prazo passa a contar a partir das 15h.
6. Depois da janela, só com modelo. Se a loja quiser avisar que o produto chegou três dias depois, precisa usar um modelo de mensagem aprovado.

Tudo o que o cliente envia e cada aviso de "entregue" e "lido" passam por esse mesmo caminho. É por isso que o histórico fica guardado no sistema da empresa, e não num celular.

A janela de 24 horas e os modelos de mensagem

Essa é a regra que mais confunde quem chega na API. A página oficial de preços, consultada em 30 de outubro de 2026, explica:

• Mensagem livre (sem modelo) só pode ser usada para responder, dentro da janela de 24 horas que abre e renova a cada mensagem do cliente.
• Modelo de mensagem é um texto preparado antes e, em geral, aprovado pela Meta. É o único tipo que pode ser enviado fora da janela, e serve para a empresa puxar conversa.

Os modelos se dividem em categorias. A categoria define o preço:

Os modelos também ganham uma nota de qualidade e estão sujeitos a limites de envio. Mensagem útil, para quem pediu, é o que mantém essa nota alta.

Quanto custa usar a API do WhatsApp Business

Pela página oficial de preços da Meta, consultada em 30 de outubro de 2026:

• desde 1º de julho de 2025, a Meta cobra por mensagem entregue pela empresa ao cliente;
• o valor depende da categoria da mensagem e do país de quem recebe;
• mensagem que o cliente manda para a empresa não é cobrada;
• cada número tem 1.000 mensagens de atendimento grátis por mês, que não acumulam de um mês para o outro;
• quando o cliente chega por um anúncio que abre conversa no WhatsApp e a empresa responde dentro da janela, abre-se uma janela gratuita que pode durar até 7 dias.

Além da Meta, a plataforma de atendimento conectada ao número costuma ter um custo próprio. Some os dois antes de decidir.

A API do WhatsApp Business é gratuita?

Não. A Meta cobra as mensagens que a empresa envia e que chegam ao cliente, com as exceções da lista acima. Na prática, uma empresa que só responde clientes, dentro da janela, pode gastar pouco com a Meta. Quem dispara marketing para a base paga por cada mensagem entregue.

Como contratar a API oficial: passo a passo

1. Organize o portfólio empresarial da sua empresa na Meta e, se puder, faça a verificação da empresa.
2. Escolha o número. Pode ser o atual, apagando a conta do aplicativo ou usando a conexão que mantém os dois, ou um número novo só para o atendimento.
3. Escolha como vai usar a API: contratar uma plataforma de atendimento pronta, ligada à Meta, ou desenvolver o próprio sistema. Sem time de programação, a primeira opção é o caminho.
4. Conecte o número. As plataformas costumam usar o cadastro guiado da própria Meta: você entra com a sua conta, escolhe o portfólio e confirma o número com um código.
5. Cadastre a forma de pagamento na conta de mensagens da Meta.
6. Crie os primeiros modelos de mensagem e espere a aprovação.
7. Organize o atendimento antes de virar a chave: quem responde o quê, em que ordem e com quais mensagens prontas.

O passo 7 é o que mais fica para depois, e é o que mais faz diferença. Falamos disso em o WhatsApp é da empresa ou de quem atende?.

Como saber se o meu WhatsApp Business é API

Três perguntas resolvem:

• Você atende pelo aplicativo do WhatsApp Business no celular, ou pelo WhatsApp Web ligado a ele? Então usa o aplicativo.
• A empresa contratou uma plataforma de atendimento ligada à Meta, com acesso para cada atendente? Então provavelmente usa a API.
• Existe uma conta de mensagens com forma de pagamento no portfólio da empresa na Meta? Esse é o sinal mais claro de API.

Se a resposta à primeira for "sim" e às outras for "não", você está no aplicativo. Para colocar mais gente atendendo nele, veja como colocar vários atendentes no WhatsApp Business.

O que a API permite que o aplicativo não permite

• Atendentes sem limite de aparelhos. Cada pessoa entra com o próprio acesso na plataforma.
• Fila e responsável por conversa. Ninguém responde em dobro, nenhuma conversa fica sem dono.
• Atendentes de IA. Respondem a qualquer hora e chamam uma pessoa quando o caso pede. Explicamos o que esperar em IA no atendimento sem mitologia.
• Integração com outros sistemas, como pedidos e CRM.
• Relatórios de volume, tempo de resposta e conversas paradas.
• Avisos automáticos de pedido, agendamento e entrega, com modelos de utilidade.

Qual a melhor API para WhatsApp Business?

A API é uma só: a oficial da Meta. O que muda é a plataforma que você liga a ela. Para escolher, olhe menos para a lista de recursos e mais para o seu dia a dia:

• A plataforma é parceira oficial e conecta o número pelo cadastro da Meta?
• Ela deixa manter o aplicativo junto, se você precisa disso?
• O time consegue usar sem treinamento longo?
• Dá para ter fila, responsável e transferência entre áreas?
• Tem atendente de IA que passa a conversa para uma pessoa?
• O que é combinado na conversa vira tarefa ou pedido em algum lugar?
• Os custos da Meta aparecem de forma clara?

4 erros comuns de quem começa na API

1. Achar que é um aplicativo novo. A API não tem tela. Sem uma plataforma conectada, ninguém consegue atender.
2. Ignorar a janela de 24 horas. O cliente some, a janela fecha e a empresa descobre que precisa de um modelo aprovado para retomar a conversa.
3. Disparar marketing para todo mundo. Cada mensagem entregue custa, a nota de qualidade dos modelos cai e mandar para quem não deu permissão vai contra as regras do WhatsApp.
4. Apagar o aplicativo sem plano. Antes de migrar, confirme o que acontece com o histórico e com o número, e avise o time.

Perguntas frequentes

Quanto custa usar a API do WhatsApp Business?

A Meta cobra por mensagem entregue pela empresa, conforme a categoria (marketing, utilidade, autenticação ou atendimento) e o país de quem recebe. Mensagens do cliente não são cobradas e cada número tem 1.000 mensagens de atendimento grátis por mês. A plataforma de atendimento costuma ter custo próprio.

A API do WhatsApp Business é gratuita?

Não. A Meta cobra as mensagens que a empresa envia e são entregues, com exceções como as 1.000 mensagens de atendimento grátis por mês e a janela gratuita aberta por anúncios que levam ao WhatsApp.

Como saber se o meu WhatsApp Business é API?

Se você atende pelo aplicativo no celular ou pelo WhatsApp Web ligado a ele, usa o aplicativo. Na API, o atendimento acontece numa plataforma conectada à Meta, e a empresa tem uma conta de mensagens com forma de pagamento.

Preciso de um número novo para usar a API?

Não necessariamente. Dá para usar o número atual apagando a conta do aplicativo ou, por meio de um parceiro oficial, mantendo o aplicativo e a API juntos no mesmo número.

A API do WhatsApp é a mesma coisa que o WhatsApp Cloud API?

Na prática, sim. A Cloud API é a API da plataforma oficial que roda na nuvem da própria Meta. Quando alguém fala hoje em API oficial do WhatsApp, quase sempre está falando dela.