# Conecte seu próprio aplicativo Meta
Execute o WhatsApp por meio do seu próprio aplicativo Meta e pague a Meta diretamente pelas taxas deles. O Your AI Connector não adiciona taxas por mensagem nesta conexão, e não há uma conta Twilio no meio. Como a conta do WhatsApp é sua, seus clientes veem apenas o nome da sua empresa.
Esta é a mais técnica das opções de conexão do WhatsApp — você criará um aplicativo dentro do site de desenvolvedores da Meta e copiará quatro valores para o Your AI Connector. Reserve cerca de 20 minutos. Se isso parece mais do que você deseja lidar, a conexão gerenciada [WhatsApp Business](whatsapp-business.md) continua sendo a maneira mais simples de começar.
## O que você precisa
* Acesso à sua conta do Gerenciador de Negócios da Meta.
* Um número de telefone que ainda não esteja em uso no aplicativo WhatsApp.
* Cerca de 20 minutos.
## Parte 1 — Configure seu aplicativo na Meta
Faça estas etapas no lado da Meta primeiro. Você coletará quatro valores ao longo do caminho: um **ID do aplicativo**, um **Segredo do aplicativo**, um **Token de acesso** e um **ID da conta do WhatsApp**.
### 1. Criar um aplicativo
Vá para [developers.facebook.com](https://developers.facebook.com), abra **Meus Aplicativos** e pressione **Criar Aplicativo**. Escolha o tipo **Negócios** e dê qualquer nome a ele — o nome é visível apenas para você.
### 2. Adicionar o WhatsApp ao aplicativo
No painel do aplicativo, encontre **WhatsApp** na lista de produtos e pressione **Configurar**. A Meta cria uma conta de teste do WhatsApp com um número de teste gratuito para que você possa experimentar as coisas antes de conectar um número real.
### 3. Ativar as permissões do WhatsApp
Esta é a etapa que a maioria dos guias ignora, e ignorá-la é a razão mais comum pela qual a conexão falha posteriormente.
No seu aplicativo, abra **Revisão do Aplicativo** e, em seguida, **Permissões e Recursos**. Procure por **whatsapp_business_management**. Se disser **Sem acesso**, pressione **Obter acesso padrão** — a Meta solicitará que você insira sua senha novamente e concederá o acesso na hora. Não há período de espera nem revisão de aplicativo; é apenas um botão.
`whatsapp_business_messaging` normalmente já possui acesso padrão. Ambas as permissões precisam exibir **Acesso padrão** antes da próxima etapa, caso contrário, o token que você gerar não terá uma delas.
### 4. Crie um usuário do sistema
Nas [Configurações de Negócios da Meta](https://business.facebook.com/settings), abra **Usuários** e, em seguida, **Usuários do sistema**. Adicione um e conceda a ele acesso de administrador tanto ao seu aplicativo quanto à sua conta do WhatsApp.
### 5. Gere um token para esse usuário
Selecione o usuário do sistema e pressione **Gerar token**. Escolha seu aplicativo, selecione um token que **nunca expire** e marque as opções **whatsapp_business_messaging** e **whatsapp_business_management**. A Meta exibe o token apenas uma vez — copie-o imediatamente.
### 6. Encontre o ID da sua conta do WhatsApp
Nas Configurações de Negócios, abra **Contas** e, em seguida, **Contas do WhatsApp**, e selecione sua conta. O número longo abaixo do nome é o ID.
O seu **ID do aplicativo** e o **Segredo do aplicativo** estão em **Configurações do aplicativo**, e depois em **Básico**. Pressione **Mostrar** ao lado de Segredo do aplicativo para revelá-lo.
## Parte 2 — Conecte-o no Your AI Connector
Abra **Configurações**, depois **Canais**, encontre o cartão **WhatsApp Business API** e pressione **Conectar WhatsApp**. Escolha **Usar um número que você já possui**, depois **Seu próprio aplicativo Meta**. O assistente abrirá em uma breve visão geral — pressione **Iniciar configuração**.
1. **Seus detalhes.** Esta etapa repete as cinco etapas do lado da Meta da Parte 1 ao lado de um formulário para seus quatro valores. Cole o ID do aplicativo, o segredo do aplicativo, o token de acesso e o ID da conta do WhatsApp exatamente como a Meta os mostra, sem espaços extras, e pressione **Verificar meus detalhes**. Nada é salvo até que funcionem — o Your AI Connector os verifica com a Meta primeiro.
2. **Escolha o número para conectar.** O assistente lista todos os números em sua conta do WhatsApp, cada um com a classificação de qualidade da própria Meta. Escolha aquele com o qual este espaço de trabalho deve enviar e receber mensagens e pressione **Conectar este número**.
3. **Ativação e entrega.** O Your AI Connector ativa o número para a Cloud API e registra seu webhook no Meta automaticamente, para que as mensagens recebidas cheguem à sua caixa de entrada — na maioria dos casos, você é direcionado diretamente para o cartão de conexão com uma confirmação de "Número conectado". Se a etapa automática não puder ser concluída, o assistente mostrará a URL de retorno (callback URL) e o token de verificação com botões de cópia e o guiará para adicioná-los você mesmo no Meta; os mesmos valores permanecem visíveis no cartão de conexão caso o Meta solicite que você os insira novamente.
4. **O assistente verifica a conexão por conta própria.** Na última etapa, ele verifica a configuração automaticamente — sem espera da sua parte. Assim que o cartão mostrar que está conectado, envie uma mensagem de WhatsApp para si mesmo de outro telefone e veja-a chegar em suas conversas: as conversas nesse número agora fluem como qualquer outro canal, e seus agentes de IA podem responder por ele. Se a verificação encontrar algo que o Meta ainda precise (por exemplo, a verificação do número), o cartão informará exatamente o que é, e **Verificar conexão** executará a verificação novamente assim que você tiver corrigido o problema.
Você pode voltar à mesma página a qualquer momento para verificar o status da conexão, **Reconectar** com novos detalhes ou pressionar **Desconectar** — seu número, sua conta Meta e seu faturamento continuam sendo seus.
## Bom saber
* **A janela de 24 horas se aplica, como em toda conexão do WhatsApp Business.** Você sempre pode responder livremente às pessoas que enviaram mensagens para você nas últimas 24 horas. Fora dessa janela, o WhatsApp só permite que as empresas iniciem conversas com um [modelo de mensagem](../templates/whatsapp-templates.md) aprovado — uma mensagem de texto simples será aceita pela Meta, mas não será entregue.
* **A Meta cobra você diretamente** pelas conversas nas taxas publicadas por país, no método de pagamento vinculado à sua conta do WhatsApp na Meta. O Your AI Connector não cobra por mensagem nesta conexão; o uso de IA é cobrado em créditos como de costume.
* **Mantenha um método de pagamento válido nessa conta do WhatsApp.** Sem ele, a Meta bloqueia todas as conversas que sua empresa inicia — transmissões, campanhas e qualquer mensagem de modelo — e mostra o erro no Gerenciador do WhatsApp. Nesta conexão, uma transmissão ou campanha se recusa a ser iniciada enquanto esse for o caso, e informa para adicionar um método de pagamento em vez de falhar mensagem por mensagem. As respostas para pessoas que enviaram mensagens primeiro ainda são enviadas por enquanto, mas a partir de **1º de outubro de 2026** a Meta cobrará por elas também, então uma conta sem um método de pagamento funcional ficará totalmente silenciosa nessa data. O panorama completo está em [Custos do WhatsApp e a Mudança de Outubro de 2026](whatsapp-pricing.md).
* **Sua estimativa de custo parece diferente aqui.** Como essas taxas nunca afetam seus créditos, a estimativa na etapa de revisão de uma transmissão (e na etapa de lançamento de uma campanha) mostra a contagem de contatos e a divisão por país com uma observação de que a Meta as cobra em sua Conta do WhatsApp Business, em vez de um total de créditos.
* **Números de teste são gratuitos.** O número de teste que a Meta fornece a cada novo aplicativo pode enviar mensagens para até cinco destinatários verificados sem custo — uma maneira prática de testar a configuração completa antes de apontar um número real para ela.
## Modelos
Os modelos de mensagem funcionam nesta conexão e residem na sua própria Conta do WhatsApp Business. Crie um na página **Modelos** e ele será criado nessa conta e revisado pela Meta, com o resultado aprovado, pendente ou rejeitado sendo exibido aqui para você. Os modelos que você já possui no Gerenciador do WhatsApp aparecem na lista automaticamente, e um botão **Sincronizar da Meta** traz tudo o que você acabou de alterar lá. O envio funciona como em qualquer outra conexão do WhatsApp — escolha um modelo aprovado para iniciar uma conversa ou reabri-la fora da janela de 24 horas. Os detalhes estão em [Usando Modelos com 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 foi possível conectar com esses detalhes"** — copie novamente cada valor; um espaço extra é a causa comum. A mensagem inclui a própria resposta do Meta, que geralmente indica qual valor está incorreto.
* **O erro diz que o token está faltando `whatsapp_business_management`** — seu aplicativo ainda não recebeu essa permissão. Volte para a Parte 1, etapa 3, pressione **Obter acesso padrão**, gere um novo token com ambas as permissões marcadas e verifique seus detalhes novamente. Regenerar o token sem essa etapa continuará produzindo o mesmo erro.
* **Seu token desapareceu** — o Meta mostra um token apenas uma vez. Gere um novo a partir do mesmo usuário do sistema; o antigo continua funcionando até que você o revogue, mas apenas o novo fica visível.
* **As mensagens que você inicia não estão chegando** — verifique a nota sobre a janela de 24 horas acima: fora da janela, apenas mensagens de modelo são entregues.
* **Nada chega** — o número provavelmente ainda não foi ativado para a Cloud API. Um número só pode estar em um lugar por vez, portanto, se ele ainda estiver conectado ao **aplicativo** WhatsApp Business em um telefone, remova-o de lá primeiro e, em seguida, pressione **Verificar conexão** no cartão de conexão. O Your AI Connector o ativa para você e informa na hora se o Meta ainda precisa de algo.
* **"Este número já possui um PIN de verificação em duas etapas"** — o número foi configurado em outro lugar anteriormente e manteve seu PIN. Desative a verificação em duas etapas para ele no Gerenciador do WhatsApp (WhatsApp Manager) e, em seguida, pressione **Reconectar**.
* **"O Meta ainda não verificou este número"** — conclua a verificação do número no Gerenciador do WhatsApp (o Meta enviará um código para ele) e, em seguida, pressione **Reconectar**.
* **"Este número está hospedado na API On-Premises"** — ele está sendo executado no produto de auto-hospedagem mais antigo do WhatsApp, que não pode compartilhar um número com a Cloud API. Migre-o para a Cloud API no Gerenciador do WhatsApp primeiro.