1) OBJETIVO
Este manual tem como objetivo orientar o usuário na criação de conta empresarial na Meta, configuração do WhatsApp Business Cloud API, verificação da empresa e conexão com o Athenas Messenger, de forma segura e completa.
2) PRÉ-REQUISITO: UTILIZAR UM NÚMERO DE TELEFONE EXCLUSIVO
– Certifique-se de utilizar um número de telefone exclusivo, ou seja, um chip novo, que não esteja vinculado a nenhuma conta ativa do WhatsApp (pessoal ou comercial).
– Esse número será associado exclusivamente ao WhatsApp Business Cloud API e não poderá ser utilizado simultaneamente no aplicativo convencional do WhatsApp ou WhatsApp Business instalado no celular.
📌 Importante:
Uma vez conectado à API, esse número não poderá mais ser usado em dispositivos móveis via aplicativo padrão. Se necessário, migre o histórico antes de associá-lo à API.

3) CRIAR UMA CONTA EMPRESARIAL NA META (Business Manager)
Acesse o site oficial da Meta para contas empresariais:
🔗 https://business.facebook.com/overview
Clique em “Criar conta” no canto superior direito da tela.

Preencha o formulário com as seguintes informações:
Nome da empresa (razão social ou nome fantasia)
Seu nome completo (administrador da conta)
E-mail corporativo válido (preferencialmente com domínio da empresa)
Clique em [Enviar] para prosseguir.

Acesse a caixa de entrada do e-mail informado e clique no link de confirmação enviado pela Meta para ativar a conta.
📌 Dica:
Se não encontrar o e-mail de confirmação, verifique a caixa de spam ou promoções. A ativação é essencial para seguir com a configuração do WhatsApp Business Cloud API.

4) CRIAR UMA CONTA NO META FOR DEVELOPERS
Acesse o portal oficial de desenvolvedores da Meta:
🔗 https://developers.facebook.com
Clique no botão [Começar].

Leia e aceite os Termos e Condições da Plataforma Meta.
Clique em [Continuar].

Prossiga com a verificação de identidade via SMS:
Informe um número de celular válido.
Em seguida clique em [Enviar SMS para verificação].

Digite o código de verificação recebido por SMS para validar sua conta.
Clique em [Continuar].

Em seguida, confirme o endereço de e-mail cadastrado.
Clique em [Confirmar e-mail].

Escolha um perfil de categoria profissional (exemplo: Profissional de Marketing, Desenvolvedor, Empresário) e finalize o processo de criação da conta.
Para finalizar clique em [Concluir inscrição].
📌 Importante:
Essa conta será usada para criar e gerenciar os aplicativos e tokens necessários à integração com o WhatsApp Business Cloud API. Utilize dados válidos e atualizados para garantir segurança e rastreabilidade.

5) CRIAR O APLICATIVO NA PLATAFORMA DA META
Acesse novamente o portal:
🔗 https://developers.facebook.com
No menu superior, clique em “Meus Apps” e depois em “Criar Aplicativo”.

Na tela de seleção do tipo de aplicativo:
Selecione a opção “Outro”.
Clique em [Avançar].

Em seguida, escolha a opção de finalidade:
Marque “Empresa”.
Clique novamente em [Avançar].

Preencha os dados solicitados:
Nome do Aplicativo (ex: AthenasMessengerAPI)
E-mail de contato do desenvolvedor (preferencialmente corporativo)
Conta Empresarial vinculada (aquela criada no Business Manager)
Clique em [Criar Aplicativo] para finalizar o processo.
📌 Importante:
Esse aplicativo será a base técnica para ativar e gerenciar a API do WhatsApp Business. Use nomes claros e evite duplicidade com outros apps que já possam existir em sua conta de desenvolvedor.

6) ADICIONAR O PRODUTO WHATSAPP BUSINESS CLOUD AO APLICATIVO
Com o aplicativo já criado, acesse o painel em:
🔗 https://developers.facebook.com/apps
No menu lateral do aplicativo, localize a seção “Adicionar Produto”.
Encontre o produto “WhatsApp” e clique em [Configurar].

Leia atentamente os termos de uso da API do WhatsApp Business.
Marque a opção “Li e aceito os termos” e clique em [Continuar].

O produto WhatsApp Business Cloud API será ativado automaticamente dentro do seu aplicativo, e você será redirecionado para o painel de configurações iniciais da API.
📌 Importante:
Esse processo é obrigatório para que o número de telefone empresarial seja vinculado à API e possibilite a comunicação automatizada via Athenas Messenger.

