API do WhatsApp Business #

Ligue a sua empresa ao WhatsApp através da API oficial do WhatsApp Business. Este canal é a escolha recomendada para empresas que necessitam de mensagens de WhatsApp fiáveis e de alto volume, com modelos de mensagem pré-aprovados e rastreio de entrega.

Não é necessária uma conta Twilio separada. O Twilio é o serviço de telefone e mensagens que entrega as suas mensagens de WhatsApp nos bastidores. A plataforma cria uma conta Twilio gerida para si automaticamente, pelo que não precisa de se registar no Twilio ou ligá-lo à Meta manualmente. A compra de um número ou a ligação de um número existente acontece inteiramente dentro da aplicação. Se precisar especificamente de utilizar a sua própria conta Twilio (por exemplo, se já tiver números ativos e modelos aprovados lá), abra o cartão Conta Twilio na página Canais e mude para a sua própria conta, depois associe o seu remetente existente — ambos os passos estão em Fornecedor de SMS (Trazer o seu próprio Twilio). A maioria dos utilizadores deve manter a configuração gerida.

Pré-requisitos #

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

• Uma Meta Business account (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 contactos únicos por 24 horas (consulte Limites de Mensagens abaixo)
• Uma conta com créditos suficientes
• Um número de telefone que não esteja já registado no WhatsApp (aplicação pessoal ou Business), e que não seja já um número Twilio de outra conta

Adicione primeiro o nome e a morada da sua empresa. Antes de poder comprar o seu primeiro número, preencha o nome e a morada da sua empresa em Settings → Business (grupo Workspace). A operadora valida esta morada, por isso certifique-se de que está correta e completa — a compra não será efetuada até que esteja definida.

Passo 1: Comprar um Número de Telefone #

1. Na barra lateral esquerda, clique em Settings (Definições) perto da 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 (Ligar WhatsApp).
4. Escolha Get a new number from us (Obter um novo número através de nós), depois Managed by us (Gerido por nós).

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

5. Navegue pela lista de números disponíveis que aparece, cada um com o seu custo de compra único e custo mensal apresentados ao lado.

6. Clique num número e preencha o seu Nome a apresentar — o nome da empresa que as pessoas veem no WhatsApp. Deve conter letras; um número de telefone isolado será rejeitado. Em seguida, confirme o custo apresentado e conclua a compra.

Um número adquirido aqui destina-se ao WhatsApp, não a SMS. Os números comprados através da plataforma são utilizados para o WhatsApp Business. Não são números de SMS, nem são números de chamadas: uma chamada recebida chega a um gravador automático (que serve para atender a chamada de verificação do WhatsApp durante a configuração), não existe uma caixa de correio de voz para ouvir mensagens e não é possível efetuar chamadas a partir do número. O serviço de SMS funciona na sua própria conta Twilio — consulte SMS. Não diga aos clientes que um número comprado pode fazer ambas as coisas; não pode.

Os créditos são deduzidos da sua conta pela compra. Cada número tem então uma renda mensal para o manter ativo: pelo menos 50 créditos por mês, sendo que os números premium custam mais, de acordo com o que a operadora cobra. O cartão do número em Definições → Canais mostra sempre o seu preço mensal exato, e a caixa de diálogo de compra mostra-o antes de confirmar.

Essa renda é a única taxa mensal do número — inclui a ligação ao WhatsApp, por isso não há nada extra a pagar para manter o número no WhatsApp. Se já aluga números aqui, estes passam para esta tarifa no seu próximo ciclo de faturação. Consulte Números de Telefone.

México e Argentina: apenas números de telemóvel são disponibilizados para estes países. O WhatsApp trata os números nestes locais como números de telemóvel e apenas um número de telemóvel pode receber o código de verificação do WhatsApp — números de rede fixa não o podem fazer, pelo que não são listados. Isto 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: Ligar o número à Meta #

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

1. Na página Channels, o cartão WhatsApp Business API mostra o seu novo número na lista.
2. Clique na ação de ligação do próprio número (Finish setup / Concluir configuração) — abre-se uma janela pop-up da Meta onde conclui a ligação com a conta Meta que detém a sua Conta WhatsApp Business, seguindo as instruções da Meta.
3. Quando a Meta confirmar a ligação, o número fica ativo automaticamente — não existe um passo separado de “anunciar”. O seu estado muda para Active (Ativo) por si só assim que a ligação estiver online.

Ser-lhe-á pedido que inicie sessão na sua conta Meta Business e que conceda à plataforma permissão para enviar e receber mensagens de WhatsApp em seu nome.

A ativação é geralmente automática. Demora alguns minutos e, na maioria dos casos, não precisará de uma chamada ou código de verificação. Ocasionalmente, a Meta mantém o número como “Pending”; se isso acontecer, siga a instrução no ecrã para verificar por chamada telefónica. Se um número falhar repetidamente o registo, o WhatsApp pode estar a limitar a sua taxa temporariamente — aguarde 24 horas e tente novamente, ou contacte o suporte.

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

Não tem de comprar através da plataforma. No cartão WhatsApp Business API, clique em Connect WhatsApp, escolha Use a number you already have (Utilizar um número que já possui), depois Managed by us (Gerido por nós) para abrir o modal Connect WhatsApp Business API:

1. Introduza o número de telefone, no formato internacional (por exemplo, +1 555 123 4567).
2. Opcionalmente, escreva um nome de apresentação — o nome mostrado às pessoas a quem envia mensagens no WhatsApp.
3. Clique em Continuar para o WhatsApp para concluir a ligação na janela da própria Meta.

Recomendamos vivamente que NÃO ligue o seu número pessoal ativo do WhatsApp Business — ligá-lo aqui pode interromper a sua aplicação WhatsApp existente. Utilize um número novo.

Na janela da Meta, adicione e verifique o seu próprio número. Não escolha o número de teste gratuito da Meta (começa por +1 555) — este só pode enviar mensagens a um pequeno grupo de contactos de teste que adicione manualmente, pelo que nunca chegará a clientes reais. Se introduzir ou selecionar o número de teste da Meta, a ligação será rejeitada.

Mover um número que está atualmente na aplicação WhatsApp #

Um número que esteja ativamente registado na aplicação WhatsApp ou WhatsApp Business não pode ser ligado à API — tem de o libertar primeiro da aplicação. Siga esta ordem:

1. Guarde primeiro tudo o que precisar da aplicação. O histórico de conversas não é transferido para a API e a eliminação da conta é permanente — exporte ou faça cópias de segurança de conversas importantes antes de continuar.
2. Desative a verificação em duas etapas na aplicação (Definições → Conta → Verificação em duas etapas), para que o PIN antigo não interfira com o registo na API.
3. Elimine a conta na aplicação: Definições → Conta → Eliminar a minha conta. Isto liberta o número — um número só pode estar na aplicação ou na API, nunca em ambos ao mesmo tempo.
4. Aguarde alguns minutos para que a libertação seja processada e, em seguida, siga os passos de ligação acima para ligar o número.

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

Through our Meta app (Através da nossa aplicação Meta) é outra resposta à segunda pergunta do mesmo botão Connect WhatsApp. Mantém a sua própria Conta WhatsApp Business, mas não cria nada no site de programadores da Meta — utiliza a nossa aplicação Meta. A Meta fatura as conversas diretamente à sua própria Conta WhatsApp Business. Se trouxer o seu próprio número: 50 créditos por mês da nossa parte pela ligação. Se alugar o seu número aqui: nada extra, porque o aluguer do número já cobre a ligação. Consulte Connect Through Our Meta App.

Prefere executar o WhatsApp na sua própria aplicação Meta? #

Existe uma opção adicional para utilizadores técnicos e agências: criar a sua própria aplicação no site de programadores da Meta e ligá-la diretamente. A Meta fatura-o de acordo com as suas próprias tarifas, não existem taxas por mensagem da nossa parte, e os seus clientes apenas veem o nome da sua empresa. O guia completo encontra-se em Ligar a sua própria aplicação Meta.

Em qualquer ligação que utilize a sua própria Conta WhatsApp Business, a Meta fatura as mensagens — não nós. Isto inclui ligar o seu próprio número Managed by us (Gerido por nós) acima, Through our Meta app (Através da nossa aplicação Meta) e a sua própria aplicação Meta. A Meta cobra ao método de pagamento associado a essa Conta WhatsApp Business e, se não houver um válido, a Meta bloqueia transmissões, campanhas e mensagens de modelo até que adicione um. Leia WhatsApp Costs & the October 2026 Change antes do seu primeiro envio — também abrange a alteração de preços que entrará em vigor a 1 de outubro de 2026.

Problemas comuns na ligação #

Alguns problemas dificultam a vida da maioria dos novos utilizadores durante o fluxo de ligação à Meta. Leia isto antes de iniciar a ativação.

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

Durante o fluxo de ligação da Meta, a Meta oferecer-lhe-á um número de telefone de teste (um número de exemplo na gama +1 555) juntamente com a opção de utilizar o seu próprio número. Utilize sempre 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 adicione manualmente dentro da Meta, pelo que nunca enviará mensagens a clientes reais — todas as respostas falham silenciosamente ao serem enviadas. A aplicação bloqueia isto: se introduzir ou selecionar o número de teste da Meta, a ligação é rejeitada e ser-lhe-á pedido que utilize um número real.

O seu número tem de ficar dentro da Conta WhatsApp Business #

Este é o motivo mais comum para uma ligação falhar logo no último passo. Escolher o número de teste da Meta, ou avançar sem configurar o passo do número de telefone, deixa a Conta WhatsApp Business que selecionou sem o seu número nela — e, nesse caso, não haverá nada para nós ligarmos.

No passo do número de telefone na janela da Meta:

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

Quando feito corretamente, o seu número aparece em Números de telefone nessa conta no WhatsApp Manager, marcado como verificado. Se a ligação falhar, a aplicação indica-lhe exatamente qual destes problemas ocorreu.

Se falhar, não elimine nem recrie nada #

Quando uma ligação falha, é tentador eliminar a Conta WhatsApp Business e começar de novo. Não o faça. Eliminar uma conta à qual o seu número está associado torna, geralmente, o problema mais difícil de resolver, e tentativas de ligação repetidas podem levar a que um número seja temporariamente bloqueado pelo WhatsApp — o que pode tornar-se permanente. Leia a mensagem de erro: ela indica o problema específico e o passo seguinte. Se continuar a não ligar, contacte o suporte com o número de telefone e o erro.

Cada conta necessita da sua própria Conta WhatsApp Business #

Uma Conta WhatsApp Business só pode ser associada a uma conta de mensagens de cada vez, pelo que não pode ligar um segundo número através da mesma Conta WhatsApp Business a partir de uma conta diferente aqui — o que acontece frequentemente com uma agência e uma das suas subcontas, ou duas subcontas, todas a apontar para a mesma Conta Business. A Meta continua a mostrar a ligação como bem-sucedida, porque o número está realmente verificado e ativo nessa Conta Business, mas a ativação para aqui com uma mensagem que indica a conta que já o utiliza.

Duas formas de avançar:

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

Não elimine a Conta WhatsApp Business existente para a libertar — o número que já está a funcionar nela deixaria de funcionar.

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

Se a sua Conta WhatsApp Business (WABA) já estiver ligada a outro BSP (Business Service Provider — outra plataforma que se ligou a ela anteriormente), a ligação aqui falhará e não poderá ser corrigida tentando novamente; a ativação para com uma mensagem a dizer que a Conta Business já está ligada noutro local. Para evitar isto, crie uma nova Conta WhatsApp Business no Meta Business Manager para esta ligação, em vez de reutilizar uma que tenha sido configurada noutro local.

Passo 3: Configure o seu Perfil WhatsApp Business #

O seu perfil WhatsApp Business é o que os clientes veem quando interagem com a sua empresa.

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

3. Guarde para atualizar o seu perfil.

Um Agente por Número #

Se a sua conta tiver mais do que um número da API do WhatsApp Business, cada um pode ser respondido 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 por cada número ligado: 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 de WhatsApp.

Compreender os Limites de Mensagens #

O WhatsApp impõe limites de mensagens para proteger os utilizadores contra spam. Estes limites determinam quantos contactos únicos pode contactar dentro de uma janela contínua de 24 horas.

Sistema de Níveis #

Como Aumentar os Seus Limites #

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

Tipos de Mensagens #

Mensagens de Sessão (Formato Livre) #

Texto normal, imagens, vídeos, documentos e outros meios que pode enviar dentro de uma janela de conversação ativa.

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

Mensagens de Modelo #

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

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

Os modelos têm agora a sua própria página — consulte Modelos de Mensagem do WhatsApp para o guia completo.

A Janela de Mensagens de 24 Horas #

O WhatsApp impõe uma janela de conversação de 24 horas para proteger os utilizadores:

• Quando um cliente lhe envia uma mensagem, abre-se uma janela de 24 horas. Durante esta janela, pode enviar livremente qualquer tipo de mensagem (mensagens de sessão).
• Após 24 horas de inatividade (sem mensagem do cliente), a janela fecha-se. Só pode voltar a interagir utilizando uma mensagem de modelo aprovada.
• Quando envia uma mensagem de modelo, abre-se uma nova janela de 24 horas assim que o cliente responde.

As respostas dentro desta janela deixarão de ser gratuitas a 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, à taxa de cada mercado — a mesma taxa que os modelos de utilidade e autenticação já custam. Têm sido 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 taxa é a taxa de utilidade do mercado, que já consta na tabela de preços da Meta. O que isto significa para si, e o que deve verificar antes dessa data, encontra-se em Custos do WhatsApp e a Alteração de outubro de 2026.

Testar a sua Configuração #

Antes de começar a interagir com os clientes, verifique se tudo funciona:

1. Envie uma mensagem de teste. Abra o Agente de IA ou a Difusão atribuída a este número e utilize o painel Experimentar para enviar uma mensagem de teste para si próprio, ou envie diretamente a partir de Conversas.
2. Teste as mensagens recebidas. Envie uma mensagem de WhatsApp do seu telemóvel pessoal para o seu número profissional e confirme que aparece em Conversas.
3. Teste as respostas da IA. Confirme que o Agente responde dentro do prazo esperado e que as suas respostas estão alinhadas com as suas instruções e Base de Conhecimento.
4. Teste as mensagens de modelo. Crie e aprove um modelo simples, envie-o para o seu número de teste e confirme que chega com todas as variáveis preenchidas.

Resolução de Problemas #

O número não aparece como ativo #

• Certifique-se de que concluiu o processo de ativação completo, incluindo iniciar sessão na sua conta Meta Business e conceder permissões.
• Verifique se a sua conta Meta Business está em boa situação.
• Aguarde alguns minutos e atualize a página — a ativação pode demorar algum tempo.

As mensagens não são enviadas #

• Verifique se tem créditos suficientes na sua conta.
• Verifique se atingiu o seu limite de mensagens.
• Certifique-se de que o número de telemóvel do destinatário está no formato internacional correto (por exemplo, +1234567890).
• Se estiver a enviar mensagens fora da janela de 24 horas, certifique-se de que está a utilizar um modelo aprovado.

Transmissões e Modelos Bloqueados, mas as Respostas Continuam a Funcionar #

Este padrão — pode responder a pessoas que lhe enviam mensagens primeiro, mas nada do que inicia é enviado — significa quase sempre que a conta WhatsApp Business associada ao número não tem um método de pagamento funcional, e aplica-se apenas a ligações que funcionam na sua própria conta WhatsApp Business. A Meta bloqueia conversas iniciadas pela empresa (transmissões, campanhas, qualquer modelo) até que exista um método de pagamento válido na conta, e reporta o erro no WhatsApp Manager.

A aplicação agora interrompe uma transmissão ou campanha antes de a enviar nesta situação e solicita que adicione um método de pagamento, em vez de deixar que cada mensagem falhe. Adicione ou corrija o método de pagamento no WhatsApp Manager e tente enviar novamente — voltar a ligar o número aqui não resolverá o problema. Consulte Custos do WhatsApp e a Alteração de Outubro de 2026.

Modelo rejeitado #

• Reveja as diretrizes de modelos da Meta — os modelos não podem conter conteúdo promocional em determinadas categorias.
• Verifique se existem problemas de formatação, como marcadores de posição incorretos.
• Leia o motivo da rejeição fornecido pela Meta, reveja e submeta novamente — consulte Modelos de Mensagem do WhatsApp.

Classificação de qualidade de mensagem baixa #

• Reveja o conteúdo da sua mensagem quanto à relevância e valor para os destinatários.
• Evite enviar mensagens a contactos que não deram o seu consentimento.
• Reduza a frequência das mensagens se os destinatários estiverem a denunciá-lo ou a bloqueá-lo.

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

• O número de telefone pode não estar corretamente associado à sua Conta Meta Business.
• Tente reativar o número de telefone através do fluxo de ligação do WhatsApp.
• Contacte o suporte se o problema persistir.

Melhores práticas #

• Obtenha sempre consentimento antes de enviar mensagens a clientes no WhatsApp.
• Responda rapidamente às mensagens dos clientes para tirar o máximo partido da janela de 24 horas.
• Mantenha os modelos concisos e valiosos — modelos de alta qualidade são aprovados mais rapidamente e têm melhor desempenho.
• Monitorize a sua classificação de qualidade no Meta Business Manager para evitar descidas de nível.
• Deixe um Agente de IA tratar das respostas para garantir uma capacidade de resposta 24/7 dentro da janela de mensagens — consulte Agentes de IA.