wecomchan
1.0.0
Eine Lösung zum Übertragen von Nachrichten an WeChat über Enterprise WeChat. enthalten:
Vorteil:
PS: Die Nachrichtenschnittstelle kann ohne Authentifizierung genutzt werden. Einzelpersonen können sich über WeChat registrieren.
Öffnen Sie mit Ihrem Computer die offizielle Unternehmenswebsite von WeChat und registrieren Sie ein Unternehmen
Klicken Sie nach erfolgreicher Registrierung auf „Unternehmen verwalten“, um die Verwaltungsoberfläche aufzurufen, und wählen Sie „Anwendungsverwaltung“ → „Selbst erstellen“ → „Anwendung erstellen“.
Geben Sie „Server Sauce“ als Anwendungsnamen ein, laden Sie das Anwendungslogo hier herunter und wählen Sie den Firmennamen für den sichtbaren Bereich aus.
Nachdem die Erstellung abgeschlossen ist, rufen Sie die Seite mit den Anwendungsdetails auf und Sie können die Anwendungs-ID ( agentid )① und das Anwendungsgeheimnis ( secret )② abrufen.
Hinweis: Wenn secret auf das Mobiltelefon übertragen wird, kann es nur im企业微信客户端angezeigt werden.
Anwendungen, die nach dem 20. Juni 2022 erstellt wurden, müssen zusätzliche vertrauenswürdige IPs konfigurieren.
Suchen Sie unten auf der Seite „Anwendungsdetails“ in der Kategorie „Entwicklerschnittstelle“ nach „Enterprise Trusted IP“, klicken Sie auf „Konfigurieren“ und geben Sie die Server-IP ein.
Beachten Sie, dass Sie, wenn Sie einen öffentlichen IP-Cloud-Dienst wie Cloud Function verwenden, möglicherweise „Feste öffentliche IP“ in der Einstellungsoberfläche (von Cloud Function oder anderen Diensten) aktivieren müssen, um eine unabhängige IP zu erhalten. Andernfalls wird möglicherweise ein Fehler „Third Party Service IP“ gemeldet.
Rufen Sie die Seite „Mein Unternehmen“ auf, scrollen Sie nach unten, Sie sehen die Geschäfts-ID ③, kopieren Sie sie und füllen Sie sie nach oben aus.
Um die UID zu pushen, füllen Sie @all direkt aus und pushen Sie sie an alle Mitarbeiter im Unternehmen.
Geben Sie „Mein Unternehmen“ → „WeChat Plug-in“ ein, scrollen Sie nach unten, um den QR-Code zu scannen, und folgen Sie ihm, um Push-Nachrichten zu erhalten.
PS: Wenn接口请求正常，企业微信接受消息正常，个人微信无法收到消息:
Gehen Sie zu „Mein Unternehmen“ → „WeChat-Plug-in“, scrollen Sie nach unten und aktivieren Sie „Mitgliedern erlauben, Chat-Nachrichten im WeChat-Plug-in zu empfangen und darauf zu antworten“.
Deaktivieren Sie die Einschränkung „Nur Nachrichten in Business WeChat akzeptieren“ im Business WeChat-Client „Ich“ → „Einstellungen“ → „Benachrichtigung über neue Nachrichten“.
PS: Aus Gründen der Benutzerfreundlichkeit speichern die folgenden Funktionen access_token nicht zwischen. Es reicht für persönliche Niederfrequenzgespräche. Informationen zu einer Implementierung mit Caching finden Sie im Beispielcode in index.php (abhängig von der Redis-Implementierung).
PHP-Version:
function send_to_wecom ( $ text , $ wecom_cid , $ wecom_aid , $ wecom_secret , $ wecom_touid = ' @all ' )
{
$ info = @ json_decode ( file_get_contents ( " https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= " . urlencode ( $ wecom_cid ). " &corpsecret= " . urlencode ( $ wecom_secret )), true );
if ( $ info && isset ( $ info [ ' access_token ' ]) && strlen ( $ info [ ' access_token ' ]) > 0 ) {
$ access_token = $ info [ ' access_token ' ];
$ url = ' https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= ' . urlencode ( $ access_token );
$ data = new stdClass ();
$ data -> touser = $ wecom_touid ;
$ data -> agentid = $ wecom_aid ;
$ data -> msgtype = " text " ;
$ data -> text = [ " content " => $ text ];
$ data -> duplicate_check_interval = 600 ;
$ data_json = json_encode ( $ data );
$ ch = curl_init ();
curl_setopt ( $ ch , CURLOPT_HTTPHEADER , [ ' Content-Type: application/json ' ]);
curl_setopt ( $ ch , CURLOPT_URL , $ url );
curl_setopt ( $ ch , CURLOPT_RETURNTRANSFER , true );
@ curl_setopt ( $ ch , CURLOPT_FOLLOWLOCATION , true );
curl_setopt ( $ ch , CURLOPT_POST , true );
curl_setopt ( $ ch , CURLOPT_TIMEOUT , 5 );
curl_setopt ( $ ch , CURLOPT_POSTFIELDS , $ data_json );
curl_setopt ( $ ch , CURLOPT_SSL_VERIFYHOST , false );
curl_setopt ( $ ch , CURLOPT_SSL_VERIFYPEER , false );
$ response = curl_exec ( $ ch );
return $ response ;
}
return false ;
}Anwendungsbeispiele:
$ ret = send_to_wecom ( "推送测试rn测试换行" , "企业ID③ " , "应用ID① " , "应用secret② " );
print_r ( $ ret );PYTHON-Version:
import json , requests , base64
def send_to_wecom ( text , wecom_cid , wecom_aid , wecom_secret , wecom_touid = '@all' ):
get_token_url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= { wecom_cid } &corpsecret= { wecom_secret } "
response = requests . get ( get_token_url ). content
access_token = json . loads ( response ). get ( 'access_token' )
if access_token and len ( access_token ) > 0 :
send_msg_url = f'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= { access_token } '
data = {
"touser" : wecom_touid ,
"agentid" : wecom_aid ,
"msgtype" : "text" ,
"text" :{
"content" : text
},
"duplicate_check_interval" : 600
}
response = requests . post ( send_msg_url , data = json . dumps ( data )). content
return response
else :
return False
def send_to_wecom_image ( base64_content , wecom_cid , wecom_aid , wecom_secret , wecom_touid = '@all' ):
get_token_url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= { wecom_cid } &corpsecret= { wecom_secret } "
response = requests . get ( get_token_url ). content
access_token = json . loads ( response ). get ( 'access_token' )
if access_token and len ( access_token ) > 0 :
upload_url = f'https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token= { access_token } &type=image'
upload_response = requests . post ( upload_url , files = {
"picture" : base64 . b64decode ( base64_content )
}). json ()
if "media_id" in upload_response :
media_id = upload_response [ 'media_id' ]
else :
return False
send_msg_url = f'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= { access_token } '
data = {
"touser" : wecom_touid ,
"agentid" : wecom_aid ,
"msgtype" : "image" ,
"image" :{
"media_id" : media_id
},
"duplicate_check_interval" : 600
}
response = requests . post ( send_msg_url , data = json . dumps ( data )). content
return response
else :
return False
def send_to_wecom_markdown ( text , wecom_cid , wecom_aid , wecom_secret , wecom_touid = '@all' ):
get_token_url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= { wecom_cid } &corpsecret= { wecom_secret } "
response = requests . get ( get_token_url ). content
access_token = json . loads ( response ). get ( 'access_token' )
if access_token and len ( access_token ) > 0 :
send_msg_url = f'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= { access_token } '
data = {
"touser" : wecom_touid ,
"agentid" : wecom_aid ,
"msgtype" : "markdown" ,
"markdown" :{
"content" : text
},
"duplicate_check_interval" : 600
}
response = requests . post ( send_msg_url , data = json . dumps ( data )). content
return response
else :
return FalseAnwendungsbeispiele:
ret = send_to_wecom ( "推送测试r n测试换行" , "企业ID③" , "应用ID①" , "应用secret②" );
print ( ret );
ret = send_to_wecom ( '<a href="https://www.github.com/">文本中支持超链接</a>' , "企业ID③" , "应用ID①" , "应用secret②" );
print ( ret );
ret = send_to_wecom_image ( "此处填写图片Base64" , "企业ID③" , "应用ID①" , "应用secret②" );
print ( ret );
ret = send_to_wecom_markdown ( "**Markdown 内容**" , "企业ID③" , "应用ID①" , "应用secret②" );
print ( ret );TypeScript-Version:
import request from 'superagent'
async function sendToWecom ( body : {
text : string
wecomCId : string
wecomSecret : string
wecomAgentId : string
wecomTouid ?: string
} ) : Promise < { errcode : number ; errmsg : string ; invaliduser : string } > {
body . wecomTouid = body . wecomTouid ?? '@all'
const getTokenUrl = `https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= ${ body . wecomCId } &corpsecret= ${ body . wecomSecret } `
const getTokenRes = await request . get ( getTokenUrl )
const accessToken = getTokenRes . body . access_token
if ( accessToken ?. length <= 0 ) {
throw new Error ( '获取 accessToken 失败' )
}
const sendMsgUrl = `https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= ${ accessToken } `
const sendMsgRes = await request . post ( sendMsgUrl ) . send ( {
touser : body . wecomTouid ,
agentid : body . wecomAgentId ,
msgtype : 'text' ,
text : {
content : body . text ,
} ,
duplicate_check_interval : 600 ,
} )
return sendMsgRes . body
}Anwendungsbeispiele:
sendToWecom ( {
text : '推送测试rn测试换行' ,
wecomAgentId : '应用ID①' ,
wecomSecret : '应用secret②' ,
wecomCId : '企业ID③' ,
} )
. then ( ( res ) => {
console . log ( res )
} )
. catch ( ( err ) => {
console . log ( err )
} ).NET Core-Version:
using System ;
using RestSharp ;
using Newtonsoft . Json ;
namespace WeCom . Demo
{
class WeCom
{
public string SendToWeCom (
string text , // 推送消息
string weComCId , // 企业Id①
string weComSecret , // 应用secret②
string weComAId , // 应用ID③
string weComTouId = "@all" )
{
// 获取Token
string getTokenUrl = $ "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid= { weComCId } &corpsecret= { weComSecret } " ;
string token = JsonConvert
. DeserializeObject < dynamic > ( new RestClient ( getTokenUrl )
. Get ( new RestRequest ( ) ) . Content ) . access_token ;
System . Console . WriteLine ( token ) ;
if ( ! String . IsNullOrWhiteSpace ( token ) )
{
var request = new RestRequest ( ) ;
var client = new RestClient ( $ "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token= { token } " ) ;
var data = new
{
touser = weComTouId ,
agentid = weComAId ,
msgtype = "text" ,
text = new
{
content = text
} ,
duplicate_check_interval = 600
} ;
string serJson = JsonConvert . SerializeObject ( data ) ;
System . Console . WriteLine ( serJson ) ;
request . Method = Method . POST ;
request . AddHeader ( "Accept" , "application/json" ) ;
request . Parameters . Clear ( ) ;
request . AddParameter ( "application/json" , serJson , ParameterType . RequestBody ) ;
return client . Execute ( request ) . Content ;
}
return "-1" ;
}
}
Anwendungsbeispiele:
static void Main ( string [ ] args )
{ // 测试
Console . Write ( new WeCom ( ) . SendToWeCom (
"msginfo" ,
"企业Id①"
, "应用secret②" ,
"应用ID③"
) ) ;
}
}Andere Versionen von Funktionen können unter Bezugnahme auf die obige Logik geschrieben werden.
Informationen zur erweiterten Verwendung des Sendens von Bildern, Karten, Dateien oder Markdown-Nachrichten finden Sie unter Enterprise WeChat API.
