Ligue a sua própria aplicação Meta #

Execute o WhatsApp através da sua própria aplicação Meta e pague diretamente à Meta de acordo com as suas próprias tarifas. O Your AI Connector não adiciona taxas por mensagem nesta ligação e não existe qualquer conta Twilio como intermediária. Como a conta de WhatsApp é sua, os seus clientes apenas veem o nome da sua empresa.

Esta é a opção de ligação ao WhatsApp mais técnica — irá criar uma aplicação no site de programadores da Meta e copiar quatro valores para o Your AI Connector. Reserve cerca de 20 minutos. Se isto lhe parece demasiado complexo, a ligação gerida WhatsApp Business continua a ser a forma mais simples de começar.

O que precisa #

• Acesso à sua conta Meta Business Manager.
• Um número de telefone que ainda não esteja a ser utilizado na aplicação WhatsApp.
• Cerca de 20 minutos.

Parte 1 — Configurar a sua aplicação na Meta #

Realize estes passos primeiro no lado da Meta. Irá recolher quatro valores ao longo do processo: um ID da aplicação, um Segredo da aplicação, um Token de acesso e um ID da conta WhatsApp.

1. Criar uma aplicação #

Aceda a developers.facebook.com, abra As minhas aplicações e prima Criar aplicação. Escolha o tipo Empresa e dê-lhe qualquer nome — o nome só é visível para si.

2. Adicionar o WhatsApp à aplicação #

No painel da aplicação, encontre WhatsApp na lista de produtos e prima Configurar. A Meta cria uma conta de teste do WhatsApp com um número de teste gratuito para que possa experimentar antes de ligar um número real.

3. Ativar as permissões do WhatsApp #

Este é o passo que a maioria dos guias ignora, e ignorá-lo é a razão mais comum para a ligação falhar mais tarde.

Na sua aplicação, abra Revisão da aplicação e, em seguida, Permissões e funcionalidades. Procure por whatsapp_business_management. Se disser Sem acesso, prima Obter acesso padrão — a Meta pedir-lhe-á para introduzir novamente a sua palavra-passe e concede-o imediatamente. Não existe período de espera nem revisão da aplicação; é apenas um botão.

whatsapp_business_messaging tem normalmente acesso Padrão. Ambas as permissões precisam de apresentar Acesso padrão antes do passo seguinte, caso contrário, o token que gerar não terá uma delas.

4. Criar um utilizador de sistema #

Nas Definições de Negócio da Meta, abra Utilizadores e, em seguida, Utilizadores de sistema. Adicione um e conceda-lhe acesso de administrador tanto à sua aplicação como à sua conta do WhatsApp.

5. Gerar um token para esse utilizador #

Selecione o utilizador de sistema e prima Gerar token. Escolha a sua aplicação, selecione um token que nunca expira e selecione as opções whatsapp_business_messaging e whatsapp_business_management. A Meta mostra o token apenas uma vez — copie-o imediatamente.

6. Encontrar o ID da sua conta do WhatsApp #

Nas Definições de Negócio, abra Contas, depois Contas do WhatsApp e selecione a sua conta. O número longo por baixo do nome é o ID.

O seu ID da Aplicação e Segredo da aplicação encontram-se nas Definições da aplicação, em Básico. Prima Mostrar junto ao Segredo da aplicação para o revelar.

Parte 2 — Ligue-o no Your AI Connector #

Abra as Definições, depois Canais, encontre o cartão WhatsApp Business API e prima Ligar WhatsApp. Escolha Utilizar um número que já possui, depois A sua própria aplicação Meta. O assistente abre-se numa breve descrição geral — prima Iniciar configuração.

1. Os seus detalhes. Este passo repete os cinco passos do lado da Meta da Parte 1, junto a um formulário para os seus quatro valores. Cole o ID da aplicação, o segredo da aplicação, o token de acesso e o ID da conta de WhatsApp exatamente como a Meta os apresenta, sem espaços extra, e prima Verificar os meus detalhes. Nada é guardado até que funcionem — o Your AI Connector verifica-os primeiro com a Meta.

2. Escolher o número a ligar. O assistente lista todos os números na sua conta do WhatsApp, cada um com a sua própria classificação de qualidade da Meta. Escolha aquele com o qual este espaço de trabalho deve enviar e receber mensagens e prima Ligar este número.

