{"id":15859596,"url":"https://github.com/nvuillam/slackbot-lelamanul","last_synced_at":"2026-05-07T08:38:37.432Z","repository":{"id":95910941,"uuid":"136704405","full_name":"nvuillam/slackbot-lelamanul","owner":"nvuillam","description":"Team slackbot integrating with Jenkins , GitHub , JIRA, and allowing to manage teaam vacations / absences","archived":false,"fork":false,"pushed_at":"2023-12-15T08:49:01.000Z","size":132,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-07T13:15:10.165Z","etag":null,"topics":["botkit","github","jenkins","jira","quizz","sickleave","slackbot","trivia","vacations"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nvuillam.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},"funding":{"github":["nvuillam"]}},"created_at":"2018-06-09T08:18:43.000Z","updated_at":"2019-05-16T12:56:13.000Z","dependencies_parsed_at":"2023-04-27T20:16:14.671Z","dependency_job_id":null,"html_url":"https://github.com/nvuillam/slackbot-lelamanul","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/nvuillam%2Fslackbot-lelamanul","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fslackbot-lelamanul/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fslackbot-lelamanul/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fslackbot-lelamanul/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nvuillam","download_url":"https://codeload.github.com/nvuillam/slackbot-lelamanul/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246705959,"owners_count":20820783,"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":["botkit","github","jenkins","jira","quizz","sickleave","slackbot","trivia","vacations"],"created_at":"2024-10-05T21:21:52.155Z","updated_at":"2026-05-07T08:38:37.377Z","avatar_url":"https://github.com/nvuillam.png","language":"JavaScript","funding_links":["https://github.com/sponsors/nvuillam"],"categories":[],"sub_categories":[],"readme":"# Le lama NUL SlackBot\n\nThis botkit-based slackbot allows your team to use a slack instance as a single entry point to various useful tools\n\n- **GitHub**\n- **Jenkins**\n- **Jira**\n\nIt contains also lots of functions ... some more useful than others !\n\n- **Vacations** / Sick leave tracking : use the bot to request vacations, and authorized members can validate or reject them\n- **Games** for coffee breaks: **Quizz** and **Trivia** ( If you are a nazi, you can of course deactivate them )\n\nFeel free to contribute :)\n\n\n## Commands\n\n- **GENERAL**\n\n  - **help** : Provide help for lamanul bot\n\n----------\n\n- **GITHUB**\n\n  - **members** : List members of GIT_ORG\n  - **pull requests** : List open pull requests of GIT_ORG/GIT_MAIN_REPO\n  - **search code** _CODE_ : Search in GIT_MAIN_REPO code (ex: _search code Membership_m_ )\n  - **search doc** _KEYWORDS_ : Search in GIT_ORG doc (ex: _search doc Installation pre-requisites_ )\n  - **repos** : List repos of GIT_ORG\n  - **teams** : List teams of GIT_ORG\n\n----------\n\n- **JENKINS**\n\n  - **jobs** : List all jenkins jobs of JENKINS_MAIN_VIEW\n  - **running jobs** : List all currently running jobs  \n  - **build** _JOB_NAME_ : Launch a build for the job name specified ( ex: _build DXCO4SF-1150-TST-DevRootOrg_ )\n\n----------\n\n- **JIRA**\n\n  - **current sprint** : List open issues of the current sprint\n  - **issues of** _@USER_ : List open issues of a user\n  - **my issues**  : List your open issues\n\n----------\n\n- **ABSENCES / VACATIONS / SICK LEAVE**\n\n  - **absences** _(optional) @USER_ : List current and future absences \n  - **past absences** _(optional) @USER_ : Display past absences \n  - **my absences** : List current and future absences \n  - **my past absences** : Display past absences\n  - **add absences validator** _@USER_ : Adds an absence validator\n  - **remove absences validator** _@USER_ : Removes an absence validator\n\n----------\n\n- **MISC**\n\n  - **tell** _EXPRESSION_ : Retrieves value corresponding to expression (stored using remember command )\n  - **learn** _EXPRESSION_=_VALUE_ : Stores value corresponding to expression\n  - **start quizz** : Launch an interactive quizz in the channel ( https://opentdb.com database )\n  - **start trivia** : Launch an interactive trivia in the channel ( http://jservice.io database )\n\n\n## Installation\n\n### Create a slack app\n\n- Create a new app on https://api.slack.com/\n\n  - Interactive components: https://YOURAPPNAME.herokuapp.com/slack/receive (can be done after next step)\n\n  - OAuth \u0026 Permissions\n\n  \t- Callback URL: https://YOURAPPNAME.herokuapp.com/oauth (can be done after next step) \n      \n  \t- Permission scopes:\n      \n      - bot\n      - channels:write \n      - chat:write:bot\n      - incoming-webhook \n      - users:read\n      - users:read.email\n      - users.profile:read\n\n - Activate bot user\n\n### Deploy this repo on Heroku\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/nvuillam/slackbot-lelamanul)\n\n- Free heroku dyno will be fine\n\n- Define the following environment variable in Heroku app\n\n  - SLACK / BOTKIT / STORAGE\n    - **MY_HOST** : Your app current host (ex: https://YOURAPPNAME.herokuapp.com )\n    - **token**: Slack bot token ( ex: dfh54dg56hf46ggh64fg56gh564fg46fh)\n    - **CLIENT_ID** : Slack App client Id (ex: 424298597.3788425242061) \n    - **CLIENT_SECRET** : Slack App client secret (ex: 54575272754f2bb0468105513e60) \n    - **PORT** : Your bot port (ex: 8765)\n    - **MONGOLAB_URI** : URI of a mongo database (ex: mongodb://someuser:somepassword@ds2514444.mlab.com:55260/slackbot-lelamanul )\n      - You can use mlab.com free 500mb database if you do not have a mongodb database\n\n  - GitHub\n    - **GIT_USERNAME** : Your github username ( ex: nvuillam )\n    - **GIT_PASSWORD** : Your github password or token ( ex: dfdgdhgh6d46fg4h6fgfg6 )\n    - **GIT_ORG** : Your main github organization  (ex: Omnichannel-for-Salesforce )\n    - **GIT_MAIN_REPO** : Your main github repository , containing source code. ( ex: DXCO4SF_Sources )\n\n  - Jenkins\n    - **JENKINS_HOST** : Your jenkins instance host ( ex: jenkins.mydomain.com:8080 )\n    - **JENKINS_USERNAME** : Your jenkins username (ex: nvuillam )\n    - **JENKINS_PASSWORD** : Your jenkins password or token ( ex: df46d4h6fg4h6fg4h6fg6 )\n    - **JENKINS_MAIN_VIEW** : Your Jenkins main view ( ex: DXC-OmniChannel-for-Salesforce )\n\n  - Jira\n    - **JIRA_HOST** : Your JIRA instance host ( ex: jira.mydomain.com )\n    - **JIRA_USERNAME** : Your JIRA username ( ex: nvuillam )\n    - **JIRA_PASSWORD** : Your JIRA password or token ( ex: dffgdg5dfg5df5g5 )\n    - **JIRA_MAIN_PROJECT_NAME** : Your JIRA main project name ( ex: Cloud IRM )\n\n  - Miscellaneous\n    - **ACTIVATE_QUIZZ** : Activate quizz \u0026 trivia commands\n    \n  - Email notifications\n    - **ABSENCES_SENDER_EMAIL_SERVICE** : Email service for nodemailer package\n    - **ABSENCES_SENDER_EMAIL_ADDRESS** : Email address sending the mails\n    - **ABSENCES_SENDER_EMAIL_USERNAME** : Username for mailing service ( if not set, ABSENCES_SENDER_EMAIL_ADDRESS will be used )\n    - **ABSENCES_SENDER_EMAIL_PASSWORD** : Password token for E-mail service\n\n### Add lelamanul to your slack workspace\n\n- Open https://YOURAPPNAME.herokuapp.com/login in a web browser\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvuillam%2Fslackbot-lelamanul","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnvuillam%2Fslackbot-lelamanul","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvuillam%2Fslackbot-lelamanul/lists"}