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.

É 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 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.
• 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.

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.