wgtechlabs/unthread-discord-bot

Sponsored OSS

By WG Technology Labs

Updated 1 day ago

Turn Discord community servers into real-time support ticket hubs — powered by Unthread.io

Image
Integration & delivery
0

10K+

wgtechlabs/unthread-discord-bot repository overview

Unthread Discord Bot

Official Unthread extension for Discord support via bot commands and forum channels.

This integration does three core things:

  • Converts Discord support requests into Unthread conversations
  • Sends agent replies from Unthread back to Discord threads/posts
  • Syncs ticket updates and statuses between Discord and Unthread in real-time

How It Works

Customer (Discord) -> Bot -> Unthread
|
Agent (Unthread) <- Webhook Server <- Redis Queue <- Bot

  • Inbound path: Discord users create tickets with slash commands or forum posts, then the bot resolves or creates customer plus conversation in Unthread.
  • Outbound path: unthread-webhook-server pushes Unthread events to Redis, then this bot forwards replies and updates back to Discord.

Docker Quick Start

docker compose up -d
docker compose logs -f discord-bot

Reset local data:

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

Required Variables

VariablePurpose
DISCORD_BOT_TOKENDiscord bot token
CLIENT_IDDiscord application client ID
GUILD_IDDiscord server ID for command registration
UNTHREAD_API_KEYUnthread API key
UNTHREAD_SLACK_CHANNEL_IDUnthread target channel
POSTGRES_URLPostgreSQL connection string
PLATFORM_REDIS_URLRedis cache connection URL
WEBHOOK_REDIS_URLRedis queue connection URL for webhook events

Important Optional Variables

VariableDefaultNotes
FORUM_CHANNEL_IDSemptyComma-separated Discord forum channel IDs for auto-ticket creation
NODE_ENVproductionUse development for verbose debug logs
PORT3000Port used by companion webhook stack when applicable

Endpoints

MethodPathPurpose
N/AN/AThe bot runs as a Redis consumer and does not expose direct HTTP endpoints
GET/healthExposed by unthread-webhook-server for external health checks

Prerequisites

  • Node.js 20+
  • pnpm 9+
  • Discord application with bot permissions
  • Unthread API key and channel ID
  • PostgreSQL
  • Redis (cache and webhook queue)

Licensed under GNU AGPL v3.0.

Tag summary

Content type

Image

Digest

sha256:8974f9c8d

Size

70.3 MB

Last updated

1 day ago

docker pull wgtechlabs/unthread-discord-bot:dev

This week's pulls

Pulls:

567

Last week