使用Simple Salesforce与Chatter实现@提及功能失败求助

问题核心 #

尝试用Simple Salesforce的Bulk API创建FeedItem时，@提及仅显示为纯文本；按照Chatter API文档尝试使用messageSegments时，因Bulk API不支持该字段触发报错。

错误原因 #

Salesforce的Bulk API（sf.bulk.feeditem.insert）操作FeedItem对象时，不支持messageSegments参数——这个参数是Chatter REST API专属的，并非FeedItem标准字段，所以传入会触发INVALID_FIELD错误。同时Bulk API也不会解析{@salesforce_id}这类提及格式，只会当作纯文本处理。

正确解决方案 #

要实现带@提及的Chatter帖子，需使用Simple Salesforce的Chatter专用方法或直接调用Chatter REST API端点。

方法1：使用sf.chatter_post内置方法 #

Simple Salesforce提供了专门的Chatter发帖方法，可直接构造带提及的内容：

# 替换为实际的Parent ID和目标用户ID
parent_id = "parent_salesforce_id"
target_user_id = "user_salesforce_id"

# 构造消息段：文本 + 提及用户
message_segments = [
    {"type": "Text", "text": "您好，"},
    {
        "type": "Mention",
        "id": target_user_id,
        "text": "@测试用户"  # 帖子中显示的提及文本，可自定义为用户姓名
    },
    {"type": "Text", "text": " 请查看这条通知。"}
]

# 发布Chatter帖子
response = sf.chatter_post(
    feed_element_type="FeedItem",
    subject_id=parent_id,
    message_segments=message_segments
)

print(response)

方法2：直接调用Chatter REST API #

如果内置方法不满足需求，可直接调用Salesforce的Chatter API端点：

import json

# 构造请求体
payload = {
    "body": {
        "messageSegments": [
            {"type": "Text", "text": "批量测试提及："},
            {
                "type": "Mention",
                "id": "user_salesforce_id",
                "text": "@张三"
            }
        ]
    },
    "feedElementType": "FeedItem",
    "subjectId": "parent_salesforce_id"
}

# 发送POST请求
response = sf.restful(
    "chatter/feed-elements",
    method="POST",
    data=json.dumps(payload)
)

print(response)

补充说明 #

• 若需批量创建带提及的帖子，可循环调用上述方法，注意控制API调用次数避免触发限制。
• 提及用户必须使用用户的Salesforce ID，不能直接用姓名；text字段是帖子中显示的提及文本，可自定义为用户姓名或其他内容。

内容的提问来源于stack exchange，提问作者I am Groot