使用 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 指南。