IntegrationsWorkplace chat

Brand mentions in a WeCom group

WeCom, WeChat Work outside China, calls its group bot “message push” now: a URL with a key that anyone holding it can post to. FishOut sends a news card — one tappable article — because its fields are plain text, which matters for a format whose limits are counted in bytes.

Every alert channel is on every plan, including Free.

[01] WHAT LANDS THERE/ A GROUP

A mention, as it arrives in WeCom

Rendered by the code that sends it, from a sample Google News post. Never the post body.
群 · 品牌监测

FishOut robotnow

FishOut · Relevant mention on Google News

AcmeMail 推出面向小型团队的共享收件箱,与 Notchmail 在中小企业市场正面竞争 Relevance 83 · Brand · Positive Labels: Announcement, Comparison

[02] CONNECT IT/ SETUP

Point FishOut at a group

3 steps, a few minutes end to end.
  1. 1

    Add a message-push bot to the group

    In the WeCom group, add a group bot (message push) and name it FishOut. Its webhook URL is shown when you create it and on its detail page afterwards.

  2. 2

    Copy the URL, and guard the key

    The key is the whole credential. WeCom’s own documentation warns that a leaked webhook lets anyone send spam into your group, so keep it out of screenshots and repositories.

    webhook url

    https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  3. 3

    Paste it into FishOut

    Under Settings → Notifications, add a WeCom channel. The URL must carry exactly one parameter, key. Set a floor and leave batching on — the group takes 20 messages a minute.

Then set the floor

WeCom groups are where people coordinate with colleagues and, often, customers, so the bar for interrupting them is high. Set 85. With batching on, a burst costs the group two cards, which keeps you comfortably inside 20 a minute.
Settings · Notifications

WeCom

https://qyapi.weixin.qq.com/…

Healthy

Relevance floor85

Eventsmention.scored
Batch bursts5 min
[03] WHAT IS IN IT/ FIELDS

What WeCom receives, field by field

Built from the event’s envelope and nothing else, so a retry renders exactly the message the first attempt would have.
Field How
Article titleClipped“FishOut · ” plus the headline, within 128 bytes — about 42 CJK characters.
DescriptionClippedPost title, facts, hint and labels as plain lines, within 512 bytes, never mid-character.
Tap targetShownThe whole card opens the mention in FishOut. There are no buttons on a news card.
@allNeverNews fields are plain text, so nothing in a title becomes a mention.
Post bodyNeverNever sent: the envelope does not carry it.
[04] TEN PINGS OR ONE/ DIGEST

A burst arrives as one message

WeCom batches by default. Here 3 posts were held after the first; they arrive together when the window closes, best first.
群 · 品牌监测 · 5-min digest

FishOut robot+5m

FishOut · 3 new mentions for AcmeMail

• AcmeMail opens an office in Singapore (Google News · 88) • Notchmail signs a reseller deal in Shenzhen (Google News · 81) • Customer-support software spending in Asia rises (Google News · 70)

[05] WHAT WILL BITE YOU/ LIMITS

WeCom’s limits, not ours

These are WeCom’s constraints, checked against its message-push documentation. Failures are tracked per channel, so one broken destination never stops the others.

A news title may be at most 128 bytes and a description at most 512; WeCom truncates beyond that. In UTF-8 a Chinese character is three bytes, so a CJK title clips at roughly a third of the characters an English one does. FishOut clips to the byte budget itself, at a character boundary. [source]

Each bot may send at most 20 messages a minute. Over it, WeCom answers with errcode 45009. [source]

A news message holds 1 to 8 articles. FishOut sends one per alert, and one for a digest, listing the top posts in its description. [source]

errcode 93000 means the URL is invalid or the bot has been removed from the group — the likeliest reason alerts stop. [source]

In the channel’s delivery history
You seeIt meansDo this
wecom_invalid_keyerrcode 93000: the key is wrong, or the bot was removed from the group.Add the bot again and paste its new URL.
wecom_bot_disablederrcode 93004: message push is disabled.Re-enable the bot in the group.
wecom_rate_limitederrcode 45009: over the limit. Retried after a minute.Leave batching on; raise the floor if it repeats.
[06] WHERE MENTIONS COME FROM/ ROUTES
[07] OPEN IN FISHOUT/ THE INBOX

From WeCom to a drafted reply

“AcmeMail 推出面向小型团队的共享收件箱,与 Notchmail 在中小企业市场正面竞争”, open in the inbox. You send the reply; FishOut never posts.
Google News
83

AcmeMail 推出面向小型团队的共享收件箱,与 Notchmail 在中小企业市场正面竞争

AnnouncementComparisonBrand

Draft reply

Copy and open threadYou send it

Questions