WeCom (企业微信)

Los bots de grupo de WeCom son el canal más simple de cablear. No hay firma extra — el bot key en la URL del webhook es la credencial.

Modo	Estado
Notificación	Soportado. Push de texto de robot de grupo.
IM bridge	No soportado (los bots de WeCom no llevan chat entrante).

Payload

El bot de grupo de WeCom acepta la misma forma de texto plano que DingTalk:

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

El body lo construye el helper compartido formatText usado por Feishu y DingTalk. El sender es NewWeComSender.

Sin firma

La URL del webhook tiene la forma

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

El parámetro de query key= es el identificador del bot y la credencial. Cualquiera que tenga la URL puede postear al grupo. No hay secret separado, sin HMAC, sin timestamp. El sender ignora cualquier valor que pongas en el campo Secret — misma política de drop-on-construction que Slack.

Trata la URL como una contraseña

Filtrar la URL es equivalente a filtrar los derechos de posteo del bot. Rota borrando y re-añadiendo el bot en el grupo de WeCom (la key cambia).

Setup

1. En un grupo de WeCom en desktop → 群机器人 → 添加机器人 → 添加 → 新建. Dale un nombre y avatar.
2. WeCom te muestra una Webhook 地址. Cópiala completa — incluyendo el query string ?key=….
3. En Ongrid: Settings → Channels → New → Provider = wecom → Endpoint = la URL del paso 2. Deja Secret en blanco.
4. Pulsa Test. El bot postea [INFO] Ongrid test al grupo.

Quirks

Un bot por grupo

Cada bot de grupo de WeCom está scoped a un grupo. Para entregar alertas a dos grupos, crea dos bots y dos canales de Ongrid. (DingTalk y Feishu también funcionan así; la abstracción que le importa al pipeline de alertas es el canal, no la plataforma de chat.)

mentioned_list no está en el payload

El sender envía texto puro. Mencionar miembros específicos (mentioned_list / mentioned_mobile_list) no está construido hoy — alcanza el webhook genérico si lo necesitas.

Tope de frecuencia de mensajes

WeCom topa los mensajes de group-robot en 20 mensajes por minuto por bot. Bursts por encima y WeCom devuelve errcode: 45009 ("api freq out of limit"). El dampening por-regla del pipeline de alertas usualmente se mantiene bien por debajo, pero una regla crítica ruidosa en un cluster de 100 hosts puede reventarlo. Usa múltiples bots y rutea por-equipo si tienes que.

Solo China (mayormente)

El host qyapi.weixin.qq.com está pensado para despliegues de China continental. Para equipos en el extranjero Slack / Telegram / Larksuite son el mejor fit. WeCom para International (el producto overseas de Tencent) es una superficie de API diferente y no está cableado hoy.

Comparación con los otros chats chinos

Aspecto	WeCom	Feishu	DingTalk
Autenticación	URL key= solo	sign en JSON body	sign en URL query
Algoritmo de firma	Ninguno	HMAC-SHA256	HMAC-SHA256
Pasos de setup	2 (añadir bot, pegar)	4 (sign + secret)	4 (sign + secret)
Soporte IM bridge	No	Sí (long-conn)	Solo schema

Empieza con WeCom si es tu primer canal

El más fácil de configurar, el más difícil de configurar mal. Si las alertas no aterrizan, el 99% de las veces es porque el bot fue borrado del grupo o el host no puede alcanzar qyapi.weixin.qq.com.

Relacionado

• Overview de canales
• Webhook — fallback para cualquier superficie de chat que Ongrid no habla nativamente.