API do WhatsApp Business #

Conecte sua empresa ao WhatsApp por meio da API oficial do WhatsApp Business. Este canal é a escolha recomendada para empresas que precisam de mensagens de WhatsApp confiáveis e de alto volume, com modelos de mensagem pré-aprovados e rastreamento de entrega.

Não é necessária uma conta separada do Twilio. O Twilio é o serviço de telefone e mensagens que entrega suas mensagens do WhatsApp nos bastidores. A plataforma cria uma conta gerenciada do Twilio para você automaticamente, portanto, você não precisa se inscrever no Twilio ou conectá-lo à Meta manualmente. A compra de um número ou a conexão de um existente ocorre inteiramente dentro do aplicativo. Se você precisar especificamente trazer sua própria conta do Twilio (por exemplo, se você já tiver números aquecidos e modelos aprovados lá), abra o cartão Conta do Twilio na página Canais e alterne para sua própria conta, depois anexe seu remetente existente — ambas as etapas estão em Provedor de SMS (Traga seu próprio Twilio). A maioria dos usuários deve manter a configuração gerenciada.

Pré-requisitos #

Antes de começar, certifique-se de ter o seguinte:

• Uma Conta comercial da Meta (business.facebook.com) — a verificação da empresa é opcional: empresas não verificadas podem ativar um número, obter aprovação de modelos e enviar transmissões, começando no limite de 250 contatos únicos a cada 24 horas (consulte Limites de mensagens abaixo)
• Uma conta com créditos suficientes
• Um número de telefone que não esteja registrado no WhatsApp (aplicativo pessoal ou Business) e que não seja um número Twilio de outra conta

Adicione o nome e o endereço da sua empresa primeiro. Antes de poder comprar seu primeiro número, preencha o nome e o endereço da sua empresa em Configurações → Empresa (grupo do Workspace). A operadora valida este endereço, portanto, certifique-se de que ele esteja preciso e completo — a compra falhará até que isso seja definido.

Passo 1: Comprar um número de telefone #

1. Na barra lateral esquerda, clique em Settings (Configurações) próximo à parte inferior.
2. Na barra lateral esquerda de Settings, em Channels (Canais), clique em Channels.
3. Encontre o cartão WhatsApp Business API e clique no botão verde Connect WhatsApp (Conectar WhatsApp).
4. Escolha Get a new number from us (Obter um novo número conosco), depois Managed by us (Gerenciado por nós).

4. Um pop-up Comprar número de telefone será aberto. Escolha um país — os números e os preços em tempo real vêm diretamente da nossa operadora para aquele país — e, opcionalmente, filtre por Contém dígitos.

5. Navegue pela lista de available numbers (números disponíveis) que aparece, cada um com seu custo de compra única e custo mensal exibidos ao lado.

6. Clique em um número e preencha seu Nome de exibição — o nome da empresa que as pessoas veem no WhatsApp. Ele deve conter letras; um número de telefone puro será rejeitado. Em seguida, confirme o custo exibido e conclua a compra.

Um número comprado aqui é para o WhatsApp, não para SMS. Números adquiridos através da plataforma são usados para o WhatsApp Business. Eles não são números de SMS e também não são números para chamadas: uma chamada recebida chega a um gravador automático (que serve para atender à chamada de verificação do WhatsApp durante a configuração), não há caixa postal para ouvir mensagens e você não pode fazer chamadas a partir do número. O SMS funciona na sua própria conta Twilio — veja SMS. Não diga aos clientes que um número comprado pode fazer ambos; ele não pode.

Créditos são deduzidos da sua conta pela compra. Cada número possui então um aluguel mensal para mantê-lo ativo: pelo menos 50 créditos por mês, e números premium custam mais, de acordo com o que a operadora cobra. O cartão do número em Configurações → Canais sempre mostra seu preço mensal exato, e a caixa de diálogo de compra o exibe antes de você confirmar.

Esse aluguel é a única taxa mensal sobre o número — ele inclui a conexão com o WhatsApp, portanto, não há nada extra a pagar para manter o número no WhatsApp. Se você já aluga números aqui, eles passarão para essa tarifa no próximo ciclo de faturamento. Veja Números de Telefone.

