Taiga webhook推送至Rocket.chat无内容显示问题求助

我之前也碰到过一模一样的情况，核心问题基本都是Taiga默认的Webhook payload格式和Rocket.chat入站Webhook的要求不匹配，导致Rocket.chat没法识别要展示的内容，所以才会收到空消息。下面是具体的原因分析和解决步骤：

核心原因 #

Rocket.chat的入站Webhook需要接收包含特定字段的JSON payload——最基础的是text字段（用来显示消息内容），或者attachments字段（用来渲染富文本消息）。但Taiga默认发送的是事件的原始数据（比如创建项目时的项目ID、创建者信息等），并不包含Rocket.chat能直接识别的text字段，所以Rocket.chat收到后不知道要展示什么，就显示为空。

解决步骤 #

1. 配置Taiga Webhook的自定义模板 #

进入Taiga的Webhook设置页面，找到「Custom template」（自定义模板）选项，编写符合Rocket.chat要求的JSON模板，把Taiga的事件数据映射成Rocket.chat能识别的格式。

举几个常用场景的模板例子：

• 项目创建事件：

{
  "text": "🎉 新项目已创建：*{{ project.name }}*\n创建者：{{ user.full_name }}\n描述：{{ project.description || '无' }}"
}

• 用户故事创建事件：

{
  "text": "📝 新用户故事已添加：*{{ user_story.subject }}*\n所属项目：{{ project.name }}\n创建者：{{ user.full_name }}"
}

• 问题创建事件：

{
  "text": "⚠️ 新问题已提交：*{{ issue.subject }}*\n优先级：{{ issue.priority.name }}\n所属项目：{{ project.name }}\n创建者：{{ user.full_name }}"
}

注意：不同的Taiga事件（比如项目创建、用户故事修改）有不同的可用变量，你可以在Taiga的Webhook设置页面找到对应事件的变量列表，一定要确保变量名拼写正确。

2. 检查Content Type设置 #

在Taiga的Webhook配置中，确认「Content type」选择的是application/json——Rocket.chat的入站Webhook只接受JSON格式的payload，如果选成了表单数据，会直接导致解析失败。

3. 验证模板的合法性 #

如果模板的JSON格式有错误（比如引号未闭合、逗号误用），Taiga发送的payload会无效，Rocket.chat同样会显示空消息。你可以用在线JSON校验工具检查模板的格式，或者直接用Postman等工具，把模板生成的payload手动发送到Rocket.chat的Webhook URL，测试是否能正常显示消息。

4. 确认Rocket.chat Webhook的基本配置 #

最后再检查一下Rocket.chat的入站Webhook是否已经启用，并且权限设置正确（比如允许该Webhook向指定频道发送消息）——不过既然你能收到空消息，说明连接是通的，这一步主要是兜底排查。

按照上面的步骤配置后，Taiga的事件应该就能正确推送到Rocket.chat频道了。

内容的提问来源于stack exchange，提问作者rufino13