python-trueconf-bot 1.4.4__tar.gz → 1.5.1__tar.gz

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/.gitignore

@@ -98,7 +98,7 @@ ipython_config.py
 #   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#uv.lock
+uv.lock
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
@@ -182,7 +182,11 @@ trueconf/_version.py
 .idea
 .workfiles
 *.DS_Store
+graphify-out
+.agents
+
 
 .venv*
 venv*
-/gitignore/
+/gitignore/
+.superpowers/superpowers/

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.4.4
+Version: 1.5.1
 Summary: Lightweight and powerful framework for the TrueConf Server Chatbot API
 Author-email: TrueConf LLC <info@trueconf.com>, Anton Baadzhi <baadzhianton@gmail.com>
 License-Expression: BSD-3-Clause-Clear
@@ -24,13 +24,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: websockets
-Requires-Dist: httpx
-Requires-Dist: mashumaro
+Requires-Dist: httpx2>=2.13.0
+Requires-Dist: mashumaro>=3.23
 Requires-Dist: aiofiles
 Requires-Dist: magic-filter
 Requires-Dist: aiohttp
 Requires-Dist: async-property
-Requires-Dist: typing_extensions>=4.15.0
+Requires-Dist: typing_extensions>=4.16.0
 Requires-Dist: python-magic>=0.4.27; sys_platform != "win32"
 Requires-Dist: python-magic-bin==0.4.14; sys_platform == "win32"
 Requires-Dist: filetype
@@ -100,9 +100,10 @@ uv add python-trueconf-bot
 
 | TrueConf Server Version | Required Library Version |
 |:------------------------|:-------------------------|
-| < 5.5.0                 | ❌ Not supported          |
+| < 5.5.0                 | ❌ Not supported         |
 | 5.5.0 — 5.5.2           | v1.1.x                   |
-| >= 5.5.3                | **v1.2.1** (or higher)   |
+| 5.5.3 — 5.5.5           | v1.2.1-1.4.x             |
+| >= 5.5.6                | **v1.5.0** (or higher)   |
 
 ## 📌 Key Features
 

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/README-PyPI.md

@@ -60,9 +60,10 @@ uv add python-trueconf-bot
 
 | TrueConf Server Version | Required Library Version |
 |:------------------------|:-------------------------|
-| < 5.5.0                 | ❌ Not supported          |
+| < 5.5.0                 | ❌ Not supported         |
 | 5.5.0 — 5.5.2           | v1.1.x                   |
-| >= 5.5.3                | **v1.2.1** (or higher)   |
+| 5.5.3 — 5.5.5           | v1.2.1-1.4.x             |
+| >= 5.5.6                | **v1.5.0** (or higher)   |
 
 ## 📌 Key Features
 

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/README-ru.md

@@ -59,11 +59,13 @@ uv add python-trueconf-bot
 
 
 ## 📦 Совместимость версий
+
 | Версия сервера TrueConf | Требуемая версия библиотеки |
 |:------------------------|:----------------------------|
-| < 5.5.0                 | ❌ Не поддерживается         |
+| < 5.5.0                 | ❌ Не поддерживается        |
 | 5.5.0 — 5.5.2           | v1.1.x                      |
-| \>= 5.5.3               | **v1.2.1** (или выше)       |
+| 5.5.3 — 5.5.5           | v1.2.1-1.4.x                |
+| >= 5.5.6                | **v1.5.0** (или выше)       |
 
 ## 📌 Ключевые возможности
 

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/README.md

