#we-chat #sdk #api-bindings

wechat-mp

微信公众号(包括订阅号和服务号)sdk版本(开发中), 基于2020年7月的微信文档开发

5 releases

0.1.4 Jul 21, 2020
0.1.3 Jul 16, 2020
0.1.2 Jul 10, 2020
0.1.1 Jul 9, 2020
0.1.0 Jul 9, 2020

#7 in #wechat

MIT/Apache

180KB
4K SLoC

微信公众号(包括订阅号和服务号)SDK for rust

crates.io Documentation CI

库初始化中, 目前api还没完成, 请不要使用

关键特性

  • 纯SDK, 可配合其他http server一起使用.
  • 支持单/多公众号管理
  • 全异步支持

实现的API

接收消息

  • 文本消息
  • 图片消息
  • 语音消息
  • 视频消息
  • 小视频消息
  • 地理位置消息
  • 链接消息
  • 事件普通消息
    • 关注/取消关注事件
    • 扫描带参数二维码事件
    • 上报地理位置事件
  • 菜单事件消息
    • 点击菜单拉取消息时的事件推送
    • 点击菜单跳转链接时的事件推送
    • 扫码推事件的事件推送
    • 扫码推事件且弹出“消息接收中”提示框的事件推送
    • 弹出系统拍照发图的事件推送
    • 弹出拍照或者相册发图的事件推送
    • 弹出微信相册发图器的事件推送
    • 弹出地理位置选择器的事件推送
    • 点击菜单跳转小程序的事件推送

回复消息

  • 回复文本消息
  • 回复图片消息
  • 回复语音消息
  • 回复视频消息
  • 回复音乐消息
  • 回复图文消息

