# 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](whatsapp-business.md) 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](https://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](https://business.facebook.com/settings), 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.
## É bom saber
* **A janela de 24 horas aplica-se, tal como em qualquer ligação ao 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](../templates/whatsapp-templates.md) aprovado — uma mensagem de texto simples será aceite pela Meta, mas não será entregue.
* **A Meta fatura-lhe diretamente** as conversas às tarifas publicadas para o seu país, através do método de pagamento associado à sua conta de WhatsApp na Meta. O Your AI Connector não cobra por mensagem nesta ligação; a utilização da IA é faturada em créditos, como habitualmente.
* **Mantenha um método de pagamento válido nessa conta de WhatsApp.** Sem ele, a Meta bloqueia todas as conversas que a sua empresa inicia — transmissões, campanhas e qualquer mensagem de modelo — e mostra o erro no WhatsApp Manager. Nesta ligação, uma transmissão ou campanha recusa-se a ser iniciada enquanto for esse o caso, e indica-lhe para adicionar 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 silenciosa nessa data. O panorama completo encontra-se em [Custos do WhatsApp e a Alteração de outubro de 2026](whatsapp-pricing.md).
* **A sua estimativa de custos parece diferente aqui.** Como estas taxas nunca tocam nos seus créditos, a estimativa no passo de revisão de uma transmissão (e no passo de lançamento de uma campanha) 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 útil de experimentar a configuração completa 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](../templates/whatsapp-templates.md#using-templates-with-your-own-meta-whatsapp-account).
## Se algo não funcionar
* **"Não conseguimos ligar com esses detalhes"** — 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 o token está em falta `whatsapp_business_management`** — a sua aplicação ainda não recebeu essa permissão. Volte à Parte 1, passo 3, prima **Obter acesso padrão**, gere um novo token com ambas as permissões selecionadas e verifique novamente os seus detalhes. 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 mensagens que inicia não estão a chegar** — verifique a nota sobre a janela de 24 horas acima: fora dessa janela, apenas as mensagens de modelo são entregues.
* **Não chega 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 **Verificar ligação** no cartão de ligação. O Your AI Connector ativa-o por si e informa-o imediatamente se ainda faltar algo na Meta.
* **"Este número já tem um PIN de verificação em dois passos"** — 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 **Reconectar**.
* **"A Meta ainda não verificou este número"** — conclua a verificação do número no WhatsApp Manager (a Meta envia-lhe um código) e, em seguida, prima **Reconectar**.
* **"Este número está alojado na API On-Premises"** — está a ser executado no produto de alojamento próprio mais antigo do WhatsApp, que não pode partilhar um número com a Cloud API. Migre-o primeiro para a Cloud API no WhatsApp Manager.