> For the complete documentation index, see [llms.txt](https://www.centralhub-ajuda.wlksistemas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.centralhub-ajuda.wlksistemas.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-api.md). # WhatsApp Oficial (API) Esta página detalha o processo completo para configurar a API Oficial do WhatsApp (também conhecida como WABA ou Cloud API) e conectá-la à Central Hub. Siga os passos na ordem correta para garantir uma configuração bem-sucedida. ## Antes de começar Você vai precisar de dois itens essenciais: 1. **Uma conta no Facebook.** 2. **Um número de telefone** (pode ser virtual ou um chip físico). {% hint style="danger" %} **Aviso sobre o número de telefone** * Você **não pode** usar o mesmo número no aplicativo normal do WhatsApp e na API Oficial. * Se quiser usar um número que já tem uma conta de WhatsApp, é **obrigatório excluir permanentemente a conta** de WhatsApp associada a ele antes de continuar. Não basta apenas apagar o aplicativo. * Para testes, recomenda-se fortemente a compra de um número virtual. {% endhint %} ## Etapa 1: Criação e configuração do aplicativo na Meta Nesta etapa, você cria o aplicativo no ambiente da Meta que será responsável por gerenciar a API. 1. **Acesse o Facebook for Developers:** faça login com sua conta do Facebook em [developers.facebook.com](https://developers.facebook.com/). 2. **Crie um novo aplicativo:** * Clique em "Criar Aplicativo". * Selecione "Outros". * Selecione o tipo **"Business"**. * Dê um nome ao aplicativo (ex.: "Central Hub WABA") e associe-o à sua conta do Gerenciador de Negócios (BM). 3. **Adicione o produto WhatsApp:** no painel do aplicativo, encontre e adicione o produto "WhatsApp". 4. **Configure as informações básicas:** * Acesse **"Configurações do app" > "Básico"**. * Preencha os campos **"URL da Política de Privacidade"** e **"URL dos Termos de Serviço"**. 5. **Ative o aplicativo:** no topo da página, mude o status do aplicativo de "Em desenvolvimento" para **"Ao vivo"**. ## Etapa 2: Cadastrando e verificando o número de telefone 1. No menu do aplicativo, vá para **"WhatsApp" > "Configuração da API"**. 2. **Adicione um número de telefone:** clique no botão para adicionar um novo número. 3. **Preencha os dados:** insira as informações da empresa e o número de telefone preparado na Etapa 1. 4. **Verifique o número:** escolha receber o código de verificação por SMS ou ligação telefônica e insira o código recebido. 5. **Adicione a forma de pagamento** (exigida pela Meta para o uso da API). 6. **Registre o número com PIN (passo obrigatório):** após a verificação, a Meta exige um registro de segurança com um PIN de 6 dígitos. Esse passo é feito diretamente na API da Meta, fora do painel da Central Hub: * Use uma ferramenta de chamadas HTTP como o **Postman** (ou similar) para enviar uma requisição ao endpoint de registro de número da própria Meta: `POST https://graph.facebook.com/v20.0/{Phone-Number-ID}/register`. * No corpo da requisição, envie `messaging_product: "whatsapp"` e o `pin` de 6 dígitos que você definir. * Use como cabeçalho de autorização (`Authorization: Bearer`) o token temporário gerado no painel de desenvolvedores da Meta (Etapa 1). * A coleção oficial da Meta para WhatsApp Business Platform (disponível publicamente no Postman) já traz esse endpoint pronto, na pasta de registro de número. {% hint style="info" %} Esse é o único passo de toda a configuração feito fora do painel da Central Hub e fora do painel da Meta — é uma exigência da própria Meta para todo número que entra na API Oficial. Se tiver dúvida na hora de montar essa chamada, fale com o suporte da Central Hub. {% endhint %} ## Etapa 3: Gerando um token de acesso permanente O token gerado pelo painel do desenvolvedor é temporário e expira em 24 horas. Para uma conexão estável com a Central Hub, é necessário um token permanente. 1. **Acesse as configurações do negócio:** navegue até o seu **Gerenciador de Negócios** (BM). 2. Vá para **"Usuários" > "Usuários do sistema"**. 3. **Crie um usuário do sistema:** adicione um novo usuário do sistema com a função de **"Admin"**. 4. **Atribua ativos:** com o novo usuário selecionado, clique em **"Atribuir Ativos"**. 5. Selecione **"Aplicativos"**, escolha o aplicativo criado na Etapa 1 e conceda a permissão de **"Gerenciar App"**. 6. **Gere o token:** ainda com o usuário selecionado, clique em **"Gerar novo token"**. * Selecione o seu aplicativo. * Defina a expiração como **"Nunca"**. * Marque as permissões necessárias (pelo menos `whatsapp_business_management` e `whatsapp_business_messaging`). * Clique em "Gerar Token", copie o código e guarde-o em um local seguro — ele não será exibido novamente. ## Etapa 4: Conectando a API na Central Hub e ativando webhooks 1. **Conecte o canal na Central Hub (para enviar mensagens):** * No painel Admin, acesse **"Canais"** e adicione um novo canal do tipo **"WABA"**. * Preencha os campos com as informações obtidas no painel da Meta (WhatsApp > Configuração da API): **ID do número de telefone**, **ID da conta do WhatsApp Business** e o **token permanente** gerado na Etapa 3. * Clique em Salvar. Você já estará apto a **enviar** mensagens. 2. **Ative os webhooks na Central Hub (para receber mensagens):** * No painel Admin, vá para **"Configurações" > "Integração Meta"**. * Copie a **URL do Webhook** e o **Token de Verificação**. * No painel do aplicativo na Meta, em **"WhatsApp" > "Configuração da API"**, clique em "Editar" na seção de Webhooks. * Cole a URL e o token copiados da Central Hub e clique em "Verificar e Salvar". * Após verificar, clique em **"Gerenciar"** e assine (**subscribe**) todos os eventos de webhook disponíveis (especialmente `messages`). ## Resultado esperado Com os webhooks ativos, a Central Hub está pronta para enviar e receber mensagens pela API Oficial do WhatsApp — a conexão mais estável e segura, recomendada para todas as operações. ## Problemas comuns **Atraso ou falha na comunicação com o webhook da Meta (erro de timeout)**\ Esse tipo de erro geralmente indica alta latência de rede entre o servidor e a Meta. Se isso ocorrer, entre em contato com o suporte da Central Hub para diagnóstico — pode exigir ajuste de infraestrutura, fora do alcance do painel administrativo. ## Precisa de ajuda? Esse tipo de conexão costuma exigir suporte técnico. Fale com o suporte da Central Hub pelo WhatsApp: [(31) 997122-2063](https://wa.me/5531997122063). SCREENSHOT NECESSÁRIO: capturar as telas de configuração do canal WABA na Central Hub (adicionar canal, tela de webhooks). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://www.centralhub-ajuda.wlksistemas.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.