客服消息

  • 客服帐号管理
    • 添加客服帐号
    • 修改客服帐号
    • 删除客服帐号
    • 设置客服帐号的头像
    • 获取所有客服账号
  • 客服接口-发消息
    • 发送文本消息
    • 发送图片消息
    • 发送语音消息
    • 发送视频消息
    • 发送音乐消息
    • 发送图文消息(点击跳转到外链)
    • 发送图文消息(点击跳转到图文消息页面)
    • 发送菜单消息
    • 发送卡券
    • 发送小程序卡片(要求小程序与公众号已关联
    • 以某个客服帐号来发消息(在微信6.0.2及以上版本中显示自定义头像)
  • 客服接口-客服输入状态

自定义菜单

  • 创建菜单
  • 查询菜单
  • 消除菜单
  • 创建个性化菜单
  • 删除个性化菜单
  • 测试个性化菜单
  • 查询个性化菜单

网页授权

  • 生成跳转URL
  • 换取access_token
  • 刷新access_token
  • 校验access_token
  • 拉取用户信息

todo:

  • 群发接口和原创校验
  • 模板消息接口
  • 一次性订阅消息

example

use actix_web::{
    get, post,
    web::{self, Bytes, Data, Path, Query},
    App, HttpResponse, HttpServer, Responder, Result,
};
use log::info;
use wechat4rs::{
    errors::{WechatEncryptError, WechatError},
    CallbackMessage, EchoStrReq, MessageInfo, ReplyMessage, SaasContext, VerifyInfo, Wechat,
    WechatCallBackHandler, WechatConfig, WechatSaasResolver,
};

/// 公众号对接echo验证,
/// 可以配置多个公众号回调,通过saas_id区分回调的公众号(u64), 下同
#[get("/wechat-callback/{saas_id}/")]
async fn echo_str(
    wechat: Data<Wechat>,
    saas_id: Path<u64>,
    verify_info: Query<VerifyInfo>,
    req: Query<EchoStrReq>,
) -> Result<String, WechatError> {
    let context = SaasContext::new(saas_id.into_inner());
    let result = wechat.handle_echo(&verify_info, &req, &context).await?;
    Ok(result)
}

/// 微信回调消息接收入口
#[post("/wechat-callback/{saas_id}/")]
async fn wechat_callback(
    wechat: Data<Wechat>,
    saas_id: Path<u64>,
    info: Query<VerifyInfo>,
    body: Bytes,
) -> Result<String, WechatError> {
    let request_body = String::from_utf8(body.to_vec())?;
    let context = SaasContext::new(saas_id.into_inner());
    let result = wechat
        .handle_callback(&info, &request_body, &context) // 调用消息处理入口
        .await?;
    Ok(result)
}

use async_trait::async_trait;
struct EchoText;

/// 处理消息回调[可选]
/// 该回调可以处理微信的消息回调, 并返回相应的处理结果
/// 此Demo返回 hello:{收到的消息}
#[async_trait]
impl WechatCallBackHandler for EchoText {
    async fn handler_callback(
        &self,
        _wechat: &Wechat,
        prev_result: Option<ReplyMessage>,
        message: &CallbackMessage,
    ) -> Result<Option<ReplyMessage>, WechatError> {
        if let CallbackMessage::Text {
            info,
            content,
            biz_msg_menu_id: _,
        } = message
        {
            let info = info.clone();
            return Ok(Some(ReplyMessage::Text {
                info: MessageInfo {
                    from_user_name: info.to_user_name.clone(),
                    to_user_name: info.from_user_name.clone(),
                    ..info
                },
                content: format!("hello: {}", content),
            }));
        }
        Ok(prev_result) //默认可以返回None
    }
}

/// 公众号配置信息解析器
///
/// 用于返回解析公众号配置信息
/// context中包含请求的上下文, 返回对应公众号的配置信息
/// 这些配置信息一般保存在redis或者数据库中
///
/// note:
///   如果只有一个公众号, 那可以使用ConstSaasResolver::new(config)始终返回固定的配置
struct SaasResolve;
#[async_trait]
impl WechatSaasResolver for SaasResolve {
    async fn resolve_config(
        &self,
        _wechat: &Wechat,
        context: &SaasContext,
    ) -> Result<WechatConfig, WechatError> {
        let aes_key = wechat4rs::WechatConfig::decode_aes_key(
            &"znpfGFxELvUSxh0Gx4rJenvVQRrAhdTsioG08XR4z3S=".to_string(),
        )?;
        match context.id {
            1 => Ok(WechatConfig {
                key: None,
                app_id: "appid 1".into(),
                app_secret: "app id 1 secret".into(),
            }),
            2 => Ok(WechatConfig {
                key: aes_key,
                app_id: "appid 2".into(),
                app_secret: "appid 2 secret".into(),
            }),
            _ => Err(WechatError::EncryptError {
                source: WechatEncryptError::InvalidAppId,
            }),
        }
    }
}

async fn init() -> anyhow::Result<()> {
    use actix_web::middleware::Logger;
    use bb8_redis::{RedisConnectionManager, RedisPool};
    use env_logger::Env;
    use wechat4rs::token_provider::reids::RedisTokenProvider;

    use dotenv::dotenv;
    dotenv().ok();
    env_logger::from_env(Env::default().default_filter_or("info")).init();

    info!("init");

    // 1. 为了使集群能正常分享公众号的access_token, 这里使用redis来保存token,
    // 如果是单机版可以使用MemoryTokenProvider
    // let config_env: WechatConfig = envy::prefixed("WECHAT_").from_env()?;
    let manager = RedisConnectionManager::new(dotenv::var("REDIS_URL")?)?;
    let pool = RedisPool::new(bb8::Pool::builder().build(manager).await?);
    let token_p = RedisTokenProvider::new(pool);

    // 2. 指定配置解析器
    let mut wechat = wechat4rs::Wechat::new(Box::new(SaasResolve), Box::new(token_p));
    // 3. [可选] 注册消息回调处理器, 用于处理微信回调的消息
    wechat.registry_callback(Box::new(EchoText));

    let wechat = web::Data::new(wechat);

    HttpServer::new(move || {
        App::new()
            .wrap(Logger::default())
            .wrap(Logger::new("%a %{User-Agent}i"))
            .app_data(wechat.clone())
            .service(echo_str) // 微信注册echo str
            .service(wechat_callback) // 回调入口
    })
    .bind("0.0.0.0:3000")?
    .run()
    .await?;

    Ok(())
}

#[actix_rt::main]
async fn main() -> Result<(), std::io::Error> {
    if let Err(err) = init().await {
        eprintln!("ERROR: {:#}", err);
        err.chain()
            .skip(1)
            .for_each(|cause| eprintln!("because: {:?}", cause));
        std::process::exit(1);
    }
    Ok(())
}

Dependencies

~33–47MB
~846K SLoC