Skip to content

将 DotCraft 接入微信 ​

通过腾讯 iLink 把微信接成 DotCraft 的一个渠道。首次登录需要扫码,普通回复以纯文本发送。

快速设置 ​

  1. 确认微信账号具备腾讯 iLink 机器人接入能力。

  2. 在 DotCraft Desktop 打开目标 workspace。

  3. 打开 Channels,选择 微信,然后选择 Connect。

    在微信渠道详情页开始连接

  4. 除非腾讯提供了不同端点,否则保持默认 iLink API 地址。

    在 DotCraft Desktop 中检查微信渠道设置

  5. 保存渠道并启用。

  6. 扫描 Desktop 中显示的二维码。

  7. 等到 Desktop 中的微信渠道显示为 connected。

  8. 给微信机器人账号发送一条消息。

平台设置细节 ​

微信渠道以认证为主:

  1. 使用已被腾讯 iLink 授权接入机器人的微信账号。
  2. 首次二维码登录完成前,保持 Desktop 打开。
  3. 正常重启 Desktop 会复用已保存会话。
  4. 当 Desktop 要求重新认证时,扫描新的二维码。

Desktop 托管的微信渠道不需要公网回调 URL。

测试连接 ​

  1. 给微信机器人账号发送 hello。
  2. 确认 DotCraft 在同一聊天中回复。
  3. 发送 /new,再发送一条消息,确认它开启新的会话。
  4. 让 DotCraft 执行一个需要审批的操作,并用审批关键词回复。
  5. 如果工作流依赖媒体投递,测试一次返回文件或图片的任务。

设置后可用能力 ​

  • /new 会在当前微信聊天中开启新的 DotCraft 会话。
  • 登录会话会保存下来,正常重启时可复用。
  • 会话过期时,Desktop 会显示新的二维码。
  • 微信不渲染 Markdown,回复以纯文本显示。
  • 文件和图片投递可通过渠道投递工具使用。
  • 审批回复支持 同意、允许、yes、approve、拒绝、no、reject 和 deny 等纯聊天关键词。前面带 / 也可以,/yes、/no 同样有效。回复 同意全部 或 approve all 会在本会话内放行同类操作。
  • 审批等待回复期间,你在该聊天里发的其他消息不会转给 DotCraft,机器人会回复一条提醒。超时未回复时,操作会被取消,聊天里也会收到通知。

相关文档 ​

  • 渠道配置——微信配置文件的全部字段、默认值与注册形态。
  • 企业微信渠道——企业内部会话走另一条链路,通过回调 URL 接入。