wgtechlabs/unthread-webhook-server repository overview

⁠Unthread Webhook Server

Official Unthread integration service for secure webhook ingestion and platform-aware event routing.

This integration does three core things:

• Receives and verifies Unthread webhook events using HMAC-SHA256 signatures
• Detects source/target platform context (dashboard, Telegram, Discord, etc.)
• Publishes normalized events to Redis queue for downstream bot consumers

⁠How It Works

Unthread -> Webhook Server -> Redis Queue -> Platform Bot
|
Signature + Dedup + Correlation

• Inbound path: Unthread sends events to POST /unthread-webhook, then the server validates signatures, deduplicates events, and enriches payloads.
• Queue path: Processed events are published to Redis (unthread-events) for consumers like Telegram/Discord/WhatsApp bots.
• File intelligence: attachment events are correlated to source platform to avoid unknown-origin file handling.

⁠Docker Quick Start

docker network create unthread-integration-network
cp .env.example .env
docker-compose up -d
docker-compose logs -f webhook-server

Reset local data:

docker-compose down -v && docker-compose up -d

⁠Required Variables

⁠Important Optional Variables

⁠Endpoints

⁠Prerequisites

• Node.js 22+
• Bun
• Redis
• Unthread webhook signing secret

⁠Links

• GitHub: https://github.com/wgtechlabs/unthread-webhook-server⁠
• Docker Hub: https://hub.docker.com/r/wgtechlabs/unthread-webhook-server⁠
• Deploy on Railway: https://railway.com/deploy/unthread-webhook-server?referralCode=dTwT-i⁠

Licensed under GNU GPL v3.0.