Esta API é uma integração intermediária que recebe webhooks do Digital Manager Guru, processa pedidos PIX e envia notificações automáticas via WhatsApp Business Cloud API (Meta). Ela também gerencia o status do pedido em um banco de dados MySQL local.
Esse projeto foi criado para aprendizado e exploração de casos. Pode conter bugs e erros. Não use em produção!
- Recebimento de Webhook: Endpoint para receber atualizações de pedidos do Guru.
- Integração WhatsApp:
- Envia QR Code PIX para pedidos novos (
waiting_payment). - Envia confirmação de pagamento (
paid). - Envia aviso de boleto/pix expirado (
expired).
- Envia QR Code PIX para pedidos novos (
- Gerenciamento de Estado: Salva o status do envio para evitar mensagens duplicadas.
- Lógica de Produto Físico/Digital: Detecta automaticamente se o pedido contém produtos físicos (ex: "caderno") via configuração.
- Docker e Docker Compose instalados.
- Uma conta no Meta Developers configurada com a WhatsApp Cloud API.
- Token do Digital Manager Guru para segurança.
-
Clone o repositório:
git clone <seu-repo> cd digitalmanagerguru-pix-whatsapp-orders-api
-
Configure o ambiente: Copie o arquivo de exemplo e preencha com suas credenciais:
cp .env.example .env
O projeto já vem configurado com Docker Compose para subir a API e o Banco de Dados MySQL automaticamente.
docker compose up --buildA API estará rodando em http://localhost:3000.
- Instale as dependências:
npm install
- Inicie o banco de dados (você precisará ter um MySQL rodando localmente e ajustar o
.env):npm run dev
Recebe as notificações do Digital Manager Guru.
Headers necessários:
Content-Type:application/json
Payload esperado: Formato padrão de webhook do Digital Manager Guru (transação).
Observação: Certifique-se de configurar a URL do Webhook no painel do Digital Manager Guru apontando para este servidor.