Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bitjerry/Microsoft-365-bot

Manage the Microsoft 365 Global by the telegram bot
https://github.com/bitjerry/Microsoft-365-bot

bot microsoft microsoft-graph microsoft-graph-api microsoft365 microsoft365apps office office-365 office365 python telegram telegram-bot

Last synced: 7 days ago
JSON representation

Manage the Microsoft 365 Global by the telegram bot

Host: GitHub
URL: https://github.com/bitjerry/Microsoft-365-bot
Owner: bitjerry
License: mit
Created: 2022-07-31T06:56:17.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2023-06-02T15:30:32.000Z (over 1 year ago)
Last Synced: 2024-08-02T12:23:19.482Z (3 months ago)
Topics: bot, microsoft, microsoft-graph, microsoft-graph-api, microsoft365, microsoft365apps, office, office-365, office365, python, telegram, telegram-bot
Language: Python
Homepage:
Size: 590 KB
Stars: 31
Watchers: 3
Forks: 14
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Microsoft 365 bot

[![forthebadge](https://forthebadge.com/images/badges/made-with-python.svg)](https://forthebadge.com)

Manage the Microsoft 365 Global by the telegram bot

Read in other languages: English | [简体中文](README.zh_cn.md)

**Features**
- Manage multiple Microsoft 365 global accounts by the bot
- Batch add or export apps
- Add or delete domain names
- Add, delete, check or modify users
- View subscription information, assign or revoke licenses for users
- View organization information
- View role information, assign or revoke roles for users
- Multilingual adaptation
- Functions in Microsoft graph API will be added in the future

---
### 🎉Preview

---

screenshots

[👉More screenshot >>>](docs/en_us/bot.md)

### 🚀Create app

---
>https://aad.portal.azure.com

screenshots

### Permissions

---
> Organization.Read.All, Organization.ReadWrite.All
> RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory
> User.Read.All, User.ReadWrite.All
> Directory.Read.All, Directory.ReadWrite.All
> Directory.AccessAsUser.All

### 🤖Create a Robot

---
@BotFather

screenshots

#### Commands
```
start - Start Robot
log - Get the log of the robot
key -Protect app data
myapp - Specify an app
newapp - Create a new app
clearapp - Clear all app
addapps - Add more apps
exportapps - Batch add app
listdomain - List and manage domain names
adddomain - Add a domain name
getorg - Get organization information
getrole - Get role information
getsub - Get subscription information
getuser - Get user information
getuserbyname - Gets user information (specifies user by username)
searchuser - Get user information (by fuzzy search with username)
addUser - Add a user
cancel - Cancel the current operation
```

### ⚙️Config

---
> Considering one-button deployment, configurations are all in the form of environment variables.

[❓Instructions >>>](docs/en_us/config.md)

### 🥼Runtime

---
- Database: SQL
- python 3.10

### 🔨Deploy

---
#### Heroku Deploy:
[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

#### Others:

[❓Fly.io >>>](docs/en_us/fly_io.md)

[❓VPS >>>](docs/en_us/vps.md)

[❓Docker >>>](docs/en_us/docker.md)

### 🏃Run

---
The bot has two modes of work and does not require manual activation.

1. *webhook*: automatically enabled if a webhook link is configured in an environment variable
2. *polling*: Use this method automatically if you do not configure a webhook link

>We recommend using *webhook* because *polling* constantly pulls out messages to the telegram server, which is relatively resource intensive

### 📝Changelog

- 2.0
- Optimize project structure
- Compatible with all kinds of databases through ORM
- Update database encryption mode
- Add operation password protection
- The operation of manually enabling `webhook` is canceled
- Automatic selection of startup mode
- Operation on domain name
- Batch addition and deletion of apps
- 2.1
- Fix bug
- 2.2
- Add disable/enable function for users
- 2.3
- Improve the management of security keys
- Improve English documents
- Add user interface preview
- Fixed the user module data inconsistency bug
- Optimized code structure, and more detailed comments
- 2.4
- Fix the bug deploy on fly.io by GitHub Action
- 2.5
- Fix the bug for table creating
- Fix the bug that modify app information
- Add the support for docker

### 📖More

- [Security](docs/en_us/security.md)
- [Document](docs/en_us/dev.md)
- [FAQ](docs/en_us/error.md)

### ⚖️License