Your AI Connector Docs

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 conta Meta Business (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). Também é necessária para a opção Gerido por nós: essa opção fornece o número e processa as mensagens, mas o número continua a pertencer à sua própria Conta WhatsApp Business, pelo que deve concluir a configuração numa janela pop-up da Meta. A única forma de ligar o WhatsApp sem qualquer conta Meta é através do WhatsApp Web.
  • 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 empresa em Definições → Empresa (grupo Workspace). A operadora valida esta morada, por isso certifique-se de que é precisa e completa — a compra falhará até que esta seja definida. Alguns países apenas aceitam uma morada de rua dentro do próprio país: quando o país do número exige uma, o país da morada é fixado a esse (por exemplo, um número do Luxemburgo necessita de uma morada no Luxemburgo), e um número do seu próprio país é a forma de utilizar a sua própria morada.

Nota: O número de telefone que utiliza para a API do WhatsApp Business não pode ser utilizado simultaneamente com a aplicação WhatsApp normal. Se pretende continuar a utilizar o seu WhatsApp pessoal, adquira um novo número através da plataforma ou utilize o WhatsApp Web, que lhe permite ligar o seu número existente emparelhando o seu telemóvel sem o remover da aplicação normal. Estes são dois caminhos distintos: um número que compra aqui é um número virtual sem um telefone associado, pelo que só pode ser utilizado na API Business — nunca poderá ser emparelhado com o WhatsApp Web.


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).
  1. 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.
  1. 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.
  1. Clique num número e preencha o respetivo Nome a apresentar — o nome comercial que as pessoas veem no WhatsApp. Deve conter letras e ser o nome da sua empresa ou marca; o WhatsApp rejeita números de telefone isolados e qualquer nome que inclua a palavra “WhatsApp”. 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.

Dica: Escolha um número no mesmo país que a maioria dos seus clientes. Isto cria confiança e pode reduzir os custos de envio de mensagens.

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 é normalmente 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 “Pendente”, ou a janela da Meta termina em “A ligação ao WhatsApp não foi concluída”, apesar de a verificação de propriedade ter sido bem-sucedida. Deixe o número como está: é verificado novamente a cada dez minutos e um registo que tenha parado após uma verificação de propriedade bem-sucedida é registado novamente por si automaticamente, normalmente dentro do quarto de hora seguinte. Não elimine o número nem inicie novamente a Configuração final entretanto. Se um número falhar repetidamente o registo, o WhatsApp pode estar a limitar temporariamente a sua taxa — aguarde 24 horas e tente novamente, ou contacte o suporte se ainda estiver Pendente após uma hora. A única exceção é uma Conta WhatsApp Business que a Meta bloqueou: consulte Bloqueado pela Meta abaixo.

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.

Aviso: Eliminar a conta remove as conversas, grupos e cópias de segurança do número no telemóvel. Faça isto apenas quando tiver a certeza de que o número deve passar a residir na API a partir de agora. Se quiser continuar a utilizar o número na aplicação, ligue-o através do WhatsApp Web ou adquira um novo número para a API.

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.

Quem paga as taxas de mensagens depende da forma como o número está ligado. O seu próprio número Gerido por nós envia através da nossa conta de mensagens, pelo que as suas taxas de mensagens são deduzidas dos seus créditos, tal como um número alugado. Através da sua aplicação Meta e da sua própria aplicação Meta, a Meta fatura as mensagens ao método de pagamento associado à sua Conta WhatsApp Business e, se não existir um método válido, a Meta bloqueia as transmissões e as mensagens de modelo até que adicione um. Leia Custos do WhatsApp e a Alteração de outubro de 2026 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.

Twilio nas suas definições de Meta Business

Quando liga um número Gerido por nós, a Meta adiciona a Twilio ao seu negócio Meta como parceiro. Aparece como Twilio nas Definições de Meta Business. A Twilio é o serviço que transporta as suas mensagens de WhatsApp entre o WhatsApp e a Your AI Connector, por isso tem de permanecer lá.

Não remova a Twilio. Se for removida, nada entra ou sai nesse número: as mensagens dos clientes nunca chegam até si e as suas respostas falham. A Your AI Connector deteta isto, marca o número como Offline em Definições → Canais e envia-lhe um e-mail. Para corrigir, volte a ligar o número em Definições → Canais, o que adiciona a Twilio novamente.


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:
Campo Descrição
Fotografia de Perfil O logótipo ou fotografia da sua empresa (recomendado: quadrado, pelo menos 640x640px)
Categoria A categoria que melhor descreve a sua empresa (por exemplo, Restaurante, Retalho, Saúde) — obrigatório
Descrição Uma descrição da sua empresa
Sobre Uma breve linha sobre a sua empresa
E-mail O e-mail de contacto da sua empresa
Website O URL do website da sua empresa
Endereço O endereço da sua empresa
  1. Guarde para atualizar o seu perfil.

