{"id":28468868,"url":"https://github.com/kostickm/watsonbot","last_synced_at":"2026-05-01T02:32:25.678Z","repository":{"id":93195595,"uuid":"94583297","full_name":"kostickm/watsonbot","owner":"kostickm","description":"Watson Conversation Slack Bot","archived":false,"fork":false,"pushed_at":"2017-08-10T13:51:50.000Z","size":1606,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-01T14:43:18.398Z","etag":null,"topics":["slack","slackbot","watson","watson-conversation"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kostickm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2017-06-16T21:41:28.000Z","updated_at":"2017-11-03T20:00:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"35008f91-0d6e-4bc4-881e-421dcf173cdb","html_url":"https://github.com/kostickm/watsonbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kostickm/watsonbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostickm%2Fwatsonbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostickm%2Fwatsonbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostickm%2Fwatsonbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostickm%2Fwatsonbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kostickm","download_url":"https://codeload.github.com/kostickm/watsonbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostickm%2Fwatsonbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32483406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["slack","slackbot","watson","watson-conversation"],"created_at":"2025-06-07T08:08:44.845Z","updated_at":"2026-05-01T02:32:25.672Z","avatar_url":"https://github.com/kostickm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# watsonbot\n**Watson Conversation Slack Bot**\n\nGet started with the [Watson Conversation Service](https://console.bluemix.net/catalog/services/conversation) by creating your very own Slack Chat Bot. This demo will walk you through all of the necessary steps to configure your Watson Conversation service, set up your Slack bot, and deploy your application to Bluemix. You will be chatting with Watson in no time!\n\n## Prerequistes\n\n### Python\n* [Python 2.7.x](https://www.python.org/downloads/)\n\n### Slack\n* [Slack](https://slack.com)\n* [Slack API](https://api.slack.com/)\n  \n### Bluemix\n* [Bluemix Account](https://console.bluemix.net/)\n* [Bluemix CLI](https://clis.ng.bluemix.net/ui/home.html)\n\n### Git\n* [Github Account](https://github.com)\n* [Git](https://git-scm.com/downloads)\n\n## Steps\n### Set up the Watson Conversation Service\n1. See the [instructions](conversation/README.md) for setting up and configuring your [Watson Conversation Service](https://console.bluemix.net/catalog/services/conversation).\n\n### Clone project and update for your Slack bot\n1. Git clone this sample project\n\n`$    git clone git@github.com:kostickm/watsonbot.git`\n\n2. Change to your the newly cloned repo\n\n`$    cd watsonbot/`\n\n3. Create a new Slack [bot](https://api.slack.com/bot-users), you will be assigned a Slack API Token\n\n4. Export your assigned Slack API Token\n\n```\n# Windows\n$    set SLACK_BOT_TOKEN=\u003cSLACK_BOT_TOKEN\u003e\n\n# macOS/Linux\n$    export SLACK_BOT_TOKEN='\u003cSLACK_BOT_TOKEN\u003e'\n```\n\n5. Install the `slackclient` python package\n\n```\n$    pip install slackclient\n```\n\n6. Run the `print_bot_id.py` script\n  \n```\n$    python print_bot_id.py\nBot ID for 'watsonbot' is \u003cSLACK_BOT_ID\u003e\n```\n\n7. Save both of these credentials for use later in this tutorial\n\n8. Copy the `env.sample` file to a new file named `.env`\n\n```\n# Windows\n$    copy env.sample .env\n\n# macOS/Linux\n$    cp env.sample .env\n```\n\n9. Open and update the `.env`. file with your Slack credentials\n\n```\n# Slack\nSLACK_BOT_TOKEN=\u003cadd_slack_bot_token\u003e\nSLACK_BOT_ID=\u003cadd_slack_bot_id\u003e\n```\n\n10. Open and update the `.env`. file with your Watson Conversation credentials\n\n```\n# Watson conversation\nCONVERSATION_USERNAME=\u003cadd_conversation_username\u003e\nCONVERSATION_PASSWORD=\u003cadd_conversation_password\u003e\nWORKSPACE_ID=\u003cadd_conversation_workspace\u003e\n```\n\n11. Open the `manifest.yml` file and replace `\u003cYour-App-Name\u003e` with the unique name of your app\n\n```\n---\napplications:\n - name: \u003cYour-App-Name\u003e\n   domain: mybluemix.net\n   memory: 128M\n   health-check-type: none\n   buildpack: https://github.com/cloudfoundry/buildpack-python.git\n```\n\n12. Open the `setup.py` file and replace `\u003cYour-App-Name\u003e`with the unique name of your app\n\n```\n# Always prefer setuptools over distutils\nfrom setuptools import setup\n\nlong_description = ('This is a sample Watson Conversation Slack chat bot.')\n\nsetup(\n    name='\u003cYour-App-Name\u003e',\n    version='1.0.0',\n    description='Watson Slack Chat Bot',\n    long_description=long_description,\n    license='Apache-2.0'\n)\n```\n\n13. *Optional: Run locally to test*\n\n**Note: Make sure to set/export all environment variables located in the `.env` file before running locally. Also `pip` install all python packages listed in the `requirements.txt` file.**\n\n`$    python watsonbot.py`\n\nChat with your `watsonbot` by sending a Slack message starting with `@watsonbot`.\n\n### Deploy to Bluemix\nYou are now ready to deploy your application to Bluemix.\n\n*Note: You may also use the shorthand command `bx` instead of `bluemix`.*\n\n1. Log into Bluemix CLI using your Bluemix credentials\n\n  `$    bluemix api https://api.ng.bluemix.net`\n\n  `$    bluemix login`\n\n2. From your local app directory deploy your app to Bluemix\n\n  `$    bluemix app push`\n\n### Chat with Watson\n1. Check that your app is running in Bluemix\n\n\u003cimg src=\"media/RunningPythonApp.png\" width=\"700\"\u003e\n\n2. Test out your deployed app in Slack. Chat with your `watsonbot` by sending a Slack message starting with `@watsonbot`.\n\n## Next Steps\n* Check out the other Watson Python SDK [examples](https://github.com/watson-developer-cloud/python-sdk/tree/master/examples)\n  * Add in the Watson Language Translation service\n  * Add in the Watson Tone Analyzer service\n* Incorporate an API (Weather, Calendar, Github, etc.)\n* Have Watson tell you a joke\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkostickm%2Fwatsonbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkostickm%2Fwatsonbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkostickm%2Fwatsonbot/lists"}