Telegram 还支持 Markdown 和 HTML 类型的文本消息。本章我们将实现/help
指令,它会将帮助信息以 Markdown 格式发送给用户。
本章代码在05/发送 Markdown分支。
Telegram 只是有限支持 Markdown 和 HTML,即便如此,我们也可以利用这有限的支持发送格式多样的文本消息。
Markdown 消息其实也是文本消息,所以它调用的 API 和发送普通文本消息的 API 是一样的。
定义 Markdown 消息类型
我们需要给MsgType
增加一个枚举值:
// 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
}
MarkdownMessage
的定义
Telegram 是通过 parse_mode
字段来识别采用何种格式解析文本消息的。所以我们的 MarkdownMessage
和之前的 TextMessage
相比,只需要加上一个parse_mode
字段。
你可以只定义一个结构体来发送不同格式的文本消息,而不是像本专题这样分别定义不同的结构体。