3. Ativação e entrega. O Your AI Connector ativa o número para a Cloud API e regista automaticamente o seu webhook junto da Meta, para que as mensagens recebidas cheguem à sua caixa de entrada — na maioria dos casos, irá parar diretamente ao cartão de ligação com uma confirmação de “Número ligado”. Se o passo automático não puder ser concluído, o assistente mostra o URL de callback e o token de verificação com botões de cópia e guia-o através do processo de os adicionar manualmente na Meta; os mesmos valores permanecem visíveis no cartão de ligação, caso a Meta solicite que os volte a introduzir.
4. O assistente verifica a ligação por si. No último passo, verifica a configuração automaticamente — sem necessidade de esperar. Assim que o cartão indicar que está ligado, envie uma mensagem de WhatsApp para si próprio a partir de outro telemóvel e veja-a chegar às suas conversas: as conversas nesse número fluem agora como em qualquer outro canal e os seus agentes de IA podem responder através dele. Se a verificação detetar algo que a Meta ainda necessite (por exemplo, a verificação do número), o cartão indica-lhe exatamente o que é, e o botão Verificar ligação executa a verificação novamente assim que tiver corrigido o problema.

Pode voltar à mesma página a qualquer momento para verificar o estado da ligação, Reestabelecer ligação com novos detalhes ou premir Desligar — o seu número, a sua conta Meta e a sua faturação continuam a ser seus.

Mudar da ligação gerida #

Pode começar com a ligação WhatsApp Business gerida e mudar para a sua própria aplicação Meta mais tarde. Ambas residem na mesma conta, pelo que não é necessário reconstruir nada.

• Os seus contactos e histórico de conversas permanecem. Os contactos, conversas, etiquetas, agentes e a base de conhecimento pertencem à sua conta, não à ligação. Remover ou substituir um número não elimina nada disto e, quando alguém que lhe escreveu anteriormente envia uma mensagem para o número novamente, esta aparece na mesma conversa.
• O número tem de ser movido primeiro do lado da Meta. O WhatsApp permite que um número resida num único local de cada vez. Peça ao suporte para libertar o número da configuração gerida, adicione-o à sua própria Conta WhatsApp Business no Gestor do WhatsApp e, em seguida, siga os passos nesta página. Espere que o número fique offline durante um curto período de tempo durante a mudança.
• Utilize um número que lhe pertença se planeia mudar. Um número alugado dentro de Your AI Connector é uma linha virtual que pertence à configuração gerida e não pode ser simplesmente transferida para a sua própria aplicação Meta, pelo que mudar significaria um novo número de WhatsApp.
• Os modelos precisam de ser aprovados novamente. A Meta aprova modelos por Conta WhatsApp Business, por isso recrie os que utiliza na sua própria conta (consulte Modelos abaixo).
• Agências: cada subconta liga a sua própria aplicação Meta, pelo que os clientes podem mudar uma de cada vez.

É bom saber #

• A janela de 24 horas aplica-se, tal como em todas as ligações do WhatsApp Business. Pode sempre responder livremente a pessoas que lhe enviaram mensagens nas últimas 24 horas. Fora dessa janela, o WhatsApp apenas permite que as empresas iniciem conversas com um modelo de mensagem aprovado — uma mensagem de texto simples será aceite pela Meta, mas não será entregue.
• A Meta fatura-lhe diretamente as conversas às taxas publicadas pelo país, através do método de pagamento associado à sua conta WhatsApp na Meta. O Your AI Connector não cobra por mensagem nesta ligação; a utilização de IA é faturada em créditos, como habitualmente.
• Mantenha um método de pagamento válido nessa conta WhatsApp. Sem um, a Meta bloqueia todas as conversas que a sua empresa inicia — transmissões e qualquer mensagem de modelo — e apresenta o erro no Gestor do WhatsApp. Nesta ligação, uma transmissão recusa-se a ser iniciada enquanto esse for o caso, e indica-lhe que adicione um método de pagamento em vez de falhar mensagem a mensagem. As respostas a pessoas que lhe enviaram mensagens primeiro continuam a ser enviadas por agora, mas a partir de 1 de outubro de 2026 a Meta também cobrará por essas, pelo que uma conta sem um método de pagamento funcional ficará totalmente inativa nessa data. O panorama completo encontra-se em Custos do WhatsApp e a Alteração de outubro de 2026.
• A sua estimativa de custos parece diferente aqui. Como estas taxas nunca afetam os seus créditos, a estimativa no passo de revisão de uma transmissão mostra a contagem de contactos e a divisão por país com uma nota de que a Meta os fatura na sua Conta WhatsApp Business, em vez de um total de créditos.
• Os números de teste são gratuitos. O número de teste que a Meta fornece a cada nova aplicação pode enviar mensagens até cinco destinatários verificados sem qualquer custo — uma forma prática de experimentar toda a configuração antes de apontar um número real para a mesma.