7) CONFIGURAR O NÚMERO DE TELEFONE NA API DO WHATSAPP
No menu lateral do aplicativo, acesse:
WhatsApp > Configuração da API
Clique em [Adicionar Número de Telefone] para iniciar a vinculação do seu número empresarial.

Preencha os dados da empresa:
- Nome da empresa (como será exibido no perfil comercial)
- Site oficial ou link de rede social ativa (ex: Instagram, Facebook)
- País de operação da empresa.

Em seguida, configure o perfil público do WhatsApp Business:
- Nome de exibição (visível para os clientes nas mensagens)
- Fuso horário da empresa
- Categoria do negócio (ex: Contabilidade, Comércio, Tecnologia)
- Descrição (opcional – pode conter slogan ou resumo da atividade).
Clique em [Avançar].

Informe o número de telefone com DDI + DDD (ex: +55 11 91234-5678) que será vinculado à API.
Escolha o método de verificação por SMS (ou ligação, se preferir).
Clique em [Avançar].

Digite o código de verificação recebido no celular e clique em [Avançar] para concluir o registro do número.
📌 Importante:
Esse número será utilizado exclusivamente para envio e recebimento de mensagens automatizadas via API, não podendo estar conectado a um WhatsApp convencional ou WhatsApp Business instalado no celular.

8) ADICIONAR FORM DE PAGAMENTO NA CONTA META
Para utilizar a API do WhatsApp Business, é necessário cadastrar um método de pagamento válido para cobrança de créditos pelas mensagens enviadas.
No painel de administração da conta comercial da Meta, acesse o menu:
Configurações > Configurações de Pagamento.
Clique em [Adicionar Forma de Pagamento].

Clique em [Configurações de pagamento].

Em seguida clique em [Adicionar Forma de Pagamento].

Preencha os campos obrigatórios:
- País: selecione Brasil
- Moeda: selecione Dólar americano (USD)
- Fuso horário: selecione o mesmo definido anteriormente para o perfil do WhatsApp
Clique em [Avançar].

Selecione a forma de pagamento “Cartão de crédito ou débito”.
Clique em [Avançar].

Insira os dados do cartão de crédito internacional autorizado para transações online.
Clique em [Salvar].

Será exibida a mensagem abaixo, clique em [Avançar].

Em seguida, preencha os dados de faturamento, como:
- Nome/Razão Social
- CPF ou CNPJ
- Endereço completo da empresa ou responsável financeiro
- Telefone e e-mail para contato
Após validar os dados, clique em [Confirmar] para finalizar o cadastro da forma de pagamento.
📌 Importante:
O pagamento será utilizado exclusivamente para cobrança das mensagens transacionais via WhatsApp API.
Certifique-se de utilizar um cartão ativo e autorizado para uso internacional.

9) REALIZAR A VERIFICAÇÃO DA EMPRESA NA META (Business Verification)
A verificação da empresa é uma etapa obrigatória para habilitar funcionalidades completas da API do WhatsApp Business, como envio de mensagens em produção e registro definitivo do número.
Acesse o painel do aplicativo e vá até:
Contas do WhatsApp > Verificação da Empresa.
▸ Ou, alternativamente: Menu lateral > Centro de Segurança > [Começar].

Clique em [Iniciar Verificação] para abrir o formulário.

Clique em [Começar] para realizar o preenchimento do formulário solicitado pela Meta.

Preencha os dados da empresa nos campos obrigatórios:
- País de operação
- Razão Social completa (conforme CNPJ)
- Número do CNPJ
- Endereço comercial completo


Anexe os documentos solicitados como comprovação:
- Cartão do CNPJ emitido pela Receita Federal
- Comprovante de endereço recente (conta de consumo, contrato de locação, etc.)

Informe o domínio corporativo da empresa (ex: www.suaempresa.com.br) para validação da propriedade.
Clique em [Avançar] e aguarde a análise da Meta.

Após o envio das informações, a solicitação de verificação passará por um processo de análise conduzido pela equipe da Meta.
📌 Durante essa etapa, os dados e documentos fornecidos serão avaliados para garantir a legitimidade da empresa e a conformidade com as políticas da plataforma.


Após aprovação, o status da empresa passará para “Verificado”, e as funções
de API estarão plenamente habilitadas.
📌 Importante:
O processo pode levar de 24 a 72 horas úteis.
Certifique-se de que os documentos estejam legíveis e em nome da mesma razão social informada.

10) CRIAR E APROVAR MODELOS DE MENSAGEM NA META
Para que sua empresa envie mensagens ativas (como notificações, lembretes ou confirmações), é necessário criar e aprovar modelos personalizados de mensagem na plataforma da Meta.
Acesse o painel de aplicativos no portal Meta for Developers:
Meus Apps > [Seu App] > WhatsApp > Início Rápido > Modelos de Mensagem.


