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

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 --version e node -v.

2. Instalando a Aplicação

Abra o terminal na sua Área de Trabalho e siga os comandos:

  1. Clone o Repositório:
    git clone https://github.com/pedroherpeto/oauth-hub-zdg.git
  2. 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.

  1. Instale as dependências:
    npm install
  2. Compile o projeto:
    npm run build
  3. 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:

  1. Clone o repositório e configure o arquivo .env como no método local.
  2. Certifique-se de que o Docker Desktop esteja rodando.
  3. 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!