DingTalk Robot Util, Send text/markdown/link messages using DingTalk robot
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Hatter Jiang 72cca44db0 feat: add wecom support 5 months ago
src feat: add wecom support 5 months ago
tests v2.0.0 11 months ago
.gitignore Initial commit 1 year ago
Cargo.toml feat: add wecom support 5 months ago
LICENSE Initial commit 1 year ago
README.md fix readme 11 months ago

README.md

dingtalk

DingTalk Robot Util, Send text/markdown/link messages using DingTalk robot

钉钉机器人 Rust SDK

NOTE: From version 1.1.0 dingtalk uses reqwest 0.10.0's async/.await API.

Official reference: https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq/0fa88adc

Sample 1:

use dingtalk::DingTalk;

#[tokio::main]
pub async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let dt = DingTalk::new("<token>", "");
    dt.send_text("Hello world!").await?;

    Ok(())
}

Need use crate: tokio = { version = "0.2.6", features = ["full"] }.

Sample 2 (Read token from file):

#[tokio::main]
pub async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let dt = DingTalk::from_file("~/.dingtalk-token.json")?;
    dt.send_text("Hello world!").await?;

    Ok(())
}

Sample, send markdown message:

dt.send_markdown("markdown title 001", r#"# markdown content 001
* line 0
* line 1
* line 2"#).await?;

Sample, send link message:

dt.send_link("link title 001", "link content 001", "https://hatter.ink/favicon.png", "https://hatter.ink/").await?;

Sample, send feed card message:

dt.send_message(DingTalkMessage::new_feed_card()
    .add_feed_card_link(DingTalkMessageFeedCardLink{
        title: "test feed card title 001".into(),
        message_url: "https://hatter.ink/".into(),
        pic_url: "https://hatter.ink/favicon.png".into(),
    })
    .add_feed_card_link(DingTalkMessageFeedCardLink{
        title: "test feed card title 002".into(),
        message_url: "https://hatter.ink/".into(),
        pic_url: "https://hatter.ink/favicon.png".into(),
    })
).await?;

Sample, send action card message(single btn):

dt.send_message(DingTalkMessage::new_action_card("action card 001", "action card text 001")
    .set_action_card_signle_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title".into(),
        action_url: "https://hatter.ink/".into(),
    })
).await?;

Sample, send action card message(multi btns):

dt.send_message(DingTalkMessage::new_action_card("action card 002", "action card text 002")
    .add_action_card_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title 01".into(),
        action_url: "https://hatter.ink/".into(),
    })
    .add_action_card_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title 02".into(),
        action_url: "https://hatter.ink/".into(),
    })
).await?;

JSON Config

DingTalk config:

{
  "access_token": "<access token>",
  "sec_token": "<sec token>"
}

WeChat Work config:

{
  "type": "wechat",
  "access_token": "<token>"
}

Changelog

  • v2.0.0
    • Remove 'a life cycle
  • v1.3.2
    • Add DingTalk::from_token
  • v1.3.1
    • Add DingTalk::new_wechat
  • v1.3.0
    • Suports WeChat Work now, add type "type": "wechat", supports method DingTalk::send_text
  • v1.2.1
    • Remove maplit crate
  • v1.2.0
    • Use serde and serde_json crates, replace json crate
  • v1.1.2
    • Use hmac and sha2 crates, replace rust-crypto crate
  • v1.1.1
    • DingTalk::from_json add direct_url
    • Fix problems by clippy
  • v1.1.0
    • Change fn to async/.await
  • v1.0.1
    • Change two fn names
    • Add readme sample codes
  • v1.0.0
  • v0.3.0
    • Add FeedCard message, send feed card message type
  • v0.2.1
    • Add Dingtalk::from_json, read token from JSON string
  • v0.2.0
    • Add DingTalk::from_file, read token from file
  • v0.1.2
    • Add Default::default() support
  • v0.1.1
    • Add set_default_webhook_url, default dingtalk webhook url
  • v0.1.0
    • Add DingTalk::send_link(...), send link message
  • v0.0.3
    • Add DingTalkMessage , can set at_all, at_mobiles now