使用 Codex 或 Claude Code 连接 ABC Sales AI
正在用 AI 编程助手制作网站？把 ABC 的集成说明交给它，就能协助您将网站表单连接到 ABC Sales AI 账户。访客在网站填写表单后，资料便会作为潜在客户传入 ABC。
ABC Codex 插件为 Codex 提供编写连接所需的说明。Claude Code则可以使用放在项目中的同一套集成技能。按您使用的助手选择一种设置方式即可，不需要两种都安装。
它可以帮您做什么？
- 将联系、报价、报名或申请表单连接到 ABC。
- 将姓名、电话号码、邮箱和自定义答案对应到正确的潜在客户字段。
- 在表单需要时，添加文件上传和防垃圾提交功能。
- 协助开发人员使用 ABC API 构建服务器端集成，例如读取对话或订阅潜在客户事件。
目前的插件提供集成说明和 API 参考资料。编程助手仍然需要访问您的项目文件，并取得适当的 ABC 连接资料。它与 ABC 应用内的 AI Manager 是不同的工具。
步骤 1：设置您的编程助手
选项 A：Codex
在 Codex 中打开您的网站项目，然后粘贴以下内容：
codex plugin marketplace add https://git.jcalonso.com/abcsalesbot/abcsalesai-codex-plugin.gitcodex plugin add abcsalesai@abcsalesai-pluginscodex plugin list --marketplace abcsalesai-plugins --json确认 abcsalesai@abcsalesai-plugins 已安装并启用。如果已经安装，请验证现有安装，不要重复创建。请说明任何身份验证或 CLI 错误，不要要求我将密码或访问令牌粘贴到对话中。
添加插件市场后，插件才会出现在可安装列表中。第二条命令负责安装。验证结果应显示 installed: true 和 enabled: true。如果安装后当前对话仍无法使用，请在同一项目中开启新的 Codex 任务，并要求它使用 ABC 集成技能。
选项 B：Claude Code
此选项适用于在网站项目中运行的 Claude Code。仓库目前提供的是 Codex 插件清单，因此应使用其中的技能文件，不要尝试将它安装为 Claude 插件市场。
将以下内容粘贴到 Claude Code：
阅读 plugins/abcsalesai/skills/abc-lead-integration/SKILL.md 及其引用的文件。将完整的 abc-lead-integration 文件夹复制到此项目的 .claude/skills/ 目录，包括 reference 文件夹。保留现有项目指令；如果已有同名技能，先检查再决定是否替换。确认 .claude/skills/abc-lead-integration/SKILL.md 和 reference/abc-public-api.yaml 都存在。如果无法访问仓库，请说明缺少什么权限，不要要求我将凭据粘贴到聊天中。
然后请 Claude Code 在连接表单时使用 abc-lead-integration。只复制 SKILL.md 会遗漏它需要的 API 参考资料。项目技能的运作方式可参考 Claude Code 技能指南。
步骤 2：准备 ABC 网站表单
在应该接收潜在客户的 ABC 账户中，打开设置 > 网站表单。按照将您的网站表单连接到 ABC Sales AI的步骤创建连接。
准备好以下资料：
- 环境： 正式或测试环境。使用在对应 ABC 应用中创建的表单密钥。
- 表单密钥： 保存后复制的公开密钥，以
pfk_开头。 - 网站地址： 在允许的网站中加入准确的来源网址，例如
https://www.example.com，不要包含页面路径。 - 字段对应： 网站实际发送的准确名称，以及每个答案的保存位置。例如，如果网站发送这些名称，可设置
name→ 名称、email→ 邮箱、phone→ 电话。 - 防垃圾提交： 无防护，或 Cloudflare Turnstile 及其公开的网站密钥（Site key）。选择自动化时必须使用 Turnstile。
- 下一页： 提交成功后，访客应该前往的页面。
如果不清楚网站的字段名称，请让编程助手检查表单，并提供可粘贴到字段对应（Field matching）中的值。如果不同语言的潜在客户归属不同 ABC 账户，请为各账户分别准备连接。
步骤 3：复制这段连接提示词
替换每个占位内容，然后粘贴到 Codex 或 Claude Code：
表单页面：{FORM_PAGE_URL}
ABC 环境：{LIVE_OR_STAGING}
公开表单密钥：{PFK_FORM_KEY}
允许的网站来源网址：{WEBSITE_ORIGIN}
字段对应：{EXACT_WEBSITE_FIELD_NAMES_AND_ABC_DESTINATIONS}
防垃圾提交：{NONE_OR_TURNSTILE}
如已启用，公开的 Turnstile 网站密钥：{SITE_KEY_OR_NOT_NEEDED}
感谢页面：{THANK_YOU_PAGE_URL}
使用对应环境的 Website Forms 提交接口。将公开表单密钥放在 X-Form-Key，将答案放在 fields；启用 Turnstile 时，将验证凭证放在 captcha_token。不要把私密凭据放进浏览器端代码。只有 ABC 确认成功后，才跳转到感谢页面。失败时保留访客的答案，并说明如何重试。执行相关检查，向我展示修改内容。在进行可能触发后续跟进的真实提交之前，请让我指定测试联系人。
公开表单密钥用于识别接收答案的表单。它是为网站代码使用而设计的，不是访客需要填写的字段。助手负责编写连接代码，再通过您平时的网站部署流程发布。
步骤 4：验证完整流程
- 使用您能控制的测试联系方式，在已部署的网站上提交表单。
- 到预期的 ABC 账户检查潜在客户、答案和来源。
- 确认网站在提交成功后打开感谢页面。
- 另外检查已设置的自动化或后续跟进。
仅看到感谢页面，不代表潜在客户已经保存。请助手明确区分模拟测试和真实提交，并在上线前确认网站和 ABC 两端都正常。
哪些密钥可以交给助手？
- 公开表单密钥（
pfk_）： 可以放入网站设置提示词和浏览器端代码。 - Turnstile 网站密钥（Site key）： 公开；网站需要该组件时，可以交给助手。
- Turnstile 私钥（Secret key）： 只填入 ABC。不要放入公开代码或设置提示词。
- 私密 ABC API 密钥： 用于服务器端 API 集成。保存在服务器的环境变量或机密设置中，不要放入浏览器端代码或聊天。请参考公开 API 指南。