借助 Papo 的 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"。 |
工作原理：分步说明
-
在 Papo 面板中生成 API 密钥
访问你的 Papo 账户的开发者区域并创建密钥。账户的公钥也会显示在该屏幕上。密钥只显示一次；请将其保存在安全位置，切勿在前端暴露。 -
在你的网站上创建表单
用你想要发送到 CRM 的字段搭建表单：姓名、电子邮件、电话以及任何额外数据（兴趣、来源、城市等）。表单应向你在下一步构建的端点发出 HTTP 请求（POST）。 -
构建中间端点
在你的服务器或无服务器函数（Node.js、Python、PHP 等）中，创建一个接收表单数据的路由。这段代码将负责：- 验证收到的字段。
- 组装发送给 Papo API 的 JSON payload。
- 使用密钥（Bearer token）进行认证，并可选择在
X-Papo-Public-Key请求头中发送公钥。 - 调用 Papo 的联系人创建端点。
-
调用 Papo 联系人 API
使用联系人创建端点（请查阅https://papo.global/pt/docs上的官方文档，了解确切路径和 payload 格式）。至少发送姓名以及电子邮件或电话。API 响应将确认新联系人已使用这些数据创建。 -
添加自定义属性
如果你的账户已定义自定义属性（如“origem”、“utm_source”、“score”），你可以在同一 payload 或补充调用中发送它们。API 允许在联系人上设置/合并custom_attributes，从而无需之后手动填写这些字段。 -
处理响应并返回给用户
创建成功后，你的端点可以将线索重定向到感谢页面，或显示成功消息。如果出现错误（密钥无效、缺少数据），请记录日志并返回友好的消息。
由于 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 创建免费账户，几分钟内开始将注册表单与 CRM 集成，无需手动输入。