Zapier / Make / CRM 接入
以兩個方向把 Webnav.ai 連到 Zapier、Make 或你自己的 CRM：
- 拉取資料：開放 REST API（Bearer API Key）—— 線索、工單、對話。
- 接收事件：對外 Webhook（HMAC 簽名）—— 即時推送。
1. 建立 API Key
Dashboard → Developers → API Keys → 建立。複製 key（wn_live_…），僅顯示一次。
2. 拉取資料（REST API）
帶上 Authorization: Bearer wn_live_…，返回的資料僅限你擁有的域名。
bash
curl -H "Authorization: Bearer wn_live_xxx" \
"https://www.webnav.ai/api/v1/leads?limit=50&since=2026-01-01T00:00:00Z"| 端點 | 返回 |
|---|---|
GET /api/v1/leads | 線索（?limit、?since） |
GET /api/v1/tickets | 工單（?status） |
GET /api/v1/conversations | 問題日誌 |
在 Zapier 用「Webhooks → GET」或自訂 app 輪詢，在 Make 用 HTTP module，帶上述 Bearer 標頭，把 data[] 映射到你的 CRM。
3. 接收事件（Webhook）
Dashboard → Developers → Webhooks → 新增端點 URL（例如 Zapier「Catch Hook」URL），選域名與事件（lead.captured、ticket.created）。複製簽名密鑰（僅顯示一次）。
事件觸發時，Webnav.ai 會 POST JSON：
json
{ "event": "lead.captured", "domain": "shop.example.com",
"data": { "lead_id": "…", "email": "a@b.com", "name": "Jane" }, "ts": 1749800000 }標頭：X-Webnav-Event、X-Webnav-Timestamp、X-Webnav-Nonce、X-Webnav-Signature。
驗證簽名（自有伺服器建議；Zapier/Make 的 catch hook 可略過）：
signature = base64( HMAC_SHA256(secret, `${timestamp}\n${nonce}\n${base64(sha256(rawBody))}`) )用 Dashboard 裡 Webhook 旁的 Test 按鈕發一條 ping 事件，確認你的端點能收到。
事件
| 事件 | 觸發時機 |
|---|---|
lead.captured | 訪客留下聯絡方式（表單或自動偵測郵箱） |
ticket.created | 提交工單 |
訂閱全部用 *。