ProductReadyProductReady
Chat Channels

WeCom Message Push

Connect a WeCom group webhook bot to push Agent Task results to your WeCom group.

企业微信消息推送 (WeCom Message Push)

Add a webhook bot to a WeCom group chat, and use it to push messages and task results.

📖 Official docs: 企业微信消息推送文档

Create a Webhook Bot

  1. Open a WeCom group chat
  2. Click the group settings (⋯) → Add Group Bot (添加群机器人)
  3. Give it a name, click Add (添加)
  4. Copy the Webhook URL — it looks like:
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

Keep the webhook URL secret — anyone with it can post to your group.

Connect in ProductReady

Go to User Settings → Chat Channels → [+ Add] → 企业微信, paste the full Webhook URL, and select a default space.

await trpc.channels.connect.mutate({
  provider: "wecom_webhook",
  credentials: { webhookUrl: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=..." },
  defaultSpaceId: "space_abc123",
});

Supported Message Types

The WeCom webhook API supports:

TypeDescription
textPlain text (max 2048 bytes)
markdownMarkdown with limited syntax
imageBase64-encoded image
newsRich card with title, description, image
fileFile attachment (requires upload first)

ProductReady sends text messages by default. The full API supports all types listed above.

Notes

  • WeCom webhook bots are push-only (outbound) — they send messages to the group
  • Rate limit: 20 messages per minute per bot
  • The key parameter in the URL is the bot's unique identifier — no separate API key needed
  • Unlike other providers, WeCom bots don't receive inbound messages via webhook

On this page