@@ -60,13 +60,14 @@ Or with `uv` (recommended):
 uv add python-trueconf-bot
 ```
 
-## 📦  Compatibility
+## 📦 Version Compatibility
 
 | TrueConf Server Version | Required Library Version |
 |:------------------------|:-------------------------|
-| < 5.5.0                 | ❌ Not supported          |
+| < 5.5.0                 | ❌ Not supported         |
 | 5.5.0 — 5.5.2           | v1.1.x                   |
-| >= 5.5.3                | **v1.2.1** (or higher)   |
+| 5.5.3 — 5.5.5           | v1.2.1-1.4.x             |
+| >= 5.5.6                | **v1.5.0** (or higher)   |
 
 ## 📌 Key Features
 

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/docs/en/examples/index.md

@@ -60,25 +60,24 @@ logging.basicConfig(
     encoding="utf-8",
 )
 
+
 @asynccontextmanager
 async def lifespan(app: FastAPI):
     bot_task = asyncio.create_task(bot.run())
     yield
 
+
 app = FastAPI(lifespan=lifespan)
-bot = Bot.from_credentials(
-    server="10.140.1.255",
-    username="echo_bot",
-    password="123tr",
-    verify_ssl=False)
+bot = Bot.from_credentials(server="10.140.1.255", username="echo_bot", password="123tr", verify_ssl=False)
 
 
 @app.post("/send")
 async def read_root(data: dict[str, Any]):
     r = await bot.create_personal_chat(user_id="user")
-    r = await bot.send_message(chat_id = r.chat_id, text=str(data))
+    r = await bot.send_message(chat_id=r.chat_id, text=str(data))
     print(r.message_id)
 
+
 if __name__ == "__main__":
     uvicorn.run(app, host="0.0.0.0", port=8000)
 ```
@@ -114,6 +113,7 @@ logging.basicConfig(
     encoding="utf-8",
 )
 
+
 async def main():
     await bot.start()
     await bot.connected_event.wait()
@@ -132,6 +132,7 @@ async def main():
 
     await bot.shutdown()
 
+
 if __name__ == "__main__":
     asyncio.run(main())
 ```
@@ -174,12 +175,9 @@ router_list_for_report = {}
 list_message_for_report = {}
 
 bot = trueconf.Bot.from_credentials(
-    server="10.110.2.241",
-    username="report_bot",
-    password="123tr",
-    dispatcher=dp,
-    https=True,
-    verify_ssl=False)
+    server="10.110.2.241", username="report_bot", password="123tr", dispatcher=dp, https=True, verify_ssl=False
+)
+
 
 async def handle_report(msg: Message):
     if msg.from_user.id in router_list_for_report.keys():
@@ -189,7 +187,7 @@ async def handle_report(msg: Message):
 
 @r1.message(Command("report"))
 async def on_report(msg: Message):
-    number = uuid.uuid4() # генерация номера обращения с помощью uuid
+    number = uuid.uuid4()  # генерация номера обращения с помощью uuid
     await msg.answer(f"Your ticket number is {number}. All subsequent messages will be added to this ticket.")
     r = Router(name=str(number))
     dp.include_router(r)
@@ -212,7 +210,7 @@ async def on_cancel(msg: Message):
         await msg.answer("You don’t have an active report.")
 
 
-def build_message_and_send_email(messages:list):
+def build_message_and_send_email(messages: list):
     """
     In Python, there are built-in libraries for working with email messages:
     https://docs.python.org/3/library/email.examples.html
@@ -226,12 +224,13 @@ def build_message_and_send_email(messages:list):
                 # You can put the text into the email body
             case MessageType.ATTACHMENT:
                 # Download the files from TrueConf Server via:
-                # msg.download(dest_path="path/to/file")
+                # msg.download(file_path="path/to/file")
 
     Once the email is assembled correctly, send it using the smtplib module:
     https://docs.python.org/3/library/smtplib.html#smtp-example
     """
 
+
 @r1.message(Command("send"))
 async def send_report(msg: Message):
     if msg.from_user.id in router_list_for_report.keys():
@@ -243,6 +242,7 @@ async def send_report(msg: Message):
         await msg.answer("You don’t have an active report.")
         return
 
+
 if __name__ == "__main__":
     asyncio.run(bot.run())
 ```
@@ -411,6 +411,7 @@ bot = Bot.from_credentials(
 )
 
 import asyncio
+
 if __name__ == "__main__":
     asyncio.run(bot.run())
 ```
@@ -424,4 +425,3 @@ Execution order for each message:
 4. Handler                            — cmd_start or echo
 ```
 
-

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/docs/en/features.md

@@ -29,13 +29,15 @@ from trueconf.filters import F
 
 router = Router()
 
+
 @router.message(F.text.startswith("/start"))
 async def on_start(msg: Message):
