Telethon 移除 Telegram 消息中图片内容的教程

from telethon.sync import TelegramClient
from telethon.tl.types import Message

# 替换为你的 API 凭据和电话号码
API_ID = 'YOUR_API_ID'
API_HASH = 'YOUR_API_HASH'
PHONE_NUMBER = 'YOUR_PHONE_NUMBER' # 格式如 '+8612345678901'

# 初始化 Telethon 客户端
# 'session_name' 是会话文件的名称，用于保存登录状态
client = TelegramClient('session_name', API_ID, API_HASH)

async def remove_image_from_message(chat_entity, message_id: int):
    """
    从指定聊天中删除一条包含图片的消息。

    Args:
        chat_entity: 聊天实体（可以是群组/频道/用户 ID 或用户名）。
        message_id (int): 要删除的消息的 ID。
    """
    try:
        # 启动客户端连接
        await client.start(phone=PHONE_NUMBER)

        # 获取指定消息
        # chat_entity 可以是整数（chat_id），字符串（用户名或频道名），或 Telegram Entity 对象
        messages = await client.get_messages(chat_entity, ids=message_id)

        if not messages:
            print(f"错误：未找到 ID 为 {message_id} 的消息。")
            return

        message: Message = messages[0] # get_messages 返回一个列表

        # 检查消息是否包含媒体（图片、视频等）
        if message.media:
            await client.delete_messages(chat_entity, message_id)
            print(f"成功删除 ID 为 {message_id} 的消息，其中包含图片。")
        else:
            print(f"ID 为 {message_id} 的消息不包含图片。")

    except Exception as e:
        print(f"删除消息时发生错误: {e}")
    finally:
        # 确保客户端连接被关闭
        await client.disconnect()

async def main():
    """主函数，用于执行消息删除操作。"""
    # 替换为实际的聊天 ID 或用户名
    # 例如：-1001234567890 (频道ID), 123456789 (用户ID), 'my_group_username' (群组/频道用户名)
    target_chat = 'YOUR_CHAT_ID_OR_USERNAME'
    target_message_id = 123 # 替换为实际要删除的消息 ID

    await remove_image_from_message(target_chat, target_message_id)

if __name__ == '__main__':
    # 运行主函数
    client.loop.run_until_complete(main())

async def replace_message_media_with_text(chat_entity, message_id: int):
    try:
        await client.start(phone=PHONE_NUMBER)
        messages = await client.get_messages(chat_entity, ids=message_id)
        if not messages:
            print(f"错误：未找到 ID 为 {message_id} 的消息。")
            return

        message: Message = messages[0]
        original_text = message.text if message.text else ""

        if message.media:
            await client.delete_messages(chat_entity, message_id)
            print(f"已删除包含媒体的原始消息 ID: {message_id}")
            if original_text:
                await client.send_message(chat_entity, original_text)
                print(f"已重新发送只包含文本的新消息。")
            else:
                print("原始消息没有文本内容，未发送新消息。")
        else:
            print(f"ID 为 {message_id} 的消息不包含图片，无需替换。")
    except Exception as e:
        print(f"替换消息时发生错误: {e}")
    finally:
        await client.disconnect()

# 在 main 函数中调用：
# await replace_message_media_with_text(target_chat, target_message_id)