**Wecom酱技术文档**-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01269/article/details/143043729

Wecom酱技术文档

wecomchan 通过企业微信向微信推送消息的配置文档、直推函数和可自行搭建的在线服务代码。可以看成Server酱的开源替代方案之一。项目地址: https://gitcode.com/gh_mirrors/we/wecomchan

Wecom酱是一款强大的工具，旨在帮助企业通过企业微信轻松地将消息推送到个人微信，无需企业微信客户端。这款解决方案不仅便捷且开源，支持多语言环境。下面详细指导您如何安装、使用以及掌握其API。

安装指南

Wecom酱的核心在于配置企业微信应用，并通过提供的编程接口发送消息。无需传统意义上的“安装”，但确实有一系列的配置步骤需在企业微信平台上完成：

注册企业: 访问企业微信官网注册您的企业账号。
创建应用: 登录管理界面，创建名为“Server酱”的应用，配置相应的Logo和可见范围。
配置可信IP: 对于新应用，记得配置可信IP，尤其当您计划从云服务器上发送消息时。
获取必要信息: 收集企业ID、应用ID和应用Secret，这些是连接的关键凭证。
微信插件配置: 开启微信插件的相关设置，确保能成功接收到消息。
环境准备: 根据您使用的编程语言，确保开发环境中已安装必要的库或依赖，如PHP、Python、Node.js或.NET Core等。

项目的使用说明

一旦完成了上述企业微信的基础配置，您可以利用Wecom酱提供的函数来发送消息。这里以几种常见语言为例展示如何调用：

PHP版

在PHP环境下，使用send_to_wecom函数发送消息：

<?php
function send_to_wecom($text, $wecom_cid, $wecom_aid, $wecom_secret) {
    // 函数实现参照README中的PHP示例
}

$ret = send_to_wecom("您好，这是测试消息。", "企业ID", "应用ID", "应用secret");
print_r($ret);
?>

Python版

Python用户可以这样发送文本消息：

import json
import requests

def send_to_wecom(text, wecom_cid, wecom_aid, wecom_secret):
    # 函数实现参照 README 中的Python示例

ret = send_to_wecom("欢迎使用Wecom酱!", "企业ID", "应用ID", "应用secret")
print(ret)

TypeScript/JavaScript版

对于前端或者Node.js开发者，可以采用异步方法调用：

import fetch from 'node-fetch';

async function sendMessage(text, wecomCId, wecomSecret, wecomAgentId) {
    // 实现逻辑类似TS版本描述
}

await sendMessage("这是一个TypeScript示例。", "企业ID", "应用secret", "应用ID");

.NET Core 版

.NET Core环境下的调用示例：

using System.Net.Http;
using Newtonsoft.Json.Linq;

public string SendMessage(string text, string weComCId, string weComSecret, string weComAId) {
    // 实际调用逻辑基于提供的REST API，与.NET Core的HttpClient相结合
}

var message = SendMessage("Hello from .NET Core.", "企业ID", "应用secret", "应用ID");
System.Console.WriteLine(message);

项目API使用文档

获取Access Token API: 每个调用消息发送前，需要先获取Access Token。可以通过向https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=企业ID&corpsecret=应用secret发起GET请求获得。
发送消息API: 根据不同的消息类型（如text, markdown, image等），构造相应的POST请求至https://qyapi.weixin.qq.com/cgi-bin/message/send，附带正确的消息格式和Access Token。