My Little Bot

Stack

• Python 3
• Slack Bolt for Python

Requirements

Note

For MLP developper, you can find tokens in our password manager.

For non MLP developper, you need to create your own bot.

Access Tokens

Generate every necessary token required by the bot. It can be found here .env.dist.

To generate them, you can follow the documentation Slack Access tokens.

For Google Maps, please refer to the related documentation https://developers.google.com/maps/documentation/places/web-service/cloud-setup#console. You only need to activate Places API and Places API (new) for now.

Slack Permissions

Socket mode

You need to enabled Socket Mode and accept:

• Interactivity & Shortcuts
• Slash Commands

Slash Commands

Create a slash command named:

• /random-lunch

App-Level Tokens

Scopes:

• connections:write

Bot Token Scopes

Scopes:

• chat:write
• chat:write:public
• commands

Environment variables

Create a .env file from the .env.dist and fill it before running the app.

Development

Running with Docker

docker compose watch

Running Locally

Installation

Create a virtualenv:

python -m venv .venv

Activate it:

source .venv/bin/activate

Install packages:

pip install -r requirements.txt

Running the application

Run the command:

python src/app.py

Interaction

You can use the command /random-lunch to get a restaurant suggestion.