México e Argentina: apenas números de celular são oferecidos para esses países. O WhatsApp trata os números nesses locais como números de celular, e apenas um número de celular pode receber o código de verificação do WhatsApp — números de telefone fixo não podem, por isso não são listados. Isso também significa que o prefixo da cidade pode ser diferente do da sua própria cidade; isso não afeta o funcionamento do seu WhatsApp.

Passo 2: Conectar o número à Meta #

Um número comprado ainda precisa ser ativado com a Meta antes que possa enviar e receber:

1. Na página Channels, o cartão da API do WhatsApp Business mostra seu novo número na lista.
2. Clique na ação de conexão do próprio número (Finish setup ou Concluir configuração) — um pop-up da Meta será aberto, onde você concluirá a conexão com a conta da Meta que possui sua Conta do WhatsApp Business, seguindo as instruções da Meta.
3. Quando a Meta confirmar a conexão, o número entrará em funcionamento automaticamente — não há uma etapa separada de “anunciar”. Seu status mudará para Active (Ativo) por conta própria assim que a conexão estiver online.

Você será solicitado a fazer login na sua conta Meta Business e conceder à plataforma permissão para enviar e receber mensagens do WhatsApp em seu nome.

A ativação geralmente é automática. Leva alguns minutos e, na maioria dos casos, você não precisará de uma chamada ou código de verificação. Ocasionalmente, a Meta mantém o número como “Pendente”; se isso acontecer, siga as instruções na tela para verificar por chamada telefônica. Se um número falhar repetidamente ao registrar, o WhatsApp pode estar limitando a taxa temporariamente — aguarde 24 horas e tente novamente, ou entre em contato com o suporte.

Já possui seu próprio número da Meta Cloud API? #

Você não precisa comprar através da plataforma. No cartão da API do WhatsApp Business, clique em Connect WhatsApp, escolha Use a number you already have (Usar um número que você já possui), depois Managed by us (Gerenciado por nós) para abrir o modal Connect WhatsApp Business API:

1. Insira o número de telefone do número, no formato internacional (por exemplo, +1 555 123 4567).
2. Opcionalmente, digite um nome de exibição — o nome mostrado para as pessoas com quem você fala no WhatsApp.
3. Clique em Continuar para o WhatsApp para finalizar a conexão na própria janela da Meta.

Recomendamos fortemente NÃO conectar seu número ativo e pessoal do WhatsApp Business — conectá-lo aqui pode interromper o uso do seu aplicativo WhatsApp existente. Use um número novo.

Na janela da Meta, adicione e verifique seu próprio número. Não escolha o número de teste gratuito da Meta (ele começa com +1 555) — ele só pode enviar mensagens para um punhado de contatos de teste que você adicionar manualmente, portanto, nunca poderá alcançar clientes reais. Se você inserir ou selecionar o número de teste da Meta, a conexão será rejeitada.

Movendo um número que está atualmente no aplicativo WhatsApp #

Um número que está ativamente registrado no aplicativo WhatsApp ou WhatsApp Business não pode ser conectado à API — você precisa liberá-lo do aplicativo primeiro. Siga esta ordem:

1. Salve tudo o que você precisa do aplicativo primeiro. O histórico de conversas não é transferido para a API, e a exclusão da conta é permanente — exporte ou faça backup de conversas importantes antes de continuar.
2. Desative a verificação em duas etapas no aplicativo (Configurações → Conta → Confirmação em duas etapas), para que o PIN antigo não interfira no registro da API.
3. Exclua a conta no aplicativo: Configurações → Conta → Apagar minha conta. Isso libera o número — um número só pode estar no aplicativo ou na API, nunca em ambos ao mesmo tempo.
4. Aguarde alguns minutos para que a liberação seja processada e, em seguida, siga as etapas de conexão acima para conectar o número.

Quer sua própria Conta do WhatsApp Business sem a configuração de desenvolvedor? #

Through our Meta app (Através do nosso aplicativo Meta) é outra resposta para a segunda pergunta do mesmo botão Connect WhatsApp. Você mantém sua própria Conta do WhatsApp Business, mas não cria nada no site de desenvolvedores da Meta — você usa nosso aplicativo Meta. A Meta cobra as conversas diretamente na sua própria Conta do WhatsApp Business. Se você trouxer seu próprio número: 50 créditos por mês nossos pela conexão. Se você alugar seu número aqui: nada extra, pois o aluguel do número já cobre a conexão. Veja Conectar através do nosso aplicativo Meta.

