ListCompanies¶
列出已认证用户的团队所跟踪的 CRM 公司，按最近互动时间排序。每一行包含公司 id、名称、域名、最近互动时间，以及公司自身的 Stage / Owner / Revenue 属性（如已设置，而非管道交易的属性）。使用筛选条件来缩小结果范围：search 用于名称/域名文本，stage 用于公司自身的 Stage 属性，owner_user_id 用于按用户筛选公司。使用 GetCompany 获取某家公司的完整详细信息（联系人 + 所有属性），并使用 SetEntityProperty（entity_type=company）更改公司自身的 Stage / Owner / Revenue 或自定义属性。管道中的交易拥有独立于这些属性的阶段与字段：请使用 FindPipelineEntries 和 UpdatePipelineEntries 来处理它们。
参数¶
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
search |
string | 否 | 不区分大小写的子字符串，与公司名称和域名进行匹配（例如 "acme" 可匹配 "Acme Corp" 和 "acme.com"）。 |
stage |
string | 否 | 筛选出公司自身 Stage 属性（而非管道交易的阶段）为指定值的公司。接受不区分大小写的阶段标签（例如 "lead"、"Customer" —— 团队可能有自定义阶段名称）或阶段选项 UUID。 |
owner_user_id |
string | 否 | 筛选出 Owner 属性为指定 Macro 用户 id 的公司（例如 "macro|user@example.com"）。使用 ListTeamMembers 查找用户 id。 |
include_hidden |
boolean | 否 | 同时包含在 CRM 中隐藏的公司。默认为 false。需要团队管理员或所有者角色。 |
limit |
integer | 否 | 返回的公司数量上限。默认为 50；最大 200。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro