透過一次 HTTP 呼叫,就能從你的網站、表單或後端新增客戶,並在你的伺服器收到以 HMAC-SHA256 簽署的每一項變更。
你的 CRM 不再只是要登入手動輸入資料的地方,而是你的系統可以直接呼叫的端點。
AiCrm 是 AIsToHire 的 CRM 應用程式,針對你自己的聯絡人提供公開的 REST API。只要在 `X-Api-Key` 標頭帶上金鑰,就能從你的網站表單、聊天機器人、Zap、Python 指令碼或你自己的後端,建立、列出、查詢、更新與刪除聯絡人,並為其中任何一位新增活動。回應為 `{ success, data }` 格式的 JSON,限制為每組金鑰每分鐘 100 次請求。
透過 API 新增不會產生重複:如果你送出的電子郵件已存在於資料庫,AiCrm 會更新你原有的資料(補上缺少的電話、姓名或公司,並合併標籤),並在其時間軸記錄一次新的送出,回傳 HTTP 200;若是新的聯絡人,則建立並回傳 201。每位透過 API 進來的聯絡人都會自動標上 `api-lead`,保留你傳送的標籤,並記錄來源的 `subId`,以及來訪的國家、IP 與瀏覽器。
你最多可以擁有 20 組自訂名稱的 API key,另外還有應用程式的內部金鑰。這樣就能為每個整合各發一組不同的金鑰——網站、五月活動的表單、實習生、供應商——並在該整合結束時單獨撤銷,不影響其他的。金鑰的完整值只會在建立時顯示一次,之後在清單中僅以遮罩顯示。
反方向則由 Webhook 通知你的系統。你最多可設定 10 個目的地,選擇每個目的地訂閱哪些事件(`customer.created`、`customer.updated`、`customer.deleted`、`activity.created`),AiCrm 會對你的網址發出 POST,並帶上 `X-AiCrm-Event` 與 `X-AiCrm-Signature: sha256=…` 標頭——也就是以該 Webhook 的密鑰對內容計算的 HMAC-SHA256 簽章——讓你驗證通知是否合法。儲存網址時,SSRF 防護會拒絕 localhost、127.0.0.0/8、10.x、192.168.x、172.16-31.x、::1、0.0.0.0,以及 `.local` 與 `.internal` 網域。
Ventaja 1
一次呼叫就能新增聯絡人:對 `/api/apps/public/crm/customers` 發送一個 POST,附上電子郵件與你想要的標籤,潛在客戶就已分類好存在你的 CRM 中。
Ventaja 2
設計上不會重複:如果電子郵件已存在,就會更新該筆資料,並在其時間軸記錄這次新的送出,而不是另外建立第二筆。
Ventaja 3
最多可建立 20 組具名金鑰:每個整合各用一組,可分別撤銷。若某組金鑰外洩,只要刪除那一組,其他功能完全不受影響。
Ventaja 4
以 HMAC-SHA256 簽署的 Webhook:用你的密鑰驗證 `X-AiCrm-Signature` 標頭,就能確認通知來自你的 CRM,而非第三方。
Ventaja 5
內建 SSRF 防護:應用程式會拒絕將 Webhook 送往 localhost 或私有網段,因此你的 CRM 不會被拿來探測內部網路。
Ventaja 6
完整的 CRUD,不只是新增:可分頁並依搜尋、狀態、標籤、國家篩選列出聯絡人,查詢單一聯絡人及其活動、更新、刪除,並為其登錄活動。
Ventaja 7
自動追蹤來源:每筆透過 API 新增的資料都會記錄你傳送的 `subId`,以及國家、IP 與瀏覽器,並標上 `api-lead` 標籤,方便之後在應用程式中篩選。
Ventaja 8
測試不必猜:應用程式內附端點文件,提供可複製的 `curl` 範例,以及可對每個 Webhook 發送測試通知的按鈕,並顯示最近一次嘗試的狀態與時間。

AiCrm 是 AIsToHire 的 CRM 工具,可透過 REST API 接收你的聯絡人,並以簽署的 Webhook 通知你的系統。建立帳號、產生金鑰,就能發出第一次呼叫。