企微
  1. 文档必读
企微
  • 文档必读
    • 文档说明
    • 开发流程
    • 配置
    • Q&A
    • 消息回调
  • 客户端控制
    • 打开企微
      POST
    • 退出企微
      POST
    • xbot 健康检查
      POST
  • 登录信息
    • 刷新登录二维码
      POST
    • 退出登录
      POST
  • 消息
    • 发送文本
      POST
    • 发送文本（新版）
      POST
    • 发送图片URL
      POST
    • 发送图片
      POST
    • 发送图片（新版）
      POST
    • 发送群@消息
      POST
    • 发送群@消息（新版）
      POST
    • 发送文件消息
      POST
    • 发送文件URL
      POST
    • 发送文件消息（新版）
      POST
    • 发送动图消息
      POST
    • 发送卡片消息
      POST
    • 发送小程序
      POST
    • 发送视频号
      POST
    • 发视频消息
      POST
    • 发视频消息（新版）
      POST
    • 发送名片
      POST
    • 发送视频号直播消息
      POST
    • 撤回消息
      POST
    • 发送语音消息
      POST
    • 发送位置消息
      POST
    • 标记消息已读
      POST
  • 联系人
    • 获取联系人信息
    • 获取内部联系人会话列表
    • 获取外部联系人列表
    • 搜索微信/企微用户
    • 添加搜索的微信用户
    • 添加搜索的企微用户
    • 添加名片为联系人
    • 添加删除的联系人
    • 修改内/外部好友备注
    • 修改内/外部好友描述
    • 修改外部联系人手机号
    • 修改外部联系人公司名称
    • 接受好友申请
    • 删除联系人
    • 批量获取联系人信息(协议)
    • 获取被对方删除的客户列表
  • 群组
    • 获取会话群聊列表
    • 获取会话群成员列表
    • 获取群信息(协议)
    • 获取客户群列表(协议)
    • 创建内/外部群
    • 创建空外部群
    • 修改群名
    • 批量邀请好友入群
    • 批量踢群成员
    • 添加群成员为联系人
    • 发布群公告
    • 转让群主
    • 开启/关闭群邀请确认
    • 开启/关闭禁止修改群名
    • 通过群邀请
    • 退出群聊
    • 解散群
    • 获取群聊二维码
    • 添加群管理员
    • 删除群管理员
    • 获取群聊黑名单
    • 禁止用户加入我的群聊
    • 获取群防骚扰规则
    • 设置群防骚扰规则
    • 获取群欢迎语列表
    • 添加群欢迎群
    • 设置群欢迎语
  • 标签
    • 获取标签下的所有联系人
    • 获取标签列表
    • 创建标签
    • 给客户加标签
    • 获取指定客户的所有标签
  • CDN
    • CDN 说明
    • 关闭客户端自动下载
    • CDN上传
    • CDN下载
    • BigCDN上传媒体文件
    • WxCDN下载
    • BigCDN下载媒体文件
    • CDN上传（URL版本）
    • BigCDN上传媒体文件（URL版本）
  • 朋友圈
    • 发布朋友圈(文字，图片，链接, 视频，视频号)
    • 设置朋友圈签名
    • 获取朋友圈列表
    • 设置朋友圈封面
  • 开放平台双向互通
    • 开放平台说明
    • 用户ID转开放平台ID
    • 群ID转开放平台chatId
    • 开放平台群ID转群chatId
    • 开放平台ID转用户ID
  1. 文档必读

Q&A

Q:文档的URL为空，如何调接口？#

A:本产品运行在你的电脑/服务器上，可以通过 post 你电脑的 http://ip:port 进行调用。
ip 可以是 localhost, 127.0.0.1 又或者是你的局域网，公网IP。
port 是自行设置的，可以在 .env 里面改。
如果电脑没有公网IP，又希望能够在其他服务器上调接口调用，可以看 文档必读-配置-WS_SERVER

Q:调接口没有任何反应或超时#

A: 先检查是否正常运行，可以通过收消息是否出现“收到消息”的日志，如无证明异常，可能的原因为
1.
刚启动时加载动态库有问题，一直都没有“收到消息”的日志。删除DLL重新运行。
2.
之前出现过“收到消息”，后面有一条“客户端关闭链接”。可能是企微异常或者自动更新导致客户端进程关闭，可重启或者调用“打开企微/个微"接口重新唤起。
3.
“收到消息”有正常显示，只是接口调用无反应，可能是JSON格式有问题,请自行检查.

Q:客户端自动关闭了#

A:可能原因
客户端奔溃
自动更新
手机切换企业（切换企业客户端会退出）
没有及时确认常用设备
风控异常
如果是更新导致,可以取消勾选自动更新,并在 host 上加上
127.0.0.1   dldir1.qq.com
127.0.0.1   dldir2.qq.com
127.0.0.1   dldir3.qq.com
加 host 教程 https://developer.aliyun.com/article/706009

Q:调接口后，XBOT没有任何提示#

A:调用的IP或者端口错误，如果收到，会立刻显示“收到POST”的文案

Q:消息涉及到的 file_id, aes_key 之类的是什么？如何使用？#

A:可以看CDN里面的上传和下载,小程序里面的file_id对应的是封面图

Q:conversation_id 是什么？如何获取？#

A:这是会话ID,联系人为S:开头，群是R:开头，而且联系人的会话ID组成其实为S:{当前账号ID}_{对方账号ID}，每个人或群的会话ID是固定不变的。可以通过联系人列表、群列表，或者回调里面去获取。企业微信账号开头为 168，普通微信开头为 788

Q:如何下载语音？#

用 CDN 下载，file_type 为5，下载下来的格式是 silk，可以 github 搜 silk 转 mp3 的项目处理。

Q:如何多开？换账号登录后如何继续托管？#

A:调接口，打开企微
修改于 2025-02-21 04:37:46
上一页
配置
下一页
消息回调
Built with