{ "version": "2", "generatedAt": "2026-11-03T22:49:39.280Z", "listing": { "slug": "Tiledesk--tiledesk", "name": "Tiledesk", "tagline": "MIT live chat plus chatbot design studio, deployed from a docker-compose env file, driven by a REST API.", "shortTagline": "Live chat and chatbot studio", "description": "Tiledesk is an open-source conversational support platform: web widget, agent dashboard, a visual chatbot Design Studio with LLM and knowledge-base steps, and channels for WhatsApp, Messenger, and Telegram. This repo is the deployment bundle (docker-compose and Helm) that wires server, dashboard, design studio, chat21 messaging, and MongoDB together. The Builder publishes a REST API for requests, messages, leads, departments, chatbots, and knowledge bases, and sells hosted and enterprise editions.", "capabilities": [ "adaptable", "operable" ], "vertical": "support-bookkeeping", "alternativeTo": [ "Intercom", "Tidio", "Drift" ], "shape": "business-app", "formFactor": "web-app", "executionModel": "hybrid", "provenance": "human-written", "codeStack": { "languages": [ "JavaScript", "TypeScript" ], "frameworks": [ "Node.js", "Express", "Angular (dashboard)", "Ionic (chat21)" ], "packageManager": "npm", "database": [ "MongoDB", "Redis" ], "hostingTarget": [ "Docker Compose", "Kubernetes (Helm)" ] }, "modelStack": { "providers": [ "OpenAI (GPTKEY)", "other LLMs through tilellm" ], "models": [], "requiredKeys": [ "GPTKEY" ], "promptLocations": [ "Design Studio (UI)" ], "tools": [] }, "repos": [ { "url": "https://github.com/Tiledesk/tiledesk", "owner": "Tiledesk", "name": "tiledesk", "license": "MIT", "stars": 316, "lastCommit": "2026-09-01" } ], "interface": { "kind": "api", "url": "https://developer.tiledesk.com/apis/rest-api", "official": true, "hosted": "both" }, "operability": "official", "recommendedWrapper": null, "reach": [ { "job": "Create and list support requests (conversations)", "reachable": true, "evidence": "Requests API: POST create with first text, language, source page; list with filters by status, department, lead, channel, tags" }, { "job": "Route, assign, and follow requests", "reachable": true, "evidence": "Requests API: route to department, add/set/remove participants and followers" }, { "job": "Close and reopen requests", "reachable": true, "evidence": "Requests API: close (status 1000), reopen (status 100)" }, { "job": "Send messages into a conversation", "reachable": true, "evidence": "Messages section in the REST API index; Requests API returns participants and messages" }, { "job": "Tag requests and add internal notes", "reachable": true, "evidence": "Requests API: tags, custom attributes, notes add/update/delete" }, { "job": "Manage leads and departments", "reachable": true, "evidence": "Leads and Departments sections in the REST API index" }, { "job": "Design chatbot flows", "reachable": null, "evidence": "Chatbots section exists in the API index; whether flows can be authored through API versus imported JSON not verified" }, { "job": "Load knowledge bases for AI answers", "reachable": null, "evidence": "Knowledge Bases section in the API index; operations not verified" }, { "job": "Connect WhatsApp, Messenger, Telegram", "reachable": false, "evidence": "channel apps are configured through the dashboard Apps panel" }, { "job": "Analytics and CSAT reporting", "reachable": false, "evidence": "ratings are on requests; no analytics section in the API index" } ], "editions": [ { "name": "Community (self-hosted)", "price": null, "open": true, "distributions": [ { "kind": "source", "url": "https://github.com/Tiledesk/tiledesk" }, { "kind": "container", "url": "https://github.com/Tiledesk/tiledesk/tree/master/docker-compose", "command": "docker compose -f docker-compose.yml up" } ] }, { "name": "Hosted (tiledesk.com)", "price": null, "open": false, "distributions": [ { "kind": "hosted", "url": "https://tiledesk.com" } ] }, { "name": "Enterprise (private images)", "price": null, "open": false, "distributions": [ { "kind": "container", "url": "https://github.com/Tiledesk/tiledesk#enterprise-version" } ] } ], "skills": { "kind": "none", "paths": [], "install": null, "note": "No SKILL.md, Claude Code plugin, or skills install target in the repo." }, "customization": { "summary": "docker-compose/docker-compose.yml sets 60+ environment variables per service. An SMB edits JWT_SECRET_KEY, SERVER_BASE_URL, DASHBOARD_URL, WIDGET_LOCATION, REDIS_URL, GPTKEY (LLM key name), VECTOR_STORE_HOST, WEBHOOK_ENABLED, EMAIL_SECTION, SUPPORT_MODE, and PUSH_ENGINE. Chatbot behavior and prompts are authored in Design Studio, not files. Helm charts are a starting template the README says to modify for production.", "envVars": [ "JWT_SECRET_KEY", "JWT_KEY", "SERVER_BASE_URL", "DASHBOARD_URL", "WIDGET_LOCATION", "REDIS_URL", "GPTKEY", "VECTOR_STORE_HOST", "VECTOR_STORE_NAME", "WEBHOOK_ENABLED", "RESTHOOK_ENABLED", "EMAIL_SECTION", "SUPPORT_MODE", "PUSH_ENGINE", "APPS_ACCESS_TOKEN_SECRET", "MQTT_APIENDPOINT" ], "configFiles": [ "docker-compose/docker-compose.yml", "helm/values.yaml" ], "promptFiles": [], "effort": "config-only", "editCount": 18 }, "useWhen": [ "we want a self-hosted chat widget with an AI bot that answers from our docs and escalates to a human, under an MIT license", "we want our agent to open, tag, route, and close conversations through an API while humans work in the dashboard" ], "accounts": [ "OpenAI or another LLM provider (for AI steps)", "Meta or Telegram developer accounts for channels (optional)", "Tiledesk account for hosted and enterprise editions" ], "active": true, "lastActivity": "2026-09-01", "gotchas": [ "Nine services plus MongoDB and Redis; the README says Helm charts are not production-ready as is", "Stars are split across many repos (server, dashboard, design studio); this bundle repo shows 316", "Enterprise Docker images need credentials from info@tiledesk.com", "Hosted plan pricing page returned 404 during analysis" ], "fit": { "adaptable": 3, "operable": 2 }, "evidence": { "formFactor": "README: Docker Compose or Kubernetes deployment of server, dashboard, design studio, chat21, MongoDB", "executionModel": "GPTKEY and vector store variables in docker-compose.yml; Design Studio LLM steps", "operability": "developer.tiledesk.com REST API index: Requests, Messages, Leads, Departments, Chatbots, Knowledge Bases, JWT", "effort": "docker-compose/docker-compose.yml environment blocks list named variables", "editions": "README: Enterprise credentials for private images; tiledesk.com hosted", "active": "gh api: pushed 2026-09-01; dashboard repo pushed 2026-09-02" }, "confidence": { "formFactor": 0.95, "executionModel": 0.85, "operability": 0.9, "effort": 0.85, "reach": 0.75, "editions": 0.6 }, "openQuestions": [ "Hosted and enterprise pricing", "Whether chatbot flows and knowledge bases can be created through the API" ], "sources": [ { "url": "https://github.com/Tiledesk/tiledesk", "foundBy": "sourcing:support-bookkeeping:curated" }, { "url": "https://developer.tiledesk.com/", "foundBy": "sourcing:support-bookkeeping:curated" }, { "url": "https://developer.tiledesk.com/apis/rest-api/requests.md", "foundBy": "analysis" } ], "research": { "stage": "verified", "verdict": "unverified", "reason": "MIT, env-driven deployment, official REST API with request lifecycle reachable; chatbot authoring through API unverified.", "disputed": [] }, "url": "apps/Tiledesk--tiledesk.html", "coverage": "partial", "paid": false, "source": "research/verified/Tiledesk--tiledesk.json" } }