Telegrammer

Telegram Bot 框架，使用 Swift 5.1 和 SwiftNIO 网络框架编写

Telegrammer 是一个面向 Telegram Bot 开发者的开源框架。它构建于 Apple/SwiftNIO 之上。

加入我们的 Telegram 开发者聊天群，加入我们的 Telegrammer 频道，在 Vapor Discord 服务器 上。

最简单的 Echo Bot 代码如下所示

main.swift

import Foundation
import Telegrammer

do {
    let bot = try Bot(token: "BOT_TOKEN_HERE")

    let echoHandler = MessageHandler { (update, _) in
        _ = try? update.message?.reply(text: "Hello \(update.message?.from?.firstName ?? "anonymous")", from: bot)
    }

    let dispatcher = Dispatcher(bot: bot)
    dispatcher.add(handler: echoHandler)

    _ = try Updater(bot: bot, dispatcher: dispatcher).startLongpolling().wait()
} catch {
    exit(1)
}

• 阅读 开发者官方介绍
• 查看 bot 常见问题解答
• 官方 Telegram Bot API

• 使用模板仓库作为示例 https://github.com/givip/telegrammer-bot-template.git
• 当前仓库包含五个 bot 实现示例：https://github.com/givip/Telegrammer/tree/master/Sources/DemoEchoBot https://github.com/givip/Telegrammer/tree/master/Sources/DemoHelloBot https://github.com/givip/Telegrammer/tree/master/Sources/DemoSchedulerBot https://github.com/givip/Telegrammer/tree/master/Sources/DemoSpellCheckerBot https://github.com/givip/Telegrammer/tree/master/Sources/DemoWebhooksLocally

• 使用 https://github.com/givip/telegrammer-bot-vapor-template.git

1. 在 环境变量 中添加 Telegram Token，因此，创建环境变量

$ export TELEGRAM_BOT_TOKEN='000000000:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'

2. 运行 Bot 可执行文件 scheme 或

$ swift run

EchoBot 源码 使用命令 "/echo" 启动/停止，然后简单地回复你的消息

HelloBot 源码 在群组中向新用户说 "Hello"。使用命令 "/greet" 回复 "hello" 消息

SchedulerBot 源码 演示 Jobs Queue 调度机制。命令 "/start X" 启动一个可重复的任务，该任务会每隔 X 秒向你发送一条消息。命令 "/once X" 将在 X 秒超时后向你发送一次消息。命令 "/stop" 仅为你停止 JobsQueue。其他用户继续接收计划消息。

SpellCheckerBot 源码 演示 InlineMenus 和 Callback 处理程序的工作方式。命令 "/start" 将启动 bot。向 bot 发送任何英文文本，它将检查错误。如果发现错误，Bot 将向你提供一些修复建议。

• Ubuntu 16.04 或更高版本，带有 Swift 5.1 或更高版本 / macOS 带有 Xcode 11 或更高版本
• Telegram 帐户和任何平台的 Telegram 应用程序
• Swift Package Manager (SPM) 用于依赖管理
• Vapor 4（可选，用于带有数据库和其他服务器端内容的 bots）

参见 CONTRIBUTING.md 文件。

Givi Pataridze

pataridzegivi@gmail.com @givip