-  await msg.answer("Hello! I'm TrueConf bot 👋")
+    await msg.answer("Hello! I'm TrueConf bot 👋")
+
 
 @router.message(F.document.mime_type == "application/pdf")
 async def on_pdf(msg: Message):
-  await msg.reply("Thanks for the PDF!")
+    await msg.reply("Thanks for the PDF!")
 ```
 
 ## Two Connection Options
@@ -78,6 +80,7 @@ Exactly the same as in aiogram:
 @router.message(F.photo)
 async def on_photo(msg: Message): ...
 
+
 @router.message(F.document.mime_type.in_(["application/pdf", "application/msword"]))
 async def on_doc(msg: Message): ...
 ```

{python_trueconf_bot-1.4.4 → python_trueconf_bot-1.5.1}/docs/en/index.md

@@ -25,7 +25,7 @@ This library is designed to simplify the development of chatbots by providing re
 ### Requirements
 
 * Python **3.10+**
-* Installed dependencies: `websockets`, `httpx`, `mashumaro`, `pillow`, `aiofiles`, `magic-filter`
+* Installed dependencies: `websockets`, `httpx2`, `mashumaro`, `pillow`, `aiofiles`, `magic-filter`
 * It is recommended to use [virtualenv](https://docs.python.org/3/library/venv.html) or [poetry](https://python-poetry.org/) for dependency isolation.
 
 ### Installation using pip
@@ -51,4 +51,4 @@ pip install {{product_name}}
 ## LLM Files
 
 - [llms.txt](llms.txt)
-- [llms-full.txt](llms-full.txt)
+- [llms-full.txt](llms-full.txt)

python_trueconf_bot-1.5.1/docs/en/learn/authentication.md

@@ -0,0 +1,103 @@
+---
+title: Authentication
+description: 'Bot authentication methods: token, login and password, and OAuth2'
+icon: material/key
+---
+
+# Authentication
+
+The library supports three ways to authenticate a bot on TrueConf Server:
+
+| Method | API | When to use it |
+| --- | --- | --- |
+| Token | `Bot(server, token=...)` | You already have a token obtained manually or through the API |
+| Login and password | `Bot.from_credentials(...)` | Login and password authentication is enabled on the server |
+| OAuth2 | `Bot.from_oauth(...)` | Login and password authentication is disabled on the server |
+
+## Token authentication
+
+Obtain a token as described in the [official API documentation](https://trueconf.com/docs/chatbot-connector/en/connect-and-auth/#access-token).
+
+We recommend storing the token in an environment variable or a `.env` file. If you use a public repository, remember to add `.env` to `.gitignore`.
+
+```python
+from os import getenv
+
+TOKEN = getenv("TOKEN")
+bot = Bot(server="video.example.com", token=TOKEN, dispatcher=dp)
+```
+
+!!! note
+    A token is valid for one month from the time it is created.
+    However, an authenticated connection remains active until it is closed, even after the token expires.
+    In theory, such a connection can remain active for years.
+
+## Login and password authentication
+
+The `Bot.from_credentials()` method authenticates the bot with a login and password:
+
+```python
+bot = Bot.from_credentials(
+    username="echo_bot",
+    password="123tr",
+    server="video.example.com",
+    dispatcher=dp,
+)
+```
+
+!!! info
+    Every call to **from_credentials()** requests a new token from the server.
+    Each token is valid for one month.
+
+The main parameters after `password` are keyword-only:
+
+| Parameter | Type | Default | Description |
+| --- | --- | --- | --- |
+| `dispatcher` | `Dispatcher` | `None` | Dispatcher used to register handlers |
+| `receive_unread_messages` | `bool` | `False` | Whether to receive messages that arrived while the bot was offline |
+| `receive_system_messages` | `bool` | `False` | Whether to receive system messages |
+| `skip_self_messages` | `bool` | `True` | Whether to ignore messages sent by the bot itself |
+| `verify_ssl` | `bool | str | ssl.SSLContext` | `True` | SSL certificate verification settings |
+| `https` | `bool` | `True` | Whether to use HTTPS |
+| `web_port` | `int` | `None` | WebSocket port (`443` with HTTPS and `4309` without HTTPS by default) |
+| `ws_max_retries` | `int` | `5` | Maximum number of connection attempts after network errors |
+| `ws_max_delay` | `int` | `60` | Maximum delay between connection attempts, in seconds |
+| `timeout` | `float | int` | `10.0` | Server response timeout |
+| `on_health_check` | `Callable` | `None` | Callback invoked when the connection state changes |
+
+For the complete parameter list, see the [`Bot.from_credentials()` reference](../reference/Bot.md/#trueconf.Bot.from_credentials).
+
+If login and password authentication is disabled on the server, the method raises `PasswordAuthDisabledError`. Use `Bot.from_oauth()` instead.
+
+## OAuth2 authentication
+
+If login and password authentication is disabled on the server for security reasons, the bot cannot use `from_credentials()`. It does not support authentication through NTLM, Kerberos, other SSO protocols, or MFA.
+
+In this case, create an OAuth application on the server and authenticate the bot with `Bot.from_oauth()`. In addition to the login and password, you need the application's `client_id`:
+
+```python
+bot = Bot.from_oauth(
+    username="elisa",
+    password="123tr",
+    client_id="application_client_id",
+    server="video.example.com",
+    dispatcher=dp,
+)
+```
+
+Requirements:
+
+- TrueConf Server 5.5.3 or later;
+- an OAuth application created on the server;
+- at least one scope configured for the application. The `version:read` scope is sufficient and does not expose sensitive information. A token cannot be obtained for an application without a scope.
+
+`Bot.from_oauth()` accepts the same parameters as `from_credentials()` and additionally requires `client_id`. See the [`Bot.from_oauth()` reference](../reference/Bot.md/#trueconf.Bot.from_oauth).
+
+### Authentication errors
+
+| Exception | When it occurs | What to do |
+| --- | --- | --- |
+| `PasswordAuthDisabledError` | The server rejects the token request with `403 auth_method_disabled` because login and password authentication is disabled | Use `Bot.from_oauth()` |
+| `OAuthMissingScopeError` | The server rejects the OAuth token request with `400 invalidScope` because the OAuth application has no configured scope | Add a scope, such as `version:read`, to the application settings on the server |
+
+Both exceptions inherit from `TrueConfChatBotError` and can be imported from `trueconf.exceptions`. For details, see the [exceptions reference](../reference/Exceptions.md).

python_trueconf_bot-1.5.1/docs/en/learn/buttons.md

@@ -0,0 +1,301 @@
+---
+title: Interactive Buttons
+description: How to add inline buttons to a message and handle commands from them
+icon: material/gesture-tap-button
+---
+
+# Interactive Buttons
+
+Inline buttons appear below a message and let users interact with a bot without typing: they can choose a command, open a link, send prepared text, or copy data.
+
+We will start with one button, then build a menu and handle button clicks.
+
+!!! info "Requirements"
+    - TrueConf Server 5.5.6 or later;
+    - TrueConf for Windows, macOS, and Linux 8.6.0 or later;
+    - TrueConf for Android 3.3.0 or later;
+    - TrueConf for iOS 4.2.0 or later.
+
+!!! caution
+    Buttons can only be attached to plain text messages, and only chatbots can send messages with buttons.
+
+For a complete description of the button format at the WebSocket API level, see the [TrueConf Server API documentation](https://trueconf.com/docs/chatbot-connector/en/buttons/).
+
+## Your First Button
+
+Create a button with `InlineKeyboardButton` and a keyboard with `InlineKeyboardMarkup`:
+
+```python
+from trueconf import InlineKeyboardButton, InlineKeyboardMarkup
+
+keyboard = InlineKeyboardMarkup(
+    buttons=[
+        [InlineKeyboardButton(text="Help", command="menu:help")],
+    ]
+)
+```
+
+Here, `text` is the button label and `command` is the command the bot receives when the button is clicked.
+
+The `buttons` parameter contains a list of rows. This means that even a single button requires two nested lists: the outer list defines the keyboard, and the inner list defines its first row.
+
+Pass the keyboard to the `buttons` parameter when sending a message:
+
+```python
+await bot.send_message(
+    chat_id="chat_id",
+    text="Choose an action:",
+    buttons=keyboard,
+)
+```
+
+You can also pass a keyboard to `message.answer(...)` and `message.reply(...)`.
+
+!!! tip
+    If several handlers use the same keyboard, create it once at module level and pass it to the methods that need it.
+
+## Button Actions
+
+The previous example used a `command` button, which sends a command to the bot. The library supports four actions, and each button must specify exactly one of them:
+
+| Parameter | What happens when the button is clicked |
+| --- | --- |
+| `command` | The bot receives a `CallbackQuery` event; no message is posted to the chat |
+| `url` | Opens a link using the `http`, `https`, `mailto`, or `trueconf` scheme |
+| `message` | Sends the prepared message on behalf of the user |
+| `copy_data` | Copies the specified data to the clipboard |
+
+You can arrange buttons in multiple rows:
+
+```python
+from trueconf import ButtonStyle, InlineKeyboardButton, InlineKeyboardMarkup
+
+keyboard = InlineKeyboardMarkup(
+    buttons=[
+        [
+            InlineKeyboardButton(
+                text="Help",
+                command="menu:help",
+                style=ButtonStyle.PRIMARY,
+            ),
+            InlineKeyboardButton(
+                text="Open website",
+                url="https://trueconf.com",
+            ),
+        ],
+        [
+            InlineKeyboardButton(
+                text="Prepare a question",
+                message="Tell me more",
+                draft=True,
+            ),
+            InlineKeyboardButton(
+                text="Copy code",
+                copy_data="code-42",
+            ),
+        ],
+    ]
+)
+```
+
+In this example:
+
+- `Help` sends the `menu:help` command to the bot;
+- `Open website` opens a link;
+- `Prepare a question` places text in the input field because `draft=True`;
+- `Copy code` copies the `code-42` string.
+
+If `draft=True` is omitted from a `message` button, the prepared text is sent to the chat immediately on behalf of the user.
+
+!!! tip
+    The `text` parameter is required for every action except `url`. If a URL button has no label, the client displays the URL itself.
+
+!!! caution
+    Only a `command` button sends an event to the bot. The client application handles `url`, `message`, and `copy_data` buttons, so clicking them does not create a `CallbackQuery`.
+
+## Additional Parameters
+
+When the basic action is not enough, use additional parameters to customize the button's behavior and appearance:
+
+| Parameter | Available for | Purpose |
+| --- | --- | --- |
+| `style` | All buttons | Sets `ButtonStyle.DEFAULT`, `ButtonStyle.PRIMARY`, `ButtonStyle.DANGER`, or `ButtonStyle.SUCCESS` |
+| `button_id` | All buttons | Sets the button identifier; for a `command` button, it is included in the click event |
+| `draft` | `message` only | Places text in the input field instead of sending it immediately |
+| `custom_data` | `command` only | Sends additional data to the bot together with the command |
+| `to` | `command` only | Directs the command to another bot |
+
+For example, `custom_data` can carry the identifier of a selected object separately from the command:
+
+```python
+button = InlineKeyboardButton(
+    text="Add to cart",
+    command="cart:add",
+    custom_data="product-42",
+    button_id="add-product",
+)
+```
+
+!!! warning
+    The `wait_reply=True` parameter and the `CallbackQuery.answer()` method cannot be used yet because TrueConf client applications do not currently support this scenario. The library therefore raises `NotImplementedError` when they are used.
+
+## Handling a Command
+
+After the user clicks a `command` button, the bot receives a `CallbackQuery` object. Register a `@router.callback_query()` handler and add a filter for the command value:
+
+```python
+from trueconf import CallbackQuery, F, Router
+
+router = Router()
+
+
+@router.callback_query(F.command == "menu:help")
+async def show_help(callback: CallbackQuery):
+    await callback.edit_message(text="Help", buttons=help_keyboard)
+```
+
+The `F.command == "menu:help"` filter ensures that the handler responds only to the intended button. For a group of related commands, use a common prefix and an `F.command.startswith(...)` filter:
+
+```python
+@router.callback_query(F.command.startswith("menu:"))
+async def handle_menu(callback: CallbackQuery):
+    ...
+```
+
+The click data is available through the properties of the `CallbackQuery` object:
+
+- `callback.command` — the command of the clicked button;
+- `callback.custom_data` — the data from `custom_data`;
+- `callback.message` — the message containing the button;
+- `callback.chat` — the chat in which the button was clicked;
+- `callback.command_source.button_id` — the `button_id` value, if specified.
+
+## Updating a Menu After a Click
+
+Buttons are often used for navigation: the user opens a section, and the bot changes the message text and displays a new set of actions. From a callback handler, use `callback.edit_message(...)`:
+
+```python
+@router.callback_query(F.command == "menu:catalog")
+async def show_catalog(callback: CallbackQuery):
+    await callback.edit_message(
+        text="Choose a category:",
+        buttons=catalog_keyboard,
+    )
+```
+
+You can update the text and keyboard independently:
+
+```python
+# Update only the text and keep the current buttons
+await callback.edit_message(text="New text")
+
+# Update only the buttons and keep the current text
+await callback.edit_message(buttons=new_keyboard)
+
+# Update the text and buttons together
+await callback.edit_message(
+    text="New text",
+    buttons=new_keyboard,
+)
+
+# Remove the buttons and keep the current text
+await callback.edit_message(buttons=None)
+```
+
+If the `buttons` parameter is omitted, the current buttons are preserved. To remove them, explicitly pass `buttons=None`.
+
+To edit a message outside a `CallbackQuery` handler, use `bot.edit_message(...)`. In this case, you must provide the message text:
+
+```python
+await bot.edit_message(
+    message_id="message_id",
+    text="Updated text",
+    buttons=new_keyboard,
+)
+```
+
+## Getting a Message Keyboard
+
+The keyboard of a received text message is available through `TextContent.buttons`:
+
+```python
+message = await bot.get_message_by_id(message_id)
+
+if message.content.buttons is not None:
+    keyboard = message.content.buttons
+```
+
+## Restrictions
+
+Observe the following restrictions when creating a keyboard:
+
+- no more than 8 rows and 8 buttons per row;
+- no more than 64 buttons in a keyboard;
+- `text` must contain 1 to 32 characters when a label is provided;
+- `command` must contain 1 to 255 ASCII characters;
+- `custom_data` must contain 1 to 4096 ASCII characters;
+- `copy_data` must contain 1 to 4095 Unicode characters;
+- `url` must contain 8 to 8095 ASCII characters;
+- HTML and Markdown in button labels are not processed, and line breaks are replaced with spaces.
+
+## Complete Example
+
+!!! tip "Ready-to-use bots"
+    More ready-to-use button scenarios are available in the [examples on GitHub](https://github.com/TrueConf/python-trueconf-bot/tree/master/examples/buttons_bot.py).
+
+This bot sends a menu in response to the `/menu` command and then handles the `Say hello` button:
+
+```python
+import asyncio
+
+from trueconf import (
+    Bot,
+    CallbackQuery,
+    Dispatcher,
+    F,
+    InlineKeyboardButton,
+    InlineKeyboardMarkup,
+    Message,
+    Router,
+)
+from trueconf.filters import Command
+
+router = Router()
+dispatcher = Dispatcher()
+
+MAIN_MENU = InlineKeyboardMarkup(
+    buttons=[
+        [
+            InlineKeyboardButton(text="Say hello", command="menu:hello"),
+            InlineKeyboardButton(text="Open website", url="https://trueconf.com"),
+        ],
+        [InlineKeyboardButton(text="Copy", copy_data="trueconf")],
+    ]
+)
+
+
+@router.message(Command("menu"))
+async def show_menu(message: Message):
+    await message.answer("Choose an action:", buttons=MAIN_MENU)
+
+
+@router.callback_query(F.command == "menu:hello")
+async def say_hello(callback: CallbackQuery):
+    await callback.edit_message(text="Hello!", buttons=MAIN_MENU)
+
+
+async def main():
+    dispatcher.include_router(router)
+
+    bot = Bot.from_credentials(
+        username="echo_bot",
+        password="123tr",
+        server="video.example.com",
+        dispatcher=dispatcher,
+    )
+    await bot.run()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```