Prefere executar o WhatsApp no seu próprio aplicativo da Meta? #

Existe uma opção adicional para usuários técnicos e agências: criar seu próprio aplicativo no site de desenvolvedor da Meta e conectá-lo diretamente. A Meta cobra você pelas tarifas deles, não há taxas por mensagem da nossa parte, e seus clientes veem apenas o nome da sua empresa. O passo a passo completo está em Conectar Seu Próprio Aplicativo Meta.

Em qualquer conexão que utilize sua própria Conta do WhatsApp Business, a Meta cobra as mensagens — não nós. Isso inclui conectar seu próprio número como Managed by us acima, Through our Meta app, e seu próprio aplicativo Meta. A Meta cobra o método de pagamento vinculado a essa Conta do WhatsApp Business e, se não houver um método válido, a Meta bloqueará transmissões, campanhas e mensagens de modelo até que você adicione um. Leia Custos do WhatsApp e a mudança de outubro de 2026 antes do seu primeiro envio — ele também aborda a mudança de preços que ocorrerá em 1º de outubro de 2026.

Problemas comuns na conexão #

Alguns problemas atrapalham a maioria dos novos usuários durante o fluxo de conexão com a Meta. Leia isto antes de iniciar a ativação.

Escolha seu próprio número, não o número de teste da Meta #

Durante o fluxo de conexão com a Meta, a Meta oferecerá um número de telefone de teste (um número de exemplo na faixa +1 555) junto com a opção de usar o seu próprio número. Sempre use o seu próprio número. O número de teste da Meta pode receber mensagens, mas só pode enviar para um punhado de números que você adiciona manualmente dentro da Meta, portanto, ele nunca enviará mensagens para clientes reais — cada resposta falha silenciosamente ao ser enviada. O aplicativo bloqueia isso: se você inserir ou selecionar o número de teste da Meta, a conexão será rejeitada e você será solicitado a usar um número real.

Seu número precisa estar dentro da Conta do WhatsApp Business #

Este é o motivo mais comum para uma conexão falhar logo na última etapa. Escolher o número de teste da Meta ou pular a etapa do número de telefone deixa a Conta do WhatsApp Business que você selecionou sem o seu número nela — e, portanto, não há nada para nós conectarmos.

Na etapa do número de telefone na janela da Meta:

1. Escolha adicionar um novo número.
2. Insira seu número.
3. Verifique-o com o código que a Meta enviar por SMS ou chamada.

Quando feito corretamente, seu número aparece em Números de telefone nessa conta no Gerenciador do WhatsApp, marcado como verificado. Se a conexão falhar, o aplicativo informará exatamente qual desses problemas ocorreu.

Se falhar, não exclua nem recrie as coisas #

Quando uma conexão falha, é tentador excluir a Conta do WhatsApp Business e começar tudo de novo. Não faça isso. Excluir uma conta à qual seu número está vinculado geralmente torna o problema mais difícil de resolver, e tentativas repetidas de conexão podem fazer com que um número seja temporariamente bloqueado pelo WhatsApp — o que pode se tornar permanente. Leia a mensagem de erro: ela nomeia o problema específico e a próxima etapa. Se ainda assim não conectar, entre em contato com o suporte informando o número de telefone e o erro.

Cada conta precisa da sua própria Conta do WhatsApp Business #

Uma Conta do WhatsApp Business só pode ser vinculada a uma conta de mensagens por vez, portanto, você não pode conectar um segundo número através da mesma Conta do WhatsApp Business a partir de uma conta diferente aqui — na maioria das vezes, uma agência e uma de suas subcontas, ou duas subcontas, todas apontando para a mesma Conta Comercial. A Meta ainda mostra a conexão como bem-sucedida, porque o número realmente está verificado e ativo nessa Conta Comercial, mas a ativação para aqui com uma mensagem nomeando a conta que já a utiliza.

Duas formas de prosseguir:

• Conecte o número na conta que já utiliza essa Conta do WhatsApp Business. Adicionar mais números a ela lá funciona normalmente.
• Dê a esta conta sua própria Conta do WhatsApp Business. Inicie a conexão novamente e escolha criar uma nova Conta do WhatsApp Business em vez de selecionar a existente. Primeiro, remova o número da antiga Conta Comercial no Meta Business Manager, já que um número só pode pertencer a uma delas.

