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

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.