评论¶
代表用户向文档、任务、Tasks 项目（initiative）、CRM 公司或 CRM 联系人的讨论添加评论，或在以上任意项的现有评论线程中回复。对于新评论，请通过 entityType 和 entityId 指定目标项。对于回复，请传入 threadId；线程 ID 足以找到其所属项，因此可以省略 entityType 和 entityId。线程 ID 来自 ReadDiscussion；对于文档，则来自 ReadContent。仅当明确要求评论或回复时，才使用此工具。使用 Macro markdown 编写内容，并使用与文档中相同的提及标签链接人员和项目；这些提及会以 chip 形式渲染，并通知被提及的人员。若要评论文档中的文本段落，请改用 CommentOnText；若要发送频道消息，请使用 SendChannelMessage。
参数¶
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
entityType |
"document" | "initiative" | "crm_company" | "crm_contact" |
否 | 要评论的项的类型。新评论时，必须与 entityId 一起提供；回复时可选。 |
entityId |
string | 否 | 要评论的项的 ID。新评论时，必须与 entityType 一起提供；回复时可选。 |
threadId |
string | 否 | 要回复的线程的 ID。省略此参数以在目标项上开启新的讨论评论。 |
content |
string | 是 | 评论内容，使用 Macro markdown 编写，与 Markdown 文档语法相同，包括提及标签。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro