{"id":21319487,"url":"https://github.com/zoom/vote-chatbot","last_synced_at":"2025-07-12T04:31:55.034Z","repository":{"id":43835698,"uuid":"204079618","full_name":"zoom/vote-chatbot","owner":"zoom","description":"Vote on topics in Zoom Chat","archived":false,"fork":false,"pushed_at":"2022-12-11T03:05:17.000Z","size":58,"stargazers_count":10,"open_issues_count":2,"forks_count":9,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-04-13T19:29:28.870Z","etag":null,"topics":["sample-app"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"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/zoom.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}},"created_at":"2019-08-23T22:46:30.000Z","updated_at":"2023-09-15T17:35:40.000Z","dependencies_parsed_at":"2023-01-26T14:00:24.699Z","dependency_job_id":null,"html_url":"https://github.com/zoom/vote-chatbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fvote-chatbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fvote-chatbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fvote-chatbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fvote-chatbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoom","download_url":"https://codeload.github.com/zoom/vote-chatbot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225795415,"owners_count":17525316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["sample-app"],"created_at":"2024-11-21T19:42:21.535Z","updated_at":"2025-07-12T04:31:55.020Z","avatar_url":"https://github.com/zoom.png","language":"JavaScript","readme":"#### THIS REPO IS DEPRECATED\n\nPlease visit our new [Rivet sample app](https://github.com/zoom/rivet-javascript-sample).\n\n---\n\n# Vote Chatbot for Zoom\n\nUse of this sample app is subject to our [Terms of Use](https://zoom.us/docs/en-us/zoom_api_license_and_tou.html).\n\nThis is a sample Chatbot app using the [Zoom Chatbot NPM Package](https://www.npmjs.com/package/@zoomus/chatbot).\n\n![Vote Chatbot for Zoom](https://camo.githubusercontent.com/873a14b66322dd78683e30f10b07cc8c8ed97f041ecf303a4d4694f8a896f1a0/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f757365722d636f6e74656e742e73746f706c696768742e696f2f31393830382f31353637373938333430353834)\n\nTo run the completed Chatbot code locally or deploy it to a live server, continue reading below.\n\n## Local/Development Setup\n\nTo run the completed Chatbot locally, follow these steps,\n\n1. In terminal:\n\n   `$ git clone https://github.com/zoom/vote-chatbot.git`\n\n   `$ cd vote-chatbot`\n\n   `$ npm install`\n\n   `$ touch .env`\n\n2. Add this code to your `.env` file, replacing the `Required` text with your respective [**Development** Zoom Chatbot API credentials](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#register).\n\n   ```\n   client_id=Required\n   client_secret=Required\n   verification_token=Required\n   bot_jid=Required\n   slash_command=Required\n   ```\n\n3. In terminal:\n\n   `$ npm run start` or `$ nodemon` ([for live reload / file change detection](https://www.npmjs.com/package/nodemon))\n\n   `$ ngrok http 4000` ([ngrok turns localhost into live server](https://ngrok.com/) so slash commands and user actions can be sent to your app)\n\n5. Open your ngrok https url in a browser, you should see this,\n\n   `Welcome to the Vote Chatbot for Zoom!`\n\n6. On your App Marketplace Dashboard, add your ngrok https url to your Whitelist URLs (App Credentials Page), **Development** Redirect URL for OAuth (App Credentials Page), and **Development** Bot Endpoint URL (Features Page). Make sure to match the path after your ngrok https url with the express routes in index.js.\n\n   \u003e In order to click the **Save** button on the Features page when adding a Slash Command and Development Bot Endpoint URL, you have to provide a Production Bot Endpoint URL. Feel free to use https://zoom.us as a placeholder.\n\n   After that, your app is ready to be installed!\n\n7. On your App Marketplace Dashboard, go to the **Local Test** page and click **Install**. After you click the **Authorize** button, you should be taken to your redirect url and see this,\n\n   `Thanks for installing the Vote Chatbot for Zoom!`\n\n\n8. Now that your Chatbot is installed on your Zoom account, go to a Zoom Chat channel and type,\n\n   `/vote Tacos for lunch?`\n\n## Production Setup\n\nTo run the completed Chatbot on a live server, follow these steps,\n\n1. Click the **Deploy to Heroku** Button,\n\n   [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n2. Fill in your [**Production** Zoom Chatbot API credentials](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#register) in the **Config Vars** section.\n\n3. Click **Deploy app**.\n\n4. On your App Marketplace Dashboard, add your Heroku url to your Whitelist URLs (App Credentials Page), **Production** Redirect URL for OAuth (App Credentials Page), and **Production** Bot Endpoint URL (Features Page). Make sure to match the path after your Heroku url with the express routes in index.js.\n\n5. On your App Marketplace Dashboard, go to the **Submit** page and click **Add to Zoom**. After you click the **Authorize** button, you should be taken to your redirect url and see this,\n\n   `Thanks for installing the Vote Chatbot for Zoom!`\n\n6. Now that your Chatbot is installed on your Zoom account, go to a Zoom Chat channel and type,\n\n   `/vote Tacos for lunch?`\n## Need help?\n\nIf you're looking for help, try [Developer Support](https://devsupport.zoom.us) or our [Developer Forum](https://devforum.zoom.us). Priority support is also available with [Premier Developer Support](https://zoom.us/docs/en-us/developer-support-plans.html) plans.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoom%2Fvote-chatbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoom%2Fvote-chatbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoom%2Fvote-chatbot/lists"}