Clique no botão [Criar Modelo].

Preencha os campos obrigatórios:
🔗 Categoria:
Escolha a categoria que melhor representa o objetivo da mensagem. As opções disponíveis são:
- Marketing – Para promoções, campanhas, ofertas e mensagens com cunho comercial.
- Serviços – Para interações transacionais e informativas, como atualizações de pedidos, agendamentos ou confirmações.
- Autenticação – Para envio de códigos de verificação, autenticação em dois fatores e mensagens de segurança.
📌 Atenção: A seleção incorreta da categoria pode causar rejeição automática do modelo. Sempre relacione o conteúdo da mensagem à finalidade real da comunicação.

📝 Nome do Modelo:
Defina um nome objetivo, simples e sem espaços ou caracteres especiais, pois ele será utilizado internamente para identificação do modelo.
▸ Exemplo sugerido: saudacao_boasvindas
🌍 Idioma:
Selecione o idioma em que a mensagem será escrita.
Recomenda-se escolher Português (Brasil), ou outro idioma compatível com seu público-alvo.

✍️ Conteúdo da Mensagem:
Estruture o corpo da mensagem nos blocos disponíveis:
Cabeçalho (opcional) – Título breve ou campo dinâmico (ex: nome do cliente, número do pedido).
Corpo da mensagem – Texto principal com informações e variáveis, caso necessário (ex: {{1}}, {{2}}).
Rodapé (opcional) – Observações finais, cláusulas legais ou informações complementares.
Botões de ação (opcional) – Links, chamadas ou respostas rápidas (ex: “Falar com atendente”).
📌 Dica:
Utilize variáveis apenas onde realmente forem necessárias, e mantenha o conteúdo direto e adequado ao tipo de categoria escolhida (Marketing, Serviço ou Autenticação).
Variáveis (como {{1}}, {{2}}) devem ser explicadas claramente no momento da criação.
Mensagens do tipo “Boas-vindas”, “Confirmação de agendamento” e “Aviso de vencimento” são comuns e rapidamente aprovadas.


11) CONECTAR AO ATHENAS MESSENGER
Após concluir as configurações na plataforma Meta, é necessário integrar os dados da conta ao sistema Athenas Messenger para ativar a comunicação via WhatsApp Business API.
11.1 Copiar o Código de Identificação da Conta WhatsApp Business
Copiar o Código de Identificação do Número de Telefone
No aplicativo criado na Meta, acesse o menu lateral WhatsApp > Configurações da API.
Localize o campo Identificação do número de telefone.
Copie esse código, pois ele será utilizado no Athenas Messenger.

11.2 Inserir o Código no Athenas Messenger
Acesse o sistema Athenas Messenger.
Vá ao menu Configurações > Serviço WhatsApp/API. Cole o ID da Conta do WhatsApp Business no campo correspondente.

11.3 Gerar o Token de Acesso Permanente
11.3.1 Criar um Usuário Administrador
No portal https://developers.facebook.com, vá em:
Meus Apps > [Seu App] > Configurações do negócio.

Crie um perfil com o nome desejado (ex: AthenasMessengerBot).
Selecione o papel de Administrador.
Clique em [Criar usuário do sistema].

11.3.2 Atribuir o Usuário à Conta e Permissões
Acesse o menu Contas > WhatsApp Business.
Vincule o usuário criado à sua conta de WhatsApp Business.
Clique em [Atribuir Ativos].

Atribua as permissões do usuário.
Clique em [Salvar alterações].

11.3.3 Gerar o Token de Acesso
Ainda em Usuários do Sistema, clique no botão [Gerar novo Token].
Escolha o aplicativo e o usuário criado.

11.3.4 Definir Expiração e Permissões
Em Tempo de Expiração, selecione:
▸ Nunca expirar (recomendado)
Em Permissões, selecione:
▸ whatsapp_business_management
▸ whatsapp_business_messaging
Clique em [Gerar Token].
Copie o token gerado com segurança.


11.4 Inserir o Token de Acesso no Athenas Messenger
No Athenas Messenger, ainda na tela Integrações > MetaAPI:
Cole o Token de Acesso Permanente no campo indicado.
Clique em [Salvar Configuração] para concluir a integração.
✅ A integração estará ativa e o sistema pronto para envio e recebimento de mensagens pela API oficial da Meta.

📌 Observação Final:
A Meta pode alterar suas políticas, fluxos e requisitos técnicos a qualquer momento.
➡️ Sempre consulte a documentação oficial atualizada em: