借助 Papo 的 REST API,你可以列出、搜索、创建、更新企业,并将联系人关联到 CRM 中的企业——全部通过已认证的请求完成,无需打开面板。这是以编程方式让 B2B 客户管理与外部系统、ERP、CRM 或自动化工具保持同步的方法。
Papo API 公开了企业模块的资源,让你的运营可以组织 B2B 账户、整合已关联的联系人,并跟踪每家企业的最近对话。通过密钥认证和 JSON 响应,这些端点可将账户视图集成到脚本、自动化流程和 white label 经销商中。
通过 API 进行企业操作的概览
| 操作 | 作用 | 何时使用 |
|---|---|---|
| 列出企业 | 返回 CRM 中已注册的企业,包括名称、域名和联系人数量。 | 审计账户库或将企业与另一个系统同步。 |
| 按名称或域名搜索 | 在 CRM 中定位特定企业。 | 在更新数据或关联联系人之前找到 B2B 账户。 |
| 查看企业详情 | 通过标识符返回某家企业的数据。 | 在集成过程中查询特定账户。 |
| 创建企业 | 创建新企业;名称为必填项,域名和描述为可选项。 | 从 ERP、网站或外部流程自动注册 B2B 账户。 |
| 更新企业 | 更新现有企业的名称、域名和描述。 | 让 CRM 始终与 B2B 客户库保持一致。 |
| 关联联系人 | 将 CRM 中现有联系人关联到企业。 | 巩固联系人与账户之间的关系和历史记录。 |
| 列出联系人和对话 | 返回关联到企业的联系人以及这些联系人的最近对话。 | 在服务或跟进期间获得完整的账户视图。 |
API 认证如何工作
所有写入路由,包括企业操作,都需要账户密钥。它必须作为 Bearer token 发送。账户公钥是可选的,但如果发送,则必须与密钥属于同一账户。
API 的基础 URL 是 https://app.papo.global/api/v1。密钥在 Papo 面板的开发者区域生成。密钥在创建时只显示一次;请将其保存在安全位置,如有泄露嫌疑请撤销。
由于 API 是 REST 并使用 JSON,任何支持 HTTP 的语言都可用于将企业集成到脚本、ERP、CRM 或自动化工具中。官方文档位于 https://papo.global/pt/docs,其中包含认证、参数、响应和代码示例的详细信息。
如何通过 API 实际管理企业
- 进入 Papo 面板的开发者区域并生成密钥。同时复制账户公钥。
- 在每个请求中,使用密钥作为 Bearer token 进行认证。如果想加强验证,请在文档指定的请求头中发送公钥。
- 要列出 CRM 中的企业,请调用企业列表端点。响应会返回每个账户的名称、域名和联系人数量。
- 要定位特定企业,请使用按名称或域名搜索的端点。这样你就能获得更新数据或关联联系人所需的标识符。
- 要创建企业,请发送包含必填名称的 JSON payload。域名和描述可作为可选数据包含在内。
- 要更新企业,请在更新端点中发送新的名称、域名或描述值。
- 要关联现有联系人,请在关联操作中使用联系人标识符和企业标识符。
由于 API 每次请求只处理一个操作,批量管理需要通过按顺序执行调用来完成。Python、Node.js 脚本或 n8n 等工具中的自动化可以读取 CSV 或 ERP 中的账户,注册企业、关联联系人,并收集响应以进行错误处理。
这种集成适合谁
- 在其他 CRM 或 ERP 中维护账户的 B2B 企业,希望自动与 Papo 的企业模块同步。
- 服务账户客户的销售团队,如代理机构、咨询公司、SaaS 和供应商,需要按企业整合联系人和对话。
- 通过表单、落地页或外部系统获取企业的运营团队,希望无需手动返工即可在 CRM 中创建这些企业。
- white label 经销商和集成商,将 Papo 连接到客户系统,并希望在不同环境之间保持账户管理一致。
- 构建自定义集成的 IT 团队,使用 API 作为企业库与其余运营之间的桥梁。
常见问题
我需要先创建联系人,再关联到企业吗?
是的。API 会关联 CRM 中已存在的联系人。要注册新联系人,请使用联系人创建端点,然后再与企业关联。
我可以通过 API 更新企业的哪些数据?
可以更新企业的名称、域名和描述。创建时要求名称;域名和描述是可选项。
API 可以列出企业的对话吗?
可以。企业模块允许列出关联到某家企业的联系人以及这些联系人的最近对话,便于在服务期间查看账户视图。
认证方式与 Papo 其他端点相同吗?
是的。写入路由需要账户密钥,并作为 Bearer token 发送。公钥是可选的,如果发送,则必须属于同一账户。
我在哪里可以找到确切的路径和 payload 格式?
在官方 API 文档中,地址为 https://papo.global/pt/docs。那里有企业及其他资源的认证、参数、响应和代码示例等详细信息。
我可以使用 API 将企业库与我当前的 CRM 同步吗?
可以。由于 API 是 REST 并使用 JSON,你可以按顺序自动化列出、创建、更新和关联联系人,让两个系统保持一致。
另请阅读
- 如何在 Papo CRM 中使用企业模块
- 如何使用 Papo API 管理联系人的自定义属性
免费开始,并通过 API 在 CRM 中管理企业 → Papo 的第一个用户永久免费,无需信用卡。