Não exclua a Conta do WhatsApp Business existente para liberá-la — o número que já está em execução nela pararia de funcionar.

Não reutilize uma Conta do WhatsApp Business já vinculada a outro BSP #

Se a sua Conta do WhatsApp Business (WABA) já estiver vinculada a outro BSP (Provedor de Serviços de Negócios — outra plataforma que se conectou a ela anteriormente), a conexão aqui falhará e não poderá ser corrigida tentando novamente; a ativação para com uma mensagem dizendo que a Conta Comercial já está vinculada a outro lugar. Para evitar isso, crie uma nova Conta do WhatsApp Business no Meta Business Manager para esta conexão, em vez de reutilizar uma que tenha sido conectada em outro lugar.

Passo 3: Configure seu Perfil do WhatsApp Business #

Seu perfil do WhatsApp Business é o que os clientes veem quando interagem com sua empresa.

1. Na página Canais, encontre seu número ativo no WhatsApp e abra o editor de perfil dele.
2. Preencha:

3. Salve para atualizar seu perfil.

Um Agente por Número #

Se a sua conta tiver mais de um número da API do WhatsApp Business, cada um pode ser atendido por um Agente de IA diferente. O painel Quem responde a novas conversas na página de Agentes de IA mostra um bloco por número para o WhatsApp com um seletor para cada número conectado: O mesmo que o WhatsApp segue o Agente do canal; escolher outro Agente (ou Ninguém responde) aplica-se apenas a esse número. As respostas são sempre enviadas a partir do número para o qual o cliente enviou a mensagem. Detalhes: Pontos de Entrada → Um Agente por número do WhatsApp.

Entendendo os Limites de Mensagens #

O WhatsApp impõe limites de mensagens para proteger os usuários contra spam. Esses limites determinam com quantos contatos únicos você pode falar dentro de uma janela contínua de 24 horas.

Sistema de Níveis #

Como Aumentar Seus Limites #

• Verifique sua empresa no Gerenciador de Negócios da Meta para ultrapassar o limite inicial de 250 contatos e chegar a 2.000.
• Mantenha uma alta qualidade de mensagens — evite ser denunciado ou bloqueado pelos destinatários.
• Envie mensagens de forma consistente — o WhatsApp aumenta automaticamente seu nível quando você atinge aproximadamente metade do seu limite atual com boas classificações de qualidade, geralmente dentro de 6 horas após cumprir os critérios.

Tipos de Mensagem #

Mensagens de Sessão (Formato livre) #

Texto comum, imagens, vídeos, documentos e outras mídias que você pode enviar dentro de uma janela de conversa ativa.

• Pode incluir qualquer conteúdo
• Só pode ser enviado dentro da janela de mensagens de 24 horas (veja abaixo)
• Não é necessária pré-aprovação

Mensagens de Modelo #

Formatos de mensagem pré-aprovados que permitem iniciar conversas com clientes fora da janela de 24 horas.

• Devem ser enviadas à Meta para aprovação antes do uso
• Suportam variáveis para personalização (por exemplo, nome do cliente, número do pedido)
• Necessárias para iniciar novas conversas ou reengajar após 24 horas
• Disponíveis em vários idiomas

Os modelos agora possuem sua própria página — veja Modelos de Mensagem do WhatsApp para o passo a passo completo.

A Janela de Mensagens de 24 Horas #

O WhatsApp impõe uma janela de conversa de 24 horas para proteger os usuários:

• Quando um cliente envia uma mensagem para você, uma janela de 24 horas é aberta. Durante essa janela, você pode enviar qualquer tipo de mensagem (mensagens de sessão) livremente.
• Após 24 horas de inatividade (sem mensagens do cliente), a janela é fechada. Você só pode retomar o contato usando uma mensagem de modelo aprovada.
• Quando você envia uma mensagem de modelo, uma nova janela de 24 horas é aberta assim que o cliente responde.

As respostas dentro desta janela deixarão de ser gratuitas em 1º de outubro de 2026. A Meta anunciou que, a partir dessa data, cobrará pelas respostas de formato livre que uma empresa envia dentro da janela de 24 horas, por mensagem, de acordo com a tarifa de cada mercado — a mesma tarifa que os modelos de utilidade e autenticação já custam. Elas eram gratuitas desde novembro de 2024. Cada número de telefone recebe primeiro 1.000 mensagens de serviço gratuitas por mês, e apenas a 1.001ª em diante é cobrada; a tarifa é a tarifa de utilidade do mercado, que já consta na tabela de preços da Meta. O que isso significa para você e o que verificar antes dessa data está em Custos do WhatsApp e a Mudança de Outubro de 2026.