Dica: Preencha todos os campos do perfil. Os clientes estão mais propensos a interagir com empresas que tenham um perfil profissional e totalmente preenchido.


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 Agentes de IA mostra um bloco por número para o WhatsApp com um seletor para 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, independentemente da forma como cada número está ligado: um número gerido, um na nossa aplicação Meta e outro na sua própria aplicação Meta podem coexistir na mesma conta, e um novo número apenas transporta as conversas que nele se iniciam. Detalhes: Pontos de entrada → Um Agente por número WhatsApp. Se um cliente escreveu para um número WhatsApp que está na sua empresa Meta, mas não está ligado a esta conta, uma resposta para o mesmo não é enviada a partir de um dos seus outros números (o WhatsApp recusá-la-ia); a mensagem explica o motivo e a ligação desse número permite-lhe responder a partir dele. Os modelos continuam a ser enviados.

O seu número principal

Quando um contacto nunca enviou uma mensagem para nenhum dos seus números, a resposta é enviada a partir do seu número principal. Para o alterar, abra Definições → Canais, encontre o número no cartão da API do WhatsApp Business e clique em Definir como principal. Apenas um número que tenha concluído a ligação ao WhatsApp pode enviar mensagens: um número que ainda apresente Configuração não concluída não pode enviar mensagens e a aplicação utiliza um número ligado em alternativa. Os outros números permanecem na sua conta como números secundários, e um número adquirido é faturado todos os meses, independentemente de a sua configuração estar concluída ou não; por isso, conclua a configuração ou remova-o se não precisar dele.

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.

Nota: Desde outubro de 2025, os limites de mensagens são aplicados ao nível do portefólio empresarial, e não por número de telefone. Todos os números de telefone no seu portefólio partilham o mesmo limite.

Sistema de Níveis

Nível Contactos Únicos por 24 Horas Como Alcançar
Não verificado 250 Predefinido para empresas novas e não verificadas
Verificado 2.000 Conclua a verificação da empresa
Nível 2 10.000 Mantenha uma elevada qualidade de mensagens
Nível 3 100.000 Qualidade elevada e sustentada em escala
Ilimitado Sem limite Histórico de qualidade excecional

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.

Importante: Estes limites aplicam-se apenas a conversas iniciadas pela empresa (mensagens de modelo). As conversas iniciadas pelo cliente, em que o cliente lhe envia uma mensagem primeiro, não contam para o seu limite.


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

Localizações partilhadas

Quando um contacto partilha uma localização (o ícone de clip → Localização no WhatsApp, um alfinete ou um local guardado), a IA recebe-a como texto dentro da conversa: o nome do local e a morada quando o WhatsApp os envia, além das coordenadas, sob a forma [THE CONTACT SHARED A LOCATION] Playa Delfines, Cancún (21.1619, -86.8515). O agente pode citar a morada de volta, raciocinar sobre ela nas suas instruções (“se o contacto estiver fora da nossa área de entrega, informe-o”) ou transmitir a latitude e longitude para uma função personalizada ou webhook como parte da conversa. O mesmo formato é utilizado independentemente de o número estar ligado da forma predefinida (um número nosso), através da nossa aplicação Meta, através da sua própria aplicação Meta ou no WhatsApp Web. As localizações em tempo real (live) chegam uma única vez, com a posição no momento da partilha; a aplicação não segue o alfinete em movimento.

Em Conversas vê-o como um cartão, não como aquela linha de texto: um alfinete com o nome do local e a morada, e uma ligação Abrir no Google Maps que abre o local exato num novo separador. Uma legenda que o contacto escreveu com o mesmo aparece por baixo. A lista de conversas mostra um alfinete e o nome do local como a mensagem mais recente.

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.

Nota: A aprovação de modelos demora normalmente alguns minutos a algumas horas, mas pode demorar até 24 horas em alguns casos.


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.
Cenário O que pode enviar
O cliente acabou de lhe enviar uma mensagem (dentro de 24 horas) Qualquer tipo de mensagem — texto, imagens, documentos, etc.
Mais de 24 horas desde a última mensagem do cliente Apenas mensagens de modelo aprovadas
O cliente respondeu ao seu modelo Qualquer tipo de mensagem (nova janela de 24 horas aberta)

Dica: Um Agente de IA que gere este canal responde automaticamente dentro da janela de 24 horas. Para reativar o contacto após o fecho da janela, configure modelos de seguimento nas definições da sua Difusão ou do Agente — consulte Agentes de IA.

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.

Pendente porque a Meta ainda está a rever uma nova conta WhatsApp Business

