Comece aqui
Resumo e custos
Este guia mostra como colocar o WhatsApp oficial da Meta na sua empresa.
A Meta cobra quando a sua empresa inicia a conversa. Se o cliente te procurou, você atende de graça por 24 horas, digitando o que quiser. Se a empresa voltar a falar depois desse prazo, haverá cobrança de novo. Leia nesta ordem: custos, depois mensagens para iniciar contato.
Por que tudo isso existe?
Antes de sigla, entenda o motivo
A documentação oficial da Meta muitas vezes parece escrita para quem já é da área de tecnologia. Este guia tenta o caminho oposto: primeiro a lógica do negócio, depois os cliques.
Se você quer mandar mensagem para muitos clientes sem o número cair por spam, o WhatsApp pede algo simples de entender, mas chato de montar: provar que quem envia é uma empresa de verdade.
Isso não é capricho da Meta. No passado, perfil falso e número clonado disparavam propaganda o dia inteiro. Por isso hoje existe uma separação clara entre você como pessoa (seu login, seu perfil, no sentido de CPF) e sua empresa como negócio (com responsabilidade sobre página, anúncio e WhatsApp, no sentido de CNPJ).
O coração do processo é montar o escritório administrativo da empresa dentro da Meta. Os códigos técnicos vêm depois, quando essa base já faz sentido.
Na sequência, explicamos a diferença entre vitrine e escritório.
Comece aqui
Vitrine e escritório: coisas diferentes
Uma o cliente vê; a outra fica nos bastidores
Muita gente acha que basta ter Página no Facebook e Instagram da loja e pronto. Para a API oficial do WhatsApp, não é assim. O Portfolio empresarial (nome antigo: Business Manager, sigla BM) é outra camada, que fica por trás.
A vitrine é o que o público enxerga: posts, fotos, comentários, anúncio rodando. No dia a dia você mexe nisso pelo Meta Business Suite, que é o painel “de operação” da presença nas redes.
O escritório é o que o cliente não vê. É onde a Meta registra quem é dono da Página, do Instagram, do WhatsApp, do cartão de pagamento e de cada permissão da equipe. Esse escritório é o Portfolio. Pense nele como a sede administrativa do negócio dentro da Meta, não como mais uma rede social.
Quando mais adiante aparecerem siglas como WABA, token e IDs, lembre que, na prática, são só números e senhas desse escritório, para o seu sistema conversar com o WhatsApp.
Comece aqui
O Portfolio empresarial
Quem fala “BM” está falando da mesma coisa
O Portfolio funciona como o cadastro empresarial da sua marca dentro da Meta. Ali ficam registrados quem é dono da Página, do Instagram, do WhatsApp, qual cartão paga as conversas e quem da equipe pode fazer o quê.
Você precisa dele porque a Meta não libera envio em massa no nome de pessoa física. Ao montar o Portfolio, você está dizendo ao WhatsApp: esta conta representa um negócio real, com documentação e responsabilidade sobre o que é enviado. É o que destrava a API oficial.
Dentro do Portfolio você cadastra a empresa e as pessoas que vão trabalhar nela. Dá para liberar acesso para alguém responder mensagem sem passar o cartão de crédito da empresa, da mesma forma que um funcionário pode atender na loja sem ter a senha do banco.
O cliente final nunca “entra” no Portfolio. Na prática, você abre essa sede com os dados do negócio e depois vincula a Página e o Instagram a ela, como se dissesse: essas vitrines agora pertencem a este escritório. Tudo isso se configura em business.facebook.com/settings.
Mapa simples
Onde clicar, em linguagem simples
Três endereços na internet, cada um com um papel
No Meta Business Suite você cuida da vitrine no dia a dia, publicando, respondendo a caixa de entrada e acompanhando anúncios. No Portfolio você cuida do que é de dono, como pagamento, equipe, permissões e a senha de acesso que não expira para a API. Por outro lado, no Meta for Developers você cria o aplicativo técnico que conecta o seu sistema ou software de atendimento ao WhatsApp.
Ou seja, só a Página do Facebook, sozinha, não vira API. Quando o cadastro estiver completo, você vai copiar três códigos importantes, e o passo a passo detalhado está na parte “Cadastro (15 etapas)” deste guia. Se quiser seguir agora, comece pela etapa 1; se a dúvida for custo, veja também preços e modelos de mensagem.
Opcional
O Business Suite é só a vitrine
Leitura extra, se o mapa já ficou claro
O Business Suite é onde você “dirige” o dia a dia da presença nas redes: postar, ver mensagens, olhar resultado de anúncio. Ele não cria App, não gera senha permanente da API e não substitui o API Setup do WhatsApp.
Em outras palavras, o Suite é para operar o que o público vê, enquanto o Portfolio é para ser dono do negócio dentro da Meta. São funções diferentes, e confundir as duas é um dos erros mais comuns no cadastro.
Opcional
A Central de Contas é você, pessoa física
Leitura extra
A Central de Contas é o lugar do seu login e senha pessoais na Meta (como a conta que você usa para entrar). Não é ali que nasce a API do WhatsApp.
O Portfolio representa a empresa. O Developers representa o programa técnico que vai falar com a API. São camadas diferentes, e misturar as três é uma das causas mais comuns de travar no cadastro.
Opcional
Por que a Meta espalha em vários sites?
Leitura extra sobre App e senha
No Developers você monta o programa que liga o seu sistema ao WhatsApp, enquanto no Portfolio você define quem é dono do negócio e gera a senha de acesso que não cai da noite para o dia. Vale lembrar que a senha de teste que aparece no Developers expira rápido; para produção de verdade, a senha estável sai do Portfolio, na área de Usuários do sistema. Os apps ficam em developers.facebook.com/apps.
Etapa 1 de 15
Começar o cadastro técnico
Você já leu vitrine vs escritório?
Se sim, siga uma etapa de cada vez, sem pular. Se ainda não, vale voltar em Vitrine e escritório e em O Portfolio, porque o cadastro técnico fica bem mais fácil depois dessa base.
Daqui em diante o caminho passa por Página do Facebook, Instagram, Portfolio, conta de desenvolvedor, App, número de telefone e senha de acesso. No final, use o resumo dos IDs para copiar tudo sem trocar um código pelo outro.
Etapa 2 de 15
Página do Facebook
É a cara pública da empresa, não é a API
A Página do Facebook é a vitrine oficial da marca na rede. Ela precisa estar vinculada ao Portfolio; sem isso, o ecossistema comercial da Meta fica pela metade e o cadastro da API costuma travar mais adiante.
Criar Página
Etapa 3 de 15
Instagram empresarial
Perfil profissional ligado à Página
O Instagram precisa ser conta empresarial (business ou creator) e estar ligado à Página. Isso fecha o pacote que o Business Suite espera. O Instagram, sozinho, não configura a API do WhatsApp, mas completa a presença da empresa nas redes da Meta.
Etapa 4 de 15
Meta Business Suite
business.facebook.com
Aqui você gerencia a presença social da empresa. Este painel não cria o App do WhatsApp, não gera a senha permanente da API e não substitui a tela de API Setup no Developers.
Abrir Business Suite
Etapa 5 de 15
Portfolio empresarial (o antigo BM)
Quem é dono de tudo
Nesta etapa você confirma se já tem um Portfolio ou cria um novo. Sem ele, não há conta WhatsApp de produção, não há forma de pagamento das conversas e não há como gerar a senha estável pelo System User.
Configurações do Portfolio
Etapa 6 de 15
Vincular Página e Instagram
Configurações, depois Contas
Abra Configurações, vá em Contas, depois Páginas e Instagram, e confira se a Página e o perfil certos estão dentro do Portfolio que você vai usar na API.
Etapa 7 de 15
Conta Meta for Developers
Registro de desenvolvedor
Na hora de se registrar, escolha o perfil de Desenvolvedor se quem vai mexer na API e nas integrações é você ou alguém do time técnico.
Registrar
Etapa 8 de 15
Criar o App WhatsApp
developers.facebook.com/apps
Entre em developers.facebook.com/apps e clique em criar um app. Dê um nome que você reconheça depois (pode ser o nome da empresa mais “WhatsApp API”). Na lista de casos de uso, escolha Conectar com clientes pelo WhatsApp e selecione o Portfolio empresarial que você montou nos passos anteriores.
Get Started
Etapa 9 de 15
Função do App
Licença técnica
Sem o App criado, não existe webhook oficial, não aparece o Phone Number ID no painel e não dá para pedir permissão de produção. Anote o App ID em um lugar seguro; você vai precisar dele várias vezes.
Etapa 10 de 15
API Setup e WABA
WhatsApp Business Account ID
No menu do App, abra WhatsApp e depois API Setup. Ali você cria ou conecta a conta WhatsApp Business (WABA). Copie o WhatsApp Business Account ID e tome cuidado para não confundir com o ID do Portfolio, que é outro número.
developers.facebook.com/apps/SEU_APP_ID/whatsapp-business/wa-dev-console/
Etapa 11 de 15
Phone Number ID
ID do número na API
Você pode começar com o número de teste da Meta ou cadastrar o número real da empresa (com confirmação por SMS). O painel mostra o Phone Number ID, que é o código que o seu sistema usa nas chamadas para graph.facebook.com/.../messages.
Registrar número
Etapa 12 de 15
Token temporário vs permanente
Não use token de teste em produção
A senha que o API Setup gera na hora serve para teste e expira rápido. Para ambiente de produção, a senha correta vem do System User criado no Portfolio.
Access tokens
Etapa 13 de 15
System User + Bearer permanente
business.facebook.com/settings
Em Configurações do Portfolio, abra Usuários do sistema e crie um usuário com perfil de administrador, com um nome que você reconheça depois, como “whatsapp-api”. Em seguida, atribua a ele o App e a conta WhatsApp da empresa, com permissão total. Depois clique em gerar token, marque as permissões de gestão do negócio e do WhatsApp que o painel mostrar, e guarde o resultado em local seguro, por exemplo um arquivo de ambiente que não vai para o repositório de código.
Etapa 14 de 15
Gerenciador do WhatsApp
Templates e visão do número
No Gerenciador do WhatsApp você acompanha modelos de mensagem, limites e visão geral do número. Para integração no código, o Phone Number ID continua sendo o que aparece no API Setup do App.
Etapa 15 de 15
Depois dos credenciais
Base pronta. A migração continua
Com o WABA ID, o Phone Number ID e o Bearer token em mãos, a base de credenciais está fechada, mas ainda não é produção completa. Além disso, você vai precisar configurar o webhook em HTTPS, ter modelos de mensagem aprovados, passar pelo App Review e deixar o pagamento ativo no Portfolio. Se for migrar um número que hoje está no celular ou em alguma API não oficial, desligue o antigo antes de registrar na Meta, porque usar os dois ao mesmo tempo costuma gerar conflito. Para copiar os códigos com calma, veja o resumo dos IDs; para entender cobrança, abra preços e modelos de mensagem.
Seção separada · custos
Preços e templates
Quanto custa usar a API oficial?
Você paga por mensagem entregue, não por “ter a API ligada”
A Meta cobra quando a mensagem chega de fato no celular da pessoa, e não só no momento em que você aperta enviar. O valor muda conforme o país de quem recebe e o tipo da mensagem.
A regra principal é esta: a Meta cobra quando a empresa inicia a conversa; não cobra quando você responde um cliente que te procurou primeiro, dentro de 24 horas. Os detalhes estão em como funcionam os custos. Se a empresa inicia o contato, o texto precisa ser cadastrado e liberado antes; isso está explicado em mensagens para iniciar contato.
Fonte oficial: Preços da Plataforma WhatsApp Business
Preços · custos
Como funcionam os custos (na prática)
Quem tomou a iniciativa de mandar a mensagem
A Meta cobra quando a sua empresa inicia a conversa. Se a empresa manda a primeira mensagem, ou volta a falar depois que o período gratuito de 24 horas acabou, haverá cobrança.
Se o cliente procura a sua empresa, você nunca paga para responder. Quando ele manda mensagem, ou clica em “Falar no WhatsApp” no anúncio ou na Página do Facebook, a Meta abre 24 horas para você atendê-lo. Nesse tempo, a conversa é livre: texto, áudio, foto ou vídeo, sem cobrança de contato ativo.
Se o cliente some e as 24 horas acabam, a conversa gratuita encerra. Se a empresa quiser falar de novo depois disso, a Meta trata como novo contato iniciado pela empresa: haverá cobrança de novo. Qual texto pode ser usado nesse caso está em mensagens para iniciar contato (leia essa parte antes de disparar campanha).
No Brasil, por exemplo, a calculadora da Meta mostra mensagens de promoção em dólar por volta de US$ 0,0625 por mensagem entregue quando a empresa inicia; confira a tabela atual.
Preços · mensagens ativas
Mensagens para iniciar contato (como funciona)
O que fazer antes da empresa mandar a primeira mensagem
Esta parte responde uma dúvida comum: se a Meta cobra quando a empresa inicia a conversa, como eu mando esse texto? Você não digita na hora. O processo é cadastrar antes e esperar liberação.
Primeiro, abra o Gerenciador do WhatsApp e crie a mensagem com o texto que a empresa quer usar (por exemplo: “Olá, sua fatura vence amanhã”).
Depois, envie para análise da Meta. Eles verificam o conteúdo, classificam o tipo (promoção, aviso de pedido, código de login, etc.) e liberam ou pedem ajuste.
Só depois de liberada essa mensagem o seu sistema pode usá-la para iniciar conversa com clientes. Cada envio entregue desse tipo é cobrado, conforme a regra do slide anterior.
Resumo da ordem: escreve no painel → Meta analisa e libera → aí sua empresa pode iniciar conversa com aquele texto → a Meta cobra a entrega.
Documentação oficial sobre mensagens cadastradas
Preços · categorias
As 4 categorias de mensagem
A Meta classifica cada template em uma delas. O preço muda
Na calculadora oficial da Meta você escolhe o país (por exemplo Brasil), a moeda e o tipo de mensagem. O preço é sempre por mensagem que chegou no celular do cliente.
A Meta divide os modelos em quatro famílias. Marketing é promoção, oferta e mensagem do tipo “sumiu, volta aqui”. Utilidade é aviso de pedido, agendamento ou lembrete de entrega. Autenticação é código de login ou confirmação. Serviço é resposta de atendimento enquanto o prazo de 24 horas está aberto, e a Meta não cobra.
Um exemplo real da calculadora, para o Brasil em dólar, é um modelo de Marketing entregue por cerca de US$ 0,0625 cada. Além disso, outros países e outras categorias mudam o valor, por isso vale abrir a tabela antes de fechar orçamento.
Abrir calculadora de taxas
Preços · gratuito
O que a Meta não cobra (ou cobra menos)
O que a página oficial de preços destaca
A Meta não cobra o atendimento dentro da conversa aberta. Quando a empresa manda um aviso de pedido ou agendamento justamente porque o cliente chamou, a cobrança não segue a mesma regra de contato ativo. Se a pessoa chegou pelo anúncio com botão de WhatsApp ou pelo botão na Página do Facebook, a Meta libera até 72 horas de mensagens gratuitas, conforme as regras da plataforma.
Por outro lado, quem envia muito aviso de utilidade ou código de login pode cair em faixas de preço melhores por volume. O país usado na conta é o do cliente que recebe, e o tipo definido na aprovação do modelo. Se a Meta reclassificar ou reprovar um modelo, o preço muda, por isso vale acompanhar o Gerenciador do WhatsApp com frequência.
Preços simples e transparentes (WhatsApp Business)
Resumo
Códigos para copiar sem trocar um pelo outro
No fim do cadastro você vai ver vários números parecidos, e cada um tem um papel diferente. O Portfolio ID identifica a empresa no painel da Meta, o antigo Business Manager; você encontra nas configurações do Portfolio. O WABA ID é a conta WhatsApp Business da empresa, e aparece no API Setup do App, junto com o Phone Number ID, que é o identificador do número na API, ou seja, não é o DDD nem o +55 que você digita no dia a dia.
Além disso, o App ID é o identificador do aplicativo criado no Developers, em developers.facebook.com/apps. Por fim, o Bearer token é a senha de acesso longa para produção, gerada pelo usuário do sistema no Portfolio. Guarde tudo em local seguro e confira duas vezes antes de colar no seu sistema ou backend.