Testando sua configuração #

Antes de entrar em operação com os clientes, verifique se tudo funciona:

1. Envie uma mensagem de teste. Abra o Agente de IA ou Broadcast atribuído a este número e use seu painel Experimentar para enviar uma mensagem de teste para si mesmo, ou envie diretamente de Chats.
2. Teste mensagens recebidas. Envie uma mensagem do WhatsApp do seu telefone pessoal para o seu número comercial e confirme se ela aparece em Chats.
3. Teste as respostas da IA. Confirme se o Agente responde dentro do prazo esperado e se suas respostas estão alinhadas com suas instruções e Base de Conhecimento.
4. Teste mensagens de modelo. Crie e aprove um modelo simples, envie-o para o seu número de teste e confirme se ele chega com todas as variáveis preenchidas.

Solução de problemas #

O número não aparece como ativo #

• Certifique-se de ter concluído o processo completo de ativação, incluindo o login na sua conta Meta Business e a concessão de permissões.
• Verifique se sua conta Meta Business está em boa situação.
• Aguarde alguns minutos e atualize a página — a ativação pode levar algum tempo.

Mensagens não estão sendo enviadas #

• Verifique se você tem créditos suficientes em sua conta.
• Verifique se você atingiu seu limite de mensagens.
• Certifique-se de que o número de telefone do destinatário esteja no formato internacional correto (por exemplo, +1234567890).
• Se estiver enviando fora da janela de 24 horas, certifique-se de estar usando um modelo aprovado.

Transmissões e Modelos Bloqueados, mas Respostas Ainda Funcionam #

Este padrão — você pode responder às pessoas que enviam mensagens primeiro, mas nada que você inicia é enviado — quase sempre significa que a conta do WhatsApp Business por trás do número não possui um método de pagamento válido, e isso se aplica apenas a conexões que operam na sua própria conta do WhatsApp Business. A Meta bloqueia conversas iniciadas pela empresa (transmissões, campanhas, qualquer modelo) até que um método de pagamento válido esteja na conta, e relata o erro no Gerenciador do WhatsApp.

O aplicativo agora interrompe uma transmissão ou campanha antes do envio nessa situação e solicita que você adicione um método de pagamento, em vez de deixar que cada mensagem falhe. Adicione ou corrija o método de pagamento no Gerenciador do WhatsApp e envie novamente — reconectar o número aqui não resolverá o problema. Veja Custos do WhatsApp e a Mudança de Outubro de 2026.

Modelo rejeitado #

• Revise as diretrizes de modelos da Meta — modelos não podem conter conteúdo promocional em certas categorias.
• Verifique problemas de formatação, como espaços reservados (placeholders) incorretos.
• Leia o motivo da rejeição fornecido pela Meta, revise e envie novamente — veja Modelos de Mensagem do WhatsApp.

Classificação de qualidade de mensagem baixa #

• Revise o conteúdo da sua mensagem quanto à relevância e valor para os destinatários.
• Evite enviar mensagens para contatos que não optaram por recebê-las.
• Reduza a frequência de mensagens se os destinatários estiverem denunciando ou bloqueando você.

Erro “Número de telefone não encontrado” #

• O número de telefone pode não estar vinculado corretamente à sua Conta Meta Business.
• Tente reativar o número de telefone através do fluxo de conexão do WhatsApp.
• Entre em contato com o suporte se o problema persistir.

Melhores práticas #

• Sempre obtenha consentimento antes de enviar mensagens aos clientes no WhatsApp.
• Responda rapidamente às mensagens dos clientes para aproveitar ao máximo a janela de 24 horas.
• Mantenha os modelos concisos e valiosos — modelos de alta qualidade são aprovados mais rapidamente e têm melhor desempenho.
• Monitore sua classificação de qualidade no Gerenciador de Negócios da Meta para evitar rebaixamentos de nível.
• Deixe um Agente de IA lidar com as respostas para garantir capacidade de resposta 24/7 dentro da janela de mensagens — veja Agentes de IA.