发送Markdown

Telegram 还支持 Markdown 和 HTML 类型的文本消息。本章我们将实现/help指令，它会将帮助信息以 Markdown 格式发送给用户。

Telegram 只是有限支持 Markdown 和 HTML，即便如此，我们也可以利用这有限的支持发送格式多样的文本消息。

Markdown 消息其实也是文本消息，所以它调用的 API 和发送普通文本消息的 API 是一样的。

定义 Markdown 消息类型

// src/types/mod.rs

pub enum MsgType {
    Text(String),
    Photo(String),
    Markdown(String),
}

hook 处理

pub async fn hook(
    Json(payload): Json<Update>,
    Extension(state): Extension<AppState>,
) -> Result<String> {
    // ..

    let msg_text = payload.message.text.unwrap_or("".to_string());

    let msg_type = match msg_text.as_str() {
        "/website" => MsgType::Text(command::website()),
        "/logo" => MsgType::Photo(command::logo()),
        "/help" => MsgType::Markdown(command::help(None)),
        _ => MsgType::Markdown(command::help(Some(&msg_text))),
    };

    let res = match msg_type {
        MsgType::Text(reply_msg) => {
            bot::send_text_message(&state.bot.token, payload.message.chat.id, reply_msg).await
        }
        MsgType::Photo(reply_msg) => {
            bot::send_photo_message(&state.bot.token, payload.message.chat.id, reply_msg).await
        }
        MsgType::Markdown(reply_msg) => {
            bot::send_markdown_message(&state.bot.token, payload.message.chat.id, reply_msg).await
        }
    }
    .map_err(log_error(msg_text));

    // ..
}

调用 API 的函数

pub async fn send_markdown_message(token: &str, chat_id: u64, text: String) -> Result<Response> {
    let data = request::MarkdownMessage {
        chat_id,
        text,
        parse_mode: "MarkdownV2".to_string(),
    };
    invoke_api(&data, "sendMessage", token).await
}

这里指明了 parse_mode 为 MarkdownV2，这样 Telegram 就会使用 Markdown 来解析文本消息了。

MarkdownMessage 的定义

Telegram 是通过 parse_mode 字段来识别采用何种格式解析文本消息的。所以我们的 MarkdownMessage 和之前的 TextMessage 相比，只需要加上一个parse_mode字段。

你可以只定义一个结构体来发送不同格式的文本消息，而不是像本专题这样分别定义不同的结构体。

返回 Markdown 消息内容

// src/handler/command.rs

pub fn help(msg: Option<&str>) -> String {
    let header = match msg {
        Some(txt) => format!("你输入的 `{}` 有误", txt),
        None => "".to_string(),
    };
    let body = r#"
__使用帮助__
`/website`：访问官方网站
`/logo`：获取官方LOGO
`/help`：显示帮助信息
        "#;
    format!(r#"{}{}"#, header, body)
}