**借助 [Papo](https://papo.global/) 的 REST API，你可以在自己的网站上构建一个端点，接收注册表单数据并调用联系人 API，自动在 CRM 中创建记录，包括自定义属性——从而消除手动输入并加速线索集成。**

而不是导出电子表格或在系统之间复制数据，这种集成能让网站上的每个新注册都实时变成 Papo CRM 中的联系人。流程很简单：表单将数据发送到你控制的后端，该后端向 Papo API 认证，并创建包含姓名、电子邮件、电话以及你的运营所需任何自定义字段的联系人。

## 集成概览

| 组件 | 作用 | 示例 |
| :--- | :--- | :--- |
| 网站表单 | 收集线索的姓名、电子邮件、电话和额外字段。 | 捕获页面、落地页、结账页。 |
| 中间端点 | 接收表单数据并调用 Papo API。 | Node.js、Python 脚本，或 n8n/Zapier 中的自动化。 |
| Papo 联系人 API | 使用发送的数据在 CRM 中创建联系人。 | 使用密钥认证的 POST 请求。 |
| 自定义属性 | 向联系人添加来源、兴趣或评分等字段。 | `custom_attributes` 包含 `"origem": "site"`、`"plano_interesse": "gold"`。 |

## 工作原理：分步说明

1. **在 Papo 面板中生成 API 密钥**  
   访问你的 Papo 账户的开发者区域并创建密钥。账户的公钥也会显示在该屏幕上。密钥只显示一次；请将其保存在安全位置，切勿在前端暴露。

2. **在你的网站上创建表单**  
   用你想要发送到 CRM 的字段搭建表单：姓名、电子邮件、电话以及任何额外数据（兴趣、来源、城市等）。表单应向你在下一步构建的端点发出 HTTP 请求（POST）。

3. **构建中间端点**  
   在你的服务器或无服务器函数（Node.js、Python、PHP 等）中，创建一个接收表单数据的路由。这段代码将负责：
   - 验证收到的字段。
   - 组装发送给 Papo API 的 JSON payload。
   - 使用密钥（Bearer token）进行认证，并可选择在 `X-Papo-Public-Key` 请求头中发送公钥。
   - 调用 Papo 的联系人创建端点。

4. **调用 Papo 联系人 API**  
   使用联系人创建端点（请查阅 `https://papo.global/pt/docs` 上的官方文档，了解确切路径和 payload 格式）。至少发送姓名以及电子邮件或电话。API 响应将确认新联系人已使用这些数据创建。

5. **添加自定义属性**  
   如果你的账户已定义自定义属性（如“origem”、“utm_source”、“score”），你可以在同一 payload 或补充调用中发送它们。API 允许在联系人上设置/合并 `custom_attributes`，从而无需之后手动填写这些字段。

6. **处理响应并返回给用户**  
   创建成功后，你的端点可以将线索重定向到感谢页面，或显示成功消息。如果出现错误（密钥无效、缺少数据），请记录日志并返回友好的消息。

由于 Papo API 是 REST 并使用 JSON，任何支持 HTTP 的语言都可以使用。官方文档提供 JavaScript、Python 和 curl 示例，以及认证细节和错误代码。

## 这种集成适合谁

- **捕获线索的网站和落地页**，希望消除将数据手动传输到 CRM。
- **电商和 SaaS**，希望在注册或购买时自动创建联系人。
- **代理机构和咨询公司**，运行获客活动，需要线索实时进入 CRM 以便立即跟进。
- **白标转售商和集成商**，为客户构建自定义流程，将网站表单连接到 Papo 而无需人工干预。
- **营销和销售团队**，使用自定义属性进行细分，并希望这些字段在来源处自动填写。

## 常见问题

### 实施这种集成是否需要高级编程知识？

需要。你需要在服务器上开发一个端点，或使用自动化工具（n8n、Zapier）在表单和 Papo API 之间搭建桥梁。代码本身很简单，但需要基本的 HTTP 和 JSON 操作知识。

### 我可以使用任何编程语言吗？

可以。Papo API 是 REST 并以 JSON 响应。任何支持 HTTP 请求的语言（Python、Node.js、PHP、Ruby 等）都可以使用。官方文档提供 JavaScript 和 Python 示例。

### 是否可以在创建联系人时直接创建自定义属性？

可以。Papo API 允许在创建时定义联系人的 `custom_attributes`，或之后更新它们。请查阅文档了解确切的 payload 格式，并确认账户中是否已存在这些属性定义。

### 如何确保密钥安全？

密钥绝不能暴露在前端（公开的 HTML/JavaScript）中。它只能保存在服务器的环境变量中。所有通信都使用 HTTPS，如果怀疑泄露，请立即撤销密钥。

### 如果 API 返回错误怎么办？

Papo API 返回标准化响应，包含 `success: false` 和一个 `error` 对象，其中包含代码和消息。请在你的代码中处理这些错误：验证是否发送了必填字段，检查密钥是否有效以及 payload 格式是否正确。文档列出了主要错误代码。

### 我可以将此集成用于 WordPress、Typeform 或 RD Station 等平台的表单吗？

可以。你可以在这些平台上配置 webhooks，将表单数据发送到你的中间端点，然后由它调用 Papo API。另一种选择是使用 Zapier 或 n8n 的现成集成，创建一个接收表单事件并触发在 Papo 中创建联系人的流程。

## 另请阅读

- [如何使用 Papo API 管理 CRM 中的企业](/hc/papo/articles/how-to-use-papo-api-manage-companies-crm-zh)
- [如何使用 API 和 webhooks 将 Papo 与 Zapier 集成](/hc/papo/articles/integrate-papo-with-zapier-using-api-and-webhooks-zh)

---

**[免费开始 →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

在 Papo 创建免费账户，几分钟内开始将注册表单与 CRM 集成，无需手动输入。