WeCom (企业微信)

Os bots de grupo WeCom são o canal mais simples de conectar. Não há assinatura extra — a chave do bot na URL do webhook é a credencial.

Modo	Status
Notificação	Suportado. Push de texto via robot de grupo.
Ponte IM	Não suportado (bots WeCom não carregam chat inbound).

Payload

O bot de grupo WeCom aceita o mesmo formato de texto flat que o DingTalk:

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

O body é montado pelo helper compartilhado formatText usado por Feishu e DingTalk. O sender é NewWeComSender.

Sem assinatura

A URL do webhook tem o formato

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

O parâmetro de query key= é o identificador do bot e a credencial. Qualquer um que tenha a URL pode postar no grupo. Não há secret separado, nem HMAC, nem timestamp. O sender ignora qualquer valor que você coloque no campo Secret — mesma política de drop na construção que o Slack.

Trate a URL como uma senha

Vazar a URL é equivalente a vazar os direitos de postagem do bot. Rotacione deletando e re-adicionando o bot no grupo WeCom (a chave muda).

Configuração

1. Em um grupo WeCom no desktop → 群机器人 → 添加机器人 → 添加 → 新建. Dê nome e avatar.
2. O WeCom te mostra um Webhook 地址. Copie todo — incluindo o query string ?key=….
3. No Ongrid: Settings → Channels → New → Provider = wecom → Endpoint = a URL do passo 2. Deixe Secret em branco.
4. Clique Test. O bot posta [INFO] Ongrid test no grupo.

Pegadinhas

Um bot por grupo

Cada bot de grupo WeCom é escopado a um grupo. Para entregar alertas a dois grupos, crie dois bots e dois canais Ongrid. (DingTalk e Feishu também funcionam assim; a abstração com que o pipeline de alerta se importa é o canal, não a plataforma de chat.)

mentioned_list não está no payload

O sender distribui texto puro. Mencionar membros específicos (mentioned_list / mentioned_mobile_list) não está implementado hoje — recorra ao webhook genérico se precisar.

Cap de frequência de mensagem

O WeCom limita mensagens de robot-de-grupo a 20 mensagens por minuto por bot. Burst acima disso e o WeCom retorna errcode: 45009 ("api freq out of limit"). O dampening por rule do pipeline de alerta geralmente fica bem abaixo, mas uma rule critical barulhenta em um cluster de 100 hosts pode estourar. Use múltiplos bots e route por equipe se precisar.

Só China (na maior parte)

O host qyapi.weixin.qq.com é intencionado para deployments de China continental. Para times no exterior Slack / Telegram / Larksuite são o melhor fit. WeCom for International (o produto overseas do Tencent) é uma superfície de API diferente e não está conectado hoje.

Comparação com os outros chats chineses

Aspecto	WeCom	Feishu	DingTalk
Autenticação	Só URL key=	sign no body JSON	sign na query URL
Algoritmo de assinatura	Nenhum	HMAC-SHA256	HMAC-SHA256
Passos de configuração	2 (add bot, cola)	4 (sign + secret)	4 (sign + secret)
Suporte a ponte IM	Não	Sim (long-conn)	Só schema

Comece com WeCom se for seu primeiro canal

Mais fácil de configurar, mais difícil de errar. Se alertas não chegam, 99% das vezes é porque o bot foi deletado do grupo ou o host não alcança qyapi.weixin.qq.com.

Relacionado

• Visão geral dos canais
• Webhook — fallback para qualquer superfície de chat que o Ongrid não fala nativamente.