如何通过Slack chat.postMessage接口在text字段发送JSON内容？

核心问题原因 #

直接将Python字典转成的JSON字符串作为text字段值发送时，会触发两个关键问题：

• Slack不会自动将普通JSON文本识别为代码块格式
• 未转义的引号会破坏请求本身的JSON结构，导致接口请求直接失败

解决方案步骤 #

1. 采用Slack代码块格式化语法 #

Slack支持用三个反引号包裹文本实现代码块展示，同时指定语言为json还能实现语法高亮。标准格式如下：

```json
{
  "key": "value",
  "nested_data": {"inner_key": "inner_value"}
}

### 2. Python中正确处理字符串转义与拼接
在Python里需要分三步处理，避免格式冲突：
- 将目标字典转成带缩进的格式化JSON字符串（提升可读性）
- 把JSON字符串包裹进Slack代码块语法模板中
- 利用请求库的自动序列化功能处理最终的请求负载，避免手动转义错误

#### 完整代码示例
```python
import json
import requests

# 准备要发送的目标数据字典
target_data = {
    "user": "curiousengineer",
    "action": "submit_json",
    "metadata": {"status": "pending", "id": "12345"}
}

# 生成格式化的JSON字符串
formatted_json = json.dumps(target_data, indent=2)

# 构造符合Slack格式的消息文本
slack_message = f"```json\n{formatted_json}\n```"

# 组装请求负载
payload = {
    "channel": "#brainstorming",
    "text": slack_message
}

# 设置请求头（替换为你的Slack Bot Token）
headers = {
    "Authorization": "Bearer xoxb-your-slack-token",
    "Content-Type": "application/json"
}

# 发送请求（用json参数自动处理转义，规避手动构造JSON的格式错误）
response = requests.post(
    "https://slack.com/api/chat.postMessage",
    json=payload,
    headers=headers
)

# 验证响应结果
print(response.json())

关键注意事项 #

• 必须使用Slack的代码块语法，否则JSON内容会被当作普通文本，甚至因引号冲突导致请求失败
• 发送请求时优先使用requests.post的json参数，它会自动处理字符串中的特殊字符转义，避免手动转义出错
• 确保你的Slack Bot Token拥有chat:write权限，否则会返回权限不足的错误

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