Notion-DiscordBot

KO | EN

gitlite — search

#python #hacktoberfest #go #rust #docker #java #windows #awesome #cli #vue #awesome-list #security #mcp #ios

Notion-DiscordBot

(★ 83)

A discord bot consuming Notion API to add, retrieve data to Notion databases.

Notion-DiscordBot 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Notion-DiscordBot

[![Build Status](https://travis-ci.com/Servatom/Notion-DiscordBot.svg?branch=main)](https://travis-ci.com/Servatom/Notion-DiscordBot)[![Visits Badge](https://badges.pufler.dev/visits/Servatom/Notion-DiscordBot)](https://github.com/Servatom/Notion-DiscordBot/) 
 

<img src="https://i.imgur.com/sSqTu56.png" height="200px">
 
<h3 align="center"> A discord bot consuming Notion API to add and retrieve data from Notion databases. </h3>

## Instructions to use the bot:

Invite the bot using [Bot Invite Link](https://discord.com/api/oauth2/authorize?client_id=859893575227670528&permissions=274877910016&scope=bot) and run `*setup`

To self-host the bot, read [SETUP.md](https://github.com/Servatom/Notion-DiscordBot/blob/main/SETUP.md).
<hr>

### Creating Notion Database:

1. Go to Notion and create a new [Integration](https://www.notion.so/my-integrations).
  Note the internal Integration.

2. Then in Notion create in a new page create a table like this (Tag being optional field):

4 columns where:
- Contributor is of property type Title
- URL of url type
- Title of text type
- Tag of multi-select type

3. Click on the three dots and press Open as page

<img src="https://assets.servatom.com/Notion-DiscordBot/OpenPage.png">
 
 
 
4. Then press share and copy the URL. The URL will look something like this:
https://www.notion.so/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?v=YYYYYYYYYYYYYYYYYYYYYYYYY

Note down the X part of the url (RED part)

This is your database id

5. Also press share again, press Invite and then click on the integration you made earlier

## Bot Usage:

1. [Setup](https://github.com/Servatom/Notion-DiscordBot#setup-bot)
2. [Add Record](https://github.com/Servatom/Notion-DiscordBot#adding-record)
3. [Search](https://github.com/Servatom/Notion-DiscordBot#searching-record-through-tags)
4. [Delete](https://github.com/Servatom/Notion-DiscordBot#deleting-record-through-tags)
5. [Upload Files](https://github.com/Servatom/Notion-DiscordBot#uploading-files)
6. [Change Prefix](https://github.com/Servatom/Notion-DiscordBot#changing-prefix)

### Setup Bot:
Run `*setup` command and enter notion api key (the one you got after creating integration) and notion database id.

### Adding Record:

```*add <URL_YOU_WANT_TO_RECORD>``` => This will add a new record to your database (if tagging is enabled, it will add a `misc` tag)

```*add <URL_YOU_WANT_TO_RECORD> <TAG>``` => This will add a new record to your database with the ```<TAG>``` tag

For multiple tags:
```*add <URL_YOU_WANT_TO_RECORD> <TAG>,<TAG1>,<TAG2>```

Example: 
<img src="https://assets.servatom.com/Notion-DiscordBot/add.jpeg" width="60%">

Sample database populated by the bot:

### Searching Record through tags:
```*search <Tag1>```

For multiple tags: ```/search <Tag1> <Tag2>.....<TagN>```

### Searching Record through title:
```*title <title>```

Example: 
<img src="https://assets.servatom.com/Notion-DiscordBot/search.jpeg" width="60%">

### Deleting Record through tags:
```*delete <Tag 1>```

For multiple tags: ```*delete <Tag 1> <Tag2>......<Tag N>```

### Deleting Record through title:
```*delete <title>```

Example: 
<img src="https://assets.servatom.com/Notion-DiscordBot/delete.jpeg" width="60%">

### Uploading files
NOTE: In the below images the prefix used is: ```*```

You can upload any file to the notion database. It can be a pdf, png, jpeg etc. 
Here a png file is being uploaded 
1. Drag your file to the chat in discord, add comment to the file you uploaded

<img src="https://assets.servatom.com/Notion-DiscordBot/upload1.jpeg" width="60%"> 
Here `servatom` is tag for the file.

2. It will then ask the title of the file you uploaded:

3. The database will be updated:

### Changing Prefix
To change the bot prefix, type `*prefix`, `*` being the deault prefix.

<hr>

:mortar_board: All maintainers in this project are under-graduate students in the <a href="https://csed.thapar.edu">Department of
Computer Science and Engineering, TIET</a> @ <a href="https://www.thapar.edu/">Thapar University</a>

:boy: Raghav Sharma 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Email: <a>raghav.sharma17@outlook.com</a> 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; GitHub: <a href="https://github.com/raghavTinker">@raghavTinker</a> 
 
 :woman: Rupanshi Jain 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Email: <a>jainrupanshi@outlook.com</a> 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; GitHub: <a href="https://github.com/rdotjain">@rdotjain</a> 
 
 Special thanks to <a href="https://github.com/animesh-007/">Animesh Gupta </a> for giving us better ideas to make this project better and for spreading the word.

Notion-DiscordBot

Notion-DiscordBot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Notion-DiscordBot

Notion-DiscordBot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README