Criei um Hub GRATUITO para WhatsApp Oficial, Instagram e Messenger
Links importantes
## local
git clone https://github.com/pedroherpeto/oauth-hub-zdg.git
cd .\oauth-hub-zdg\
cria .env
npm run build
npm start
## docker
cria .env
docker compose up -d --build
Hub Meta ZDG: Instale seu Próprio Gateway para WhatsApp, Instagram e Messenger
Bora pra ação! Hoje vou te mostrar como instalar o Hub Meta ZDG, uma ferramenta gratuita e de código aberto para você conectar seu app da Meta e gerenciar os canais do WhatsApp, Instagram e Messenger em um único painel. Ele funciona como um gateway, recebendo os webhooks e até encaminhando-os para outros sistemas, como o Z-PRO.
Esta é a solução perfeita para quem tem um app próprio da Meta e quer centralizar o gerenciamento das conexões e interações de forma simples e eficiente.
Material de Apoio
O link para o repositório no GitHub e todos os comandos necessários para a instalação estão disponíveis logo acima nesta página.
O Que o Hub Meta ZDG Faz por Você?
Pense neste painel como uma central de controle para seu aplicativo da Meta. Com ele, você pode:
- Conectar Canais: Use o fluxo de Cadastro Incorporado (Onboarding) para conectar contas do WhatsApp (incluindo Coexistência), Instagram e Messenger.
- Visualizar Interações: Monitore em tempo real todos os webhooks (mensagens, eventos, etc.) que chegam em seus canais, com a opção de salvar ou não o histórico.
- Encaminhar Webhooks: Configure o encaminhamento dos eventos para múltiplas URLs de destino. Ideal para quem tem várias instâncias de um sistema de atendimento (como o Z-PRO) e quer usar um único app da Meta para todas elas.
- Gerenciar Múltiplos Apps: Cadastre e gerencie vários aplicativos da Meta em um único painel.
- Ferramentas de Apoio: O Hub ainda inclui um guia completo com links e dicas para a criação e aprovação do seu app na Meta, além de um "sandbox" para realizar testes de API obrigatórios.
Passo a Passo da Instalação (Local)
Você pode instalar o Hub no seu computador para testes de forma muito rápida.
1. Pré-requisitos
- Git e Node.js Instalados: Você precisará do Git para baixar o projeto e do Node.js para executá-lo. Verifique se estão instalados com os comandos
git --versionenode -v.
2. Instalando a Aplicação
Abra o terminal na sua Área de Trabalho e siga os comandos:
- Clone o Repositório:
git clone https://github.com/pedroherpeto/oauth-hub-zdg.git - Navegue para a Pasta:
cd oauth-hub-zdg
Atenção: Configure o Arquivo .env!
Antes de prosseguir, na pasta do projeto, encontre o arquivo .env.example. Faça uma cópia dele e renomeie-a para .env. Abra este novo arquivo e configure, no mínimo, a porta em que a aplicação irá rodar (ex: PORT=3300) e, se desejar, uma senha de administrador em ADMIN_PASSWORD.
- Instale as dependências:
npm install - Compile o projeto:
npm run build - Inicie a aplicação:
npm start
Pronto! Acesse http://localhost:3300 (ou a porta que você configurou) no seu navegador e o painel estará no ar.
Instalação Alternativa (via Docker)
Se você prefere usar o Docker, o processo é ainda mais simples:
- Clone o repositório e configure o arquivo
.envcomo no método local. - Certifique-se de que o Docker Desktop esteja rodando.
- No terminal, na pasta do projeto, execute o comando:
docker compose up -d --build
O Docker fará todo o trabalho de build e subirá o contêiner para você. Simples assim!
Com o Hub Meta ZDG, você ganha uma ferramenta poderosa e flexível para gerenciar suas integrações com a Meta, seja para uso próprio ou para escalar sua operação de revenda de sistemas de atendimento. O código é aberto, então sinta-se à vontade para explorar, customizar e contribuir!
Qualquer dúvida, é só chamar. Tamo junto!
