WeCom (企业微信)

WeCom 그룹 봇은 배선이 가장 간단한 채널입니다. 추가 서명 없음 — webhook URL 의 봇 키가 자격 증명 입니다.

Mode	Status
알림	지원됨. 그룹 로봇 텍스트 push.
IM 브릿지	미지원 (WeCom 봇은 인바운드 채팅을 운반하지 않음).

Payload

WeCom 의 그룹 봇은 DingTalk 과 같은 flat text 형태를 수락:

{
  "msgtype": "text",
  "text": {"content": "[CRITICAL] node-01 swap_high\nswap_in_pages > 1000 for 5m\nsource: alert\ndedupe: alert:swap_high:device=7"}
}

body 는 Feishu 와 DingTalk 이 사용하는 공유 formatText 헬퍼가 빌드. sender 는 NewWeComSender.

서명 없음

webhook URL 은 다음 형태:

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=<bot-uuid>

key= 쿼리 파라미터는 봇 식별자이자 자격 증명. URL 을 가진 누구나 그룹에 게시 가능. 별도 시크릿, HMAC, timestamp 없음. sender 는 Secret 필드에 넣은 값을 무시 — Slack 과 같은 drop-on-construction 정책.

URL 을 비밀번호처럼 다루세요

URL 유출은 봇 게시 권한 유출과 같습니다. WeCom 그룹에서 봇을 삭제하고 다시 추가하면 회전됩니다 (키가 바뀜).

설정

1. 데스크톱의 WeCom 그룹에서 → 群机器人 → 添加机器人 → 添加 → 新建. 이름과 아바타 부여.
2. WeCom 이 Webhook 地址 를 보여 줍니다. ?key=… 쿼리 문자열을 포함해 전체 복사.
3. Ongrid 에서: Settings → Channels → New → Provider = wecom → Endpoint = 2 단계의 URL. Secret 비워둠.
4. Test 클릭. 봇이 그룹에 [INFO] Ongrid test 를 게시.

특이점

그룹당 봇 하나

각 WeCom 그룹 봇은 한 그룹 으로 범위가 한정됩니다. 두 그룹에 알림을 전달하려면 두 봇과 두 Ongrid 채널을 만드세요. (DingTalk 과 Feishu 도 이렇게 동작; 알림 파이프라인이 신경 쓰는 추상은 채팅 플랫폼이 아닌 채널입니다.)

mentioned_list 는 payload 에 없음

sender 는 순수 텍스트 출하. 특정 멤버 멘션 (mentioned_list / mentioned_mobile_list) 은 오늘 빌드되지 않음 — 필요하면 일반 webhook 으로.

메시지 빈도 상한

WeCom 은 그룹 로봇 메시지를 봇당 분당 20 개 로 제한. 그 이상 버스트 시 WeCom 은 errcode: 45009 ("api freq out of limit") 를 반환합니다. 알림 파이프라인의 규칙별 댐핑은 대개 그 아래에 머물지만, 100 호스트 클러스터의 시끄러운 critical 규칙은 그것을 뚫을 수 있습니다. 필요하면 다중 봇을 사용하고 팀별로 라우팅하세요.

중국 전용 (대부분)

qyapi.weixin.qq.com 호스트는 중국 본토 배포용입니다. 해외 팀은 Slack / Telegram / Larksuite 이 더 적합. WeCom for International (텐센트의 해외 제품) 은 다른 API 표면이며 오늘 배선되지 않습니다.

다른 중국 채팅들과의 비교

Aspect	WeCom	Feishu	DingTalk
인증	URL key= 만	JSON body 의 sign	URL 쿼리의 sign
서명 알고리즘	없음	HMAC-SHA256	HMAC-SHA256
설정 단계	2 (봇 추가, 붙임)	4 (sign + secret)	4 (sign + secret)
IM 브릿지 지원	아니오	예 (long-conn)	스키마만

첫 채널이라면 WeCom 으로 시작하세요

설정이 가장 쉽고 오설정이 가장 어렵습니다. 알림이 도착하지 않는다면 99% 봇이 그룹에서 삭제되었거나 호스트가 qyapi.weixin.qq.com 에 도달할 수 없는 것입니다.

관련

• 채널 개요
• Webhook — Ongrid 가 네이티브로 말하지 않는 채팅 표면용 폴백.