Se a janela da Meta criou uma conta WhatsApp Business totalmente nova, a Meta executa a sua própria revisão automática dessa conta antes de permitir que o número fique ativo. Até que a revisão seja aprovada, o número aparece como Pendente na aplicação e no Gestor do WhatsApp. Não há nada a submeter para esta revisão e não existe forma de acelerar o processo a partir da aplicação. Deixe o número como está: a aplicação continua a verificar e o número liga-se automaticamente assim que a Meta aprovar a conta, mesmo que isso demore vários dias. A Verificação da Empresa é um passo separado; aumenta o seu limite de mensagens, mas não é o que esta revisão aguarda.

Bloqueado pela Meta

Por vezes, a Meta bloqueia a Conta WhatsApp Business na qual um número se encontra, por exemplo, enquanto aguarda que conclua a verificação da empresa ou que resolva uma análise. Um número numa conta bloqueada não pode ligar-se: a aplicação mostra-o como Bloqueado pela Meta e, ao passar o rato sobre o emblema, ser-lhe-á indicado o que fazer. Voltar a registar não ajuda neste caso, pelo que a aplicação não o tenta fazer. Abra o Início do Suporte Empresarial no Meta Business Suite, siga os passos da Meta para desbloquear a conta (e conclua a verificação da empresa se a Meta o solicitar) e, em seguida, deixe o número como está. A aplicação continua a verificar e o número liga-se automaticamente assim que a Meta levantar o bloqueio; não é necessário voltar a ligar ou iniciar novamente a Configuração final.

Se preferir não esperar, pode utilizar o número no WhatsApp Web. Elimine primeiro o número em Definições → Canais e, em seguida, elimine-o da conta WhatsApp Business no Gestor do WhatsApp (um número que nunca ficou ativo pode ser removido aí). Depois disso, registe-o na aplicação WhatsApp Business num telemóvel e ligue-o com o código QR. Mudar o número de volta para a API mais tarde significa eliminar novamente a conta na aplicação, conforme descrito em Mudar um número que está atualmente na aplicação WhatsApp.

O número aparece como offline

Um emblema Offline no número em Definições → Canais significa que o próprio WhatsApp impediu o número de enviar mensagens. Passe o rato sobre o emblema para saber o motivo. A causa mais comum é a Meta ter desativado a Conta WhatsApp Business associada ao número, geralmente devido a um problema de política; o emblema indicará isso e encaminhá-lo-á para o Meta Business Manager, onde poderá rever o aviso e apresentar um recurso.

O emblema também fica Offline quando a Twilio é removida do seu negócio Meta (consulte Twilio nas suas definições de Meta Business); para corrigir, volte a ligar o número em Definições → Canais.

Enquanto o número estiver offline, as transmissões a partir dele são retidas em vez de falharem mensagem a mensagem, e as respostas automáticas a partir dele também não podem ser enviadas. Verificamos todos os números ligados através desta configuração no WhatsApp uma vez por dia. Quando um número que estava a funcionar fica offline apenas com um erro geral do WhatsApp (sem motivo relacionado com políticas), essa verificação volta a registá-lo automaticamente e só recebe um e-mail se isso não o recuperar. Por qualquer outro motivo, recebe um e-mail na primeira vez que o número fica offline. Assim que o WhatsApp comunica que o número está novamente online, o emblema volta a ficar verde automaticamente, o mais tardar na verificação diária seguinte. Se o número permanecer offline depois de ter resolvido o problema do lado da Meta, contacte o apoio ao cliente e faremos uma nova verificação por si. As mensagens que não puderam ser enviadas porque o número estava offline não são cobradas.

Número com estado “Não a entregar”

Um emblema Não a entregar no número em Definições → Canais significa que o número continua ligado e as mensagens que lhe enviam continuam a chegar, mas o WhatsApp não está a entregar as mensagens que envia a partir dele. As respostas, incluindo as do seu Agente, permanecem na fila durante horas e depois falham. No Gestor do WhatsApp, isto aparece como um número sem limite de mensagens; as causas habituais são uma restrição ou revisão do número ou da Conta WhatsApp Business, ou a falta de um método de pagamento. Passe o rato sobre o emblema para ver o motivo.

Verifique o número no Gestor do WhatsApp e resolva o que a Meta indicar aí. Enquanto o emblema estiver visível, os envios em massa a partir do número são retidos antes de serem enviados. Verificamos todos os números ligados através desta configuração uma vez por dia e enviamos-lhe um e-mail na primeira vez que isto acontece; assim que o WhatsApp voltar a entregar mensagens a partir do número, o emblema fica verde automaticamente. Numa conversa, uma resposta que ainda esteja à espera de ser enviada após 15 minutos apresenta um relógio âmbar, para que a possa distinguir de uma mensagem que está simplesmente a caminho.

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 válido, 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, 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 antes de a enviar nesta situação e indica-lhe para adicionar 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 envie 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.