No description

Find a file

Kumi 24a095c2d5 feat(bot): enhance room ID resolution for commands Implemented a more robust method for resolving room IDs in bot commands by introducing a `resolve_room_id` function. This helps handle room aliases and formats gracefully, minimizing errors when monitoring, protecting, or unprotecting rooms. This change improves user experience by ensuring accurate room identification based on different input formats. Also added the `resolve_alias` function to assist in resolving room aliases to IDs. Fixes issue with incorrect room handling when commands used aliases or non-standard room identifiers.		2024-11-10 13:17:44 +01:00
.forgejo/workflows	feat: add initial version of Matrix Support Bot	2024-08-18 17:33:56 +02:00
src/matrix_applicationbot	feat(bot): enhance room ID resolution for commands	2024-11-10 13:17:44 +01:00
.gitignore	chore: update .gitignore to include dist/ directory	2024-08-18 18:54:46 +02:00
config.yaml.dist	feat: add initial version of Matrix Support Bot	2024-08-18 17:33:56 +02:00
LICENSE	feat: add initial version of Matrix Support Bot	2024-08-18 17:33:56 +02:00
pyproject.toml	refactor: rename project to matrix-applicationbot	2024-11-08 07:55:29 +01:00
README.md	refactor: rename project to matrix-applicationbot	2024-11-08 07:55:29 +01:00

README.md

Matrix Application Bot

Note: This project is a fork of matrix-supportbot to extend its functionality by handling room join applications. This README needs to be updated to reflect the changes.

Matrix Application Bot is a support ticket bot for the Matrix protocol built using the matrix-nio library. The bot allows users to open support tickets and communicate with support operators in a structured manner. Operators can manage tickets and relay messages between customer-facing and operator-facing rooms.

Features

The bot's state is stored in a Matrix room, so no external database is required.
Users can invite the bot to a direct message (DM) and receive instructions on how to open a support ticket.
Users can open support tickets using the !supportbot openticket command.
The bot creates a new customer-facing room for each ticket and invites the user to it.
Operators are notified of new tickets in a shared operator room.
Operators can join operator-facing rooms for each ticket and communicate with customers.
Messages between customer-facing and operator-facing rooms are relayed by the bot.
Operators can close tickets and list open tickets using bot commands.
Supports relaying of different message types, including text and media.

Commands

User Commands

!supportbot openticket - Opens a new support ticket and creates a customer-facing room.

Operator Commands

!supportbot invite <ticket_id> - Invites an operator to the operator-facing room for the specified ticket.
!supportbot close <ticket_id> - Closes the specified ticket.
!supportbot list - Lists all open tickets.

Installation

Install from PyPI:
```
pip install matrix-supportbot
```

Create a config.yaml file with your Matrix credentials and operator room ID:

homeserver: "https://homeserver.example"
username: "your_username"
password: "your_password"
operator_room_id: "!your_operator_room_id:homeserver.example"

Usage

Run the bot with the following command:

supportbot

The bot will log in to your Matrix server, join the operator room, and start listening for commands and invites.

Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.