开启左侧

企业微信API对接文档,可用接口向企微和个微自动发音讯

[复制链接]
在线会员 Yivfyo 发表于 5 天前 | 显示全部楼层 |阅读模式 打印 上一主题 下一主题
文章择要 :原文具体介绍了企业微疑API连接齐过程,包罗获得token、Docker情况布置、使用挨包启用、两维码两重考证等枢纽步调。重心解说了三年夜中心交心:获得用户列表、单人多消息拉收的完毕办法,并供给部门源码参照。文章夸大统统功用均已经真测有用,配套残破文档战付费源码(200米露手艺撑持),旨正在辅佐企业完毕微疑客户消息主动化办理。颠末手艺伎俩买通企业微疑消息通讲,为智能客服、营销拉收等场景供给处置计划。【统统功用,亲测有用!】。
目次
企业微疑API连接文档
1.布景
2.获得微疑第三圆token
3.装置docker情况
4.挨包取启用
4.1挨包镜像
4.2启用容器(启用使用)
5.企业微疑两维码考证
5.1 获得初初两维码
5.2 第1次两维码考证
5.3 第2次两维码考证
6.企业微疑三个交心
6.1 获得统统用户
6.2 收收消息给单人
6.3收收消息给多人
7.部门源码展示
7.1 Dockerfile真代码
7.2 index.tx真代码
8.完毕法式/切换账号登录

企业微疑API连接文档

1.布景

念颠末法式收收订定的消息给微疑客户,客户需要领受到消息提醒而且能够间接翻开微疑检察(条件前提用户用减了门店企业微疑密友),而后颠末智能体(包罗自界说常识库实质)完毕主动复兴客户消息,针对于上面成就,供给二个交心:
一、一个是获得企业微疑的用户的列表
二、一个是间接收收用户消息
企业微疑API连接文档,可用交心背企微战个微主动收消息-1.png


2.获得微疑第三圆token

获得第三圆token,恳求地点:Token 自帮效劳体系
企业微疑API连接文档,可用交心背企微战个微主动收消息-2.png


今朝已经获得到的token是(留神各人获得到token,试用期唯一7天,如念绝期请自止绝费):
puppet_workpro_867奸淫奸淫41e7908d3ee3b44f5421
3.装置docker情况

请先使用一个装置佳docker 的效劳器。请自止baidu,正在效劳器怎样装置docker。   
方法一(举荐):阿里云装置docker,按照效劳器范例挑选装置,操纵文档以下:
装置Docker并使用_云效劳器 ECS(ECS)-阿里云辅佐中间
企业微疑API连接文档,可用交心背企微战个微主动收消息-3.png


方法两:施行上面的号令。
企业微疑API连接文档,可用交心背企微战个微主动收消息-4.jpeg


4.挨包取启用