Modelos #

Os modelos de mensagem funcionam nesta ligação e residem na sua própria conta WhatsApp Business. Crie um na página Modelos e este será criado nessa conta e revisto pela Meta, sendo o resultado aprovado, pendente ou rejeitado apresentado aqui. Os modelos que já possui no Gestor do WhatsApp aparecem na lista automaticamente e um botão Sincronizar da Meta importa tudo o que acabou de alterar lá. O envio funciona como em qualquer outra ligação WhatsApp — escolha um modelo aprovado para iniciar uma conversa ou reabrir uma fora da janela de 24 horas. Os detalhes encontram-se em Utilizar Modelos com a Sua Própria Conta Meta WhatsApp.

Se algo não funcionar #

• “We couldn’t connect with those details” — copie novamente cada valor; um espaço extra é a causa habitual. A mensagem inclui a própria resposta da Meta, que geralmente indica o valor que está incorreto.
• O erro diz que falta o token whatsapp_business_management — a sua aplicação ainda não recebeu essa permissão. Volte à Parte 1, passo 3, prima Get standard access, depois gere um novo token com ambas as permissões selecionadas e verifique novamente os seus dados. Regenerar o token sem esse passo continuará a produzir o mesmo erro.
• O seu token desapareceu — a Meta só mostra um token uma vez. Gere um novo a partir do mesmo utilizador do sistema; o antigo continua a funcionar até que o revogue, mas apenas o novo é visível.
• As respostas falham com “This conversation came in on WhatsApp Business number …, which is not the number connected” — a sua aplicação Meta tem mais do que um número, e as pessoas estão a enviar mensagens para um que não é o número ligado aqui. As mensagens delas continuam a aparecer, porque a Meta envia as mensagens da aplicação para todos os números, mas as respostas só podem ser enviadas a partir do número ligado, pelo que a IA não lhes responde. O cartão do WhatsApp na página Channels mostra um aviso com esse número enquanto as mensagens continuam a chegar. A linha do número nesse cartão não tem um botão Reconnect (apenas Set as primary e eliminar): abra novamente a página de ligação da sua aplicação Meta (Connect WhatsApp no cartão WhatsApp Business API, depois Use a number you already have, depois Your own Meta app), prima Reconnect no cartão de ligação aí existente e escolha o número para o qual os seus clientes escrevem realmente. O token do utilizador do sistema precisa de acesso a essa conta do WhatsApp. Se esse número não deve chegar ao Your AI Connector de todo, remova-o (ou à sua conta do WhatsApp) da sua aplicação Meta.
• As mensagens que inicia não chegam — verifique a nota sobre a janela de 24 horas acima: fora dessa janela, apenas são entregues mensagens de modelo.
• Não chega absolutamente nada — o número provavelmente ainda não está ativado para a Cloud API. Um número só pode estar num local de cada vez, por isso, se ainda estiver com sessão iniciada na aplicação WhatsApp Business num telemóvel, remova-o primeiro e, em seguida, prima Verify connection no cartão de ligação. O Your AI Connector ativa-o para si e informa-o imediatamente se ainda faltar algo por parte da Meta.
• “This number already has a two-step verification PIN” — o número foi configurado noutro local anteriormente e manteve o seu PIN. Desative a verificação em dois passos para o mesmo no WhatsApp Manager e, em seguida, prima Reconnect.
• “Meta has not verified this number yet” — conclua a verificação do número no WhatsApp Manager (a Meta envia-lhe um código) e, em seguida, prima Reconnect.
• “This number is hosted on the On-Premises API” — está a ser executado no produto mais antigo de alojamento próprio do WhatsApp, que não pode partilhar um número com a Cloud API. Migre-o primeiro para a Cloud API no WhatsApp Manager.