{"id":21954143,"url":"https://github.com/wrathofzombies/workbot","last_synced_at":"2026-05-02T15:45:28.371Z","repository":{"id":74182470,"uuid":"89316249","full_name":"WrathOfZombies/workbot","owner":"WrathOfZombies","description":"A bot to help query and manage work items across GitHub and Visual Studio Team Services.","archived":false,"fork":false,"pushed_at":"2017-06-13T04:37:12.000Z","size":38,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-22T18:38:22.647Z","etag":null,"topics":["bot","bot-framework","github-api","issues","productivity","project-management","vsts-tasks"],"latest_commit_sha":null,"homepage":"https://work-bot.azurewebsites.net/api/echo","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WrathOfZombies.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-25T04:06:58.000Z","updated_at":"2017-04-25T07:56:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"53b79f05-41b5-4774-b613-93d38943ab79","html_url":"https://github.com/WrathOfZombies/workbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WrathOfZombies/workbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WrathOfZombies%2Fworkbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WrathOfZombies%2Fworkbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WrathOfZombies%2Fworkbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WrathOfZombies%2Fworkbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WrathOfZombies","download_url":"https://codeload.github.com/WrathOfZombies/workbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WrathOfZombies%2Fworkbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32540120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bot-framework","github-api","issues","productivity","project-management","vsts-tasks"],"created_at":"2024-11-29T07:16:23.957Z","updated_at":"2026-05-02T15:45:28.339Z","avatar_url":"https://github.com/WrathOfZombies.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Work Bot\n\nA bot to help query and manage work items across **GitHub** and **Visual Studio Team Services**.\n\n## Requirements\n\nDownload and install the following:\n\n- **.NET Core SDK** from https://www.microsoft.com/net/core#windowscmd\n- **Git for Windows** from https://git-scm.com/download/win\n- **Bot Framework Emulator** from https://docs.botframework.com/en-us/tools/bot-framework-emulator/\n\nYou can get either:\n- **Visual Studio Code** from https://code.visualstudio.com/\n- **Visual Studio 2017 - Community** from https://www.visualstudio.com/vs/community/\n\nAlso some useful extensions for VSCode include:\n\n- C#\n- C# Extensions\n- GitLens\n- NuGet Package Manager\n\n## Getting started\n\nClone the repository using:\n\n```cmd\ngit clone https://github.com/WrathOfZombies/workbot\n```\n\nAfter cloning the repository run the following to download and install all the required dependencies:\n\n```cmd\ndotnet restore\n```\n\n## Project Structure\n\n### WorkBot\n\nContains the ASP.Net Core implemenation for the Bot Service and also deals with authentication of the Bot.\n\u003e Note: Bot Authentication here refers authenticaiton between our service and the Bot Framework so that our service is allowed to send and receive messages to the user\n\n### WorkBot.Services\n\nContains the various integration services that WorkBot supports and aggregation logic to determine the right service to be invoked at runtime.\nAlso provides definiton for what models the services would depend on and what models they would aggregate into.\n\n### WorkBot.Core\n\nContains the core logic to help the bot achieve tasks such as speech determination, routing, dialogs, forms etc.\n\n## Running locally\n\nCreate an `appsettings.json` file in the **WorkBot** project and paste the following into it:\n\n```json\n{\n  \"Logging\": {\n    \"IncludeScopes\": false,\n    \"LogLevel\": {\n      \"Default\": \"Warning\"\n    }\n  },\n  \"BotConfiguration\": {\n    \"AppId\": \"\",\n    \"AppSecret\": \"\",\n    \"Name\": \"Work Bot\",\n    \"Handle\": \"mywork\"\n  }\n}\n```\n\n\u003e Note: If you are a part of the core dev group, you'll be able to find the CLIENT_ID and CLIENT_SECRET in **Teams**.\n\nUse `F5` to start the project.\n\n\u003e Note: If you are having problems debugging on **VSCode** then type `Ctrl` + `Shift` + `P` and enter **Debug: Download .NET Core Debugger** to download the debugger.\n\n### Using Visual Studio Code\n\nNavigate to `http://localhost:5000/api/messages` and you should see a message such as *Echo bot is ready with \u003cCLIENT_ID\u003e*\n\n### Using Visual Studio\n\nNavigate to `https://localhost:44300/api/messages`. If required make sure to trust the certificates. Follow the following gif to do the same: [Trusting SSL Cert on Windows](https://github.com/OfficeDev/script-lab/blob/master/.github/images/trust-ssl-internet-explorer.gif)\n\n## Deploying to Azure\n\n### Using Visual Studio\n\nEverything is configured to work with Visual Studio out of the box. Hence just **Right Click** on the **solution** and click `Publish` and it should just deploy.\n\n\u003e Note: For the first time you'll be asked to login in using your deployment credentials.\n\nIf it doesn't work then follow the manual deploy steps or file an issue.\n\n### Manual steps\n\nFollow the steps to deploy to Azure manually.\n\u003e Note: This assumes that you have permissions and have already set your deployment credentials on Azure. If not please complete those steps first.\n\nFor the first time, do the following:\n\n```cmd\ngit remote add azure https://username@work-bot.scm.azurewebsites.net:443/work-bot.git\n```\n\nSubsequently you can do:\n\n```cmd\ngit push azure master:master\n```\n\nThis reads as `Deploy to 'azure' from 'master' branch to (:) 'master' branch`.\nAzure automatically detects the presence of `WorkBot.Entry.csproj` and resorts to download and building a **.NET Core** project.\n\n## Helpful commands\n\n### Git\n\nTo clear all local changes and create a fresh build use the following commands:\n\n**For a soft clean:**\n```cmd\ngit clean -fdx\ndotnet restore\n```\n\n**For a complete clean:**\n```cmd\ngit reset HEAD --hard\ngit clean -fdx\ndotnet restore\n```\n\n### VSCode\n\nIn VSCode the following commands can be useful (**assumes Windows**):\n\n- `Ctrl` + `Shift` + `B` ==\u003e Builds the project.\n- `F5` ==\u003e Starts the web server.\n- `Shift` + `Alt` + `F` ==\u003e Format the document.\n- `Ctrl` + `P` ==\u003e Open a file in the project.\n- `Ctrl` + `Shift` + `O` ==\u003e Search for a symbol ie. Class, Variable, Function, Property etc.\n- `Ctrl` + `~` ==\u003e Open integrated terminal.\n- `Ctrl` + `Shift` + `V` ==\u003e Preview Markdown files.\n\n## Useful links\n\n- https://docs.microsoft.com/en-us/bot-framework/dotnet/bot-builder-dotnet-concepts\n- https://code.visualstudio.com/docs/other/dotnet\n- https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-vsc\n- https://www.hanselman.com/blog/ExploringTheNewNETDotnetCommandLineInterfaceCLI.aspx\n- https://carlos.mendible.com/2016/09/11/netcore-and-microsoft-bot-framework/\n- https://github.com/CXuesong/BotBuilder.Standard/blob/portable/CSharp/README_PORTABLE.md\n- https://github.com/CXuesong/BotBuilder.Standard/tree/portable/CSharp/Samples\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwrathofzombies%2Fworkbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwrathofzombies%2Fworkbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwrathofzombies%2Fworkbot/lists"}