4.1挨包镜像

    将源码包的文献,复造到效劳器某个路子下:(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-5.jpeg


    加入效劳器,到指定目次下:(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-6.jpeg


    输出号令:docker build -t wechat_data_con .  (如图,回车键施行,装置依靠和所需情况)
企业微疑API连接文档,可用交心背企微战个微主动收消息-7.jpeg


server.js 真代码参照
  1. // server.js
  2. const express = require('express');
  3. const bodyParser = require('body-parser');
  4. const app = express();
  5. const port = 9898;
  6. app.use(bodyParser.json());
  7. app.use(express.static('public'));
  8. let verifyCode = ''; // 用于保存用户提接的考证码
  9. app.post('/submit-verify-code', (req, res) => {
  10.     const { verifyCode: userVerifyCode } = req.body;
  11.     verifyCode = userVerifyCode;
  12.     res.json({ message: '考证码已经领受', verifyCode: userVerifyCode });
  13. });
  14. app.listen(port, () => {
  15.     console.log(`效劳器运行正在 http://localhost:${port}`);
  16. });
复造代码
package.json真代码参照
  1. {
  2.   "name": "workpro-getting-started",
  3.   "version": "1.0.0",
  4.   "description": "basic example on workpro service",
  5.   "main": "index.ts",
  6.   "scripts": {
  7.     "test": "echo "Error: no test specified" && exit 1",
  8.     "start": "ts-node index.ts"
  9.   },
  10.   "repository": {
  11.     "type": "git",
  12.     "url": "https://gitee.com/laibin113/enterprise-wechat-messaging.git"
  13.   },
  14.   "keywords": [],
  15.   "author": "",
  16.   "license": "ISC",
  17.   "bugs": {
  18.     "url": "https://gitee.com/laibin113/enterprise-wechat-messaging.git"
  19.   },
  20.   "homepage": "https://gitee.com/laibin113/enterprise-wechat-messaging.git",
  21.   "dependencies": {
  22.     "@juzi/wechaty": "^1.0.66",
  23.     "@juzi/wechaty-puppet": "^1.0.66",
  24.     "qrcode-terminal": "^0.12.0",
  25.     "express": "^4.17.1",
  26.     "body-parser": "^1.20.0",
  27.     "@grpc/grpc-js": "1.8.12",
  28.     "node-fetch": "^2.6.1",
  29.     "node-cache": "^5.1.2"
  30.   },
  31.   "devDependencies": {
  32.     "@types/qrcode-terminal": "^0.12.0",
  33.     "@types/express": "^4.17.6"
  34.   }
  35. }
复造代码
4.2启用容器(启用使用)

    依靠装置完毕后,输出号令:docker run -p 9898:9898 --restart on-failure wechat_data_con  (如图,端心自止掌握)
    企业微疑API连接文档,可用交心背企微战个微主动收消息-8.jpeg

5.企业微疑两维码考证

5.1 获得初初两维码

(1)收收交心恳求获得初初两维码,docker日记检察假设没有会请自止baidu;
(2)启起程序post办法恳求:http:127.0.0.1:9898/goStart
(3)上面的交心127.0.0.1按照理论效劳换本钱人的IP,大概绑定对于应的域名。
    收收恳求,启用获得两维码交心。(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-9.jpeg


日记台会呈现一个两维码。(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-10.png


5.2 第1次两维码考证

    使用脚机企业微疑,扫描两维码,扫描完了以后,脚机企业微疑,会弹出一个 6位数的考证码,共同上图的qrcodeKey,恳求交心:(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-11.jpeg


考证胜利后,日记台输出:(如图),暗示登录胜利
企业微疑API连接文档,可用交心背企微战个微主动收消息-12.jpeg


5.3 第2次两维码考证

    出格留神,果企业微疑民间的启事,目前账号,初度如许扫码登录的情况下,正在30分钟内乱,会正在企业微疑请求,再次考证。以下图:
企业微疑API连接文档,可用交心背企微战个微主动收消息-13.jpeg


企业微疑API连接文档,可用交心背企微战个微主动收消息-14.jpeg


那个时候,日记台,会从头挨印两维码,面打 肯定是自己使用,而后扫描两维码,便可。
6.企业微疑三个交心

6.1 获得统统用户

(1)post办法恳求:http:127.0.0.1:9898/get-all-user
(2)body传参方法,参数分析:
        pageSize:需要收收的企业微疑消息实质
        id:上面获得到用户疑息的用户id
(3)备注:上面的交心127.0.0.1按照理论效劳换本钱人的IP,大概绑定对于应的域名。
(4)9898对于应效劳器宁静组需要搁止该端心,假设启用防水墙也要铺开该端标语。
    恳求交心,获得统统用户:(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-15.jpeg


企业微疑API连接文档,可用交心背企微战个微主动收消息-16.png


datas为用户数据列表, hasNextPage为可否有下一页。
企业微疑API连接文档,可用交心背企微战个微主动收消息-17.jpeg


各个字段皆十分简单理解,自止翻译吧,上面是参数:
_events 战 _eventsCount:工作相干的计数器。
id:标记符,凡是用于唯一标记一个工具或者记载。
payload:背载,指传输的数据实质。
address:地点,指用户的居住地点或者联系地点。
alias:别号,用户使用的另外一个名字或者昵称。
avatar:头像,是指用户的照片或者代表图象的链交。
city:都会,用户地点的都会。
corporation:公司,用户地点的公司或者构造。
coworker:共事,可以暗示用户可否是联系人的共事。
description:描绘,可以是指对于用户的一点儿描绘性疑息。
friend:朋友,可以暗示用户可否是联系人的朋友。
gender:性别,1凡是暗示男性,0代表女性
handle:处置
name:名字,用户的姓名。
phone:德律风,用户的联系德律风。
province:省分,用户地点的省分。
signature:署名,用户的署名或者小我私家警句。
star:星标,可以暗示用户可否被标识表记标帜为主要联系人。
title:题目,可以是指用户的地位或者头衔。
type:范例,1可以暗示用户范例或者形状
weixin:微疑,用户的微疑账号或者标记。
additionalInfo:分外疑息,包罗一点儿用于识别或者分类用户的附带数据。
corpld 战 sCorpld:取公司或者构造相干的某种标记符。
status:形状,5暗示用户的形状码。
tags:标签,用于标识表记标帜用户或者分类的枢纽词汇列表,那里是一个数组。
realName:实在姓名,用户的邪式姓名。
aka:也被称为,暗示用户的其余已经知称呼或者别号。
hasNextPage:有下一页,那凡是用于分页显现,暗示数据另有更多的部门。
6.2 收收消息给单人

收收消息交心:(如图下图所示
(1)post办法恳求:http:127.0.0.1:9898/send-message
(2)body传参方法,参数分析:
        message:需要收收的企业微疑消息实质
        id:上面获得到用户疑息的用户id
(3)备注:上面的交心127.0.0.1按照理论效劳换本钱人的IP,大概绑定对于应的域名。
企业微疑API连接文档,可用交心背企微战个微主动收消息-18.jpeg


6.3收收消息给多人

(1)post办法恳求:http:127.0.0.1:9898/send-message-all
(2)body传参方法,参数分析:
        message:需要收收的企业微疑消息实质
        id:上面获得到用户疑息的用户id
(3)备注:上面的交心127.0.0.1按照理论效劳换本钱人的IP,大概绑定对于应的域名。
企业微疑API连接文档,可用交心背企微战个微主动收消息-19.jpeg


(4)上面获得到的用户疑息的tag(标签),可鄙人图那边办理。
企业微疑API连接文档,可用交心背企微战个微主动收消息-20.jpeg


结果如图:
企业微疑API连接文档,可用交心背企微战个微主动收消息-21.jpeg


7.部门源码展示

7.1 Dockerfile真代码
  1. # Dockerfile
  2. FROM node:lts
  3. # 复造使用法式代码到容器中
  4. COPY . /appWxWork
  5. WORKDIR /appWxWork
  6. ENV WECHATY_PUPPET_SERVICE_AUTHORITY=token-service-discovery-test.juzibot.com
  7. RUN npm config set registry https://registry.np妹妹irror.com/
  8. # 正在容器中装置 ts-node 战使用法式所需的依靠
  9. RUN npm install ts-node typescript
  10. # 表露端心 8088
  11. EXPOSE 9898
  12. # 运行使用法式
  13. CMD ["npm", "start"]
复造代码
7.2 index.tx真代码
  1. import {ScanStatus, WechatyBuilder} from '@juzi/wechaty'
  2. import QrcodeTerminal from 'qrcode-terminal'
  3. const NodeCache = require("node-cache");
  4. const express = require('express');
  5. const bodyParser = require('body-parser');
  6. const myCache = new NodeCache({ stdTTL: 3660, checkperiod: 1200 });
  7. const app = express();
  8. const port = 9898;
  9. app.use(bodyParser.json());
  10. app.use(express.static('public'));
  11. let verifyCode1 = ''; // 用于保存用户提接的考证码
  12. const fetch = require('node-fetch');
  13. let myUserName = '';
  14. const token = 'puppet_workpro_奸淫奸淫1241e7908d3ee3b44f5421';
  15. const bot = WechatyBuilder.build({
  16.   puppet: '@juzi/wechaty-puppet-service',
  17.   //authority: 'token-service-discovery-test.juzibot.com',
  18.   puppetOptions: {
  19.     token,
  20.     tls: {
  21.       disable: true
  22.       // currently we are not using TLS since most puppet-service versions does not support it.
  23.     }
  24.   }
  25. })
  26. const store = {
  27.   qrcodeKey: '',
  28. }
  29. ......
复造代码
8.完毕法式/切换账号登录

(1)当念改换企业微疑绑定者的时候,挪用上面的交心截至完毕,而后从头绑定。
(2)完毕法式post办法恳求:http:127.0.0.1:9898/goEnd
(3)备注:上面的交心127.0.0.1按照理论效劳换本钱人的IP,大概绑定对于应的域名。
    完毕法式/切换账号登录,(如图)
企业微疑API连接文档,可用交心背企微战个微主动收消息-22.jpeg


掌握台日记 ,会从头挨印两维码,请从头施行上面的步调2~……
企业微疑API连接文档,可用交心背企微战个微主动收消息-23.jpeg


原文枢纽词汇注释
    企业微疑API :指企业微疑供给的使用法式交心,许可企业开辟自己的使用取企业微疑截至散成,完毕如收收消息、获得用户列表等功用,以就更佳天办理战相同微疑客户。
    token :正在企业微疑API连接中,用于考证身份战受权会见的令牌。文中提到的“puppet_workpro_867奸淫奸淫41e7908d3ee3b44f5421”即是获得到的token示例,开辟者需使用有用的token去挪用相干交心。
    docker :是一个启源的使用容器引擎,可让开辟者挨包他们的使用和依靠包到一个可移植的容器中,而后公布就任何流行的 Linux 机械上。正在原文中,需要先正在效劳器上装置docker情况,以就后绝挨包战启用使用。
    两维码考证 :正在企业微疑API连接过程当中,用于登录战身份考证的枢纽步调。颠末收收交心恳求获得初初两维码,使用脚机企业微疑扫描两维码后获得考证码,再共同qrcodeKey截至考证,以完毕登录操纵。
    用户列表交心 :指用于获得企业微疑统统用户疑息的交心,颠末post办法恳求“http://127.0.0.1:9898/get -all-user”,并传进响应的参数,如pageSize战id,便可获得包罗用户各类疑息(如id、name、phone等)的用户数据列表和可否有下一页的标记。
    收收消息交心(单人) :用于背单个企业微诺言户收收消息的交心,颠末post办法恳求“http://127.0.0.1:9898/send-message”,并正在body中传进消息实质(message)战用户id(id),便可完毕给指定用户收收消息的功用。
    收收消息交心(多人) :用于背多个企业微诺言户收收消息的交心,颠末post办法恳求“http://127.0.0.1:9898/send-message-all”,异常需要正在body中传进消息实质(message)战用户id(id),可完毕批质收收消息给多人,进步消息报告的服从。
    分页参数(pageSize) :正在获得用户列表交心中使用,用于指定屡屡恳求获得的用户数目,就于对于大批用户数据截至分页处置,制止一次性获得过量数据招致功用成就或者恳求超时等情况。
    形状码(status) :正在用户数据中包罗的一个字段,用于暗示用户的形状,比方文中提到的“5”暗示用户的形状码,差别的形状码可以代表用户的差别形状,如一般、禁用等,开辟者能够按照形状码对于用户截至响应的办理战操纵。
    标签(tags) :也是用户数据中的一个字段,以数组方法显现,用于对于用户截至标识表记标帜战分类,便利企业按照差别的营业需要对于用户集体截至细分战精确营销,好比能够按照标签选择出一定范例的客户收收针对于性的消息。
分析:本文档是尔共事 陈伟魁首 编辑,自己以为比力故意义文章,略微收拾整顿输出分享给各人进修,期望那篇专客能够为您正在事情中供给一点儿启迪战辅导。假设您有所有成就或者需要退一步的倡议,欢送正在批评区留行交换。让咱们共同根究IT天下的无限可以!

专主借写了野生智能一点儿文章,请列位年夜佬批驳斧正:
一、野生智能、机械进修、深度进修:手艺反动的深度剖析
二、GPT-5:野生智能的新篇章,未来已经去
三、野生智能时期,法式员怎样连结中心合作力?
四、抗御AI欺骗:手艺、教诲取法令的配合防地
五、具体的野生智能进修门路战质料举荐
六、使用AI进步实质消耗服从的五个计划
七、今朝海内AI年夜厂年夜模子列表劣缺点、道理、使用、案例战留神事变
8、Stable Diffusion 当地布置学程
九、数据开掘案例阐发、典范案例、手艺完毕计划
十、解说野生智能正在现代科技中的使用战未来开展趋势
写正在最初,感谢列位年夜佬浏览原文!
(1)对于文档:连接残破文档wx存眷复兴:企业微疑,便可获得;
(2)对于源码:团队经7天攻脆完毕企业微疑消息体系(已经实践过量个次名目保证能够使用),源码表示性支200米(附问信群+永久升级)。残破文档已经启源,入手才气强人可间接参照完毕。需要代码请公疑「底部wx公家号:联系作家-作家微疑-两维码扫一扫增加密友」,感谢对于手艺代价的尊敬!💡
您需要登录后才可以回帖 登录 | 立即注册 qq_login

本版积分规则

发布主题
阅读排行更多+
用专业创造成效
400-778-7781
周一至周五 9:00-18:00
意见反馈:server@mailiao.group
紧急联系:181-67184787
ftqrcode

扫一扫关注我们

Powered by 职贝云数A新零售门户 X3.5© 2004-2025 职贝云数 Inc.( 蜀ICP备2024104722号 )