對於開發商

Cyzyra 在您的系統中。以及 Cyzyra 中的您的系統。

REST API、簽署的 Webhook 以及與 AI 助理的連接。將公司資料匯入 ERP、BI 或您自己的應用程式。

捲曲 https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "授權：承載 cy_live_..."

{ "data": [{ "id": "…", "name": "…", "status": "new" }], "next_cursor": null }

調用和響應的說明性範例。

01 / 三種整合方式

閱讀、接收和詢問。

使用一個、兩個或全部三個。他們都尊重擁有金鑰的公司的權限和資料。

休息API
JSON 格式的潛在客戶、談判、付款、物件和指標以及 OpenAPI 文件。
網路鉤子
18 公司活動透過訂閱立即傳送到您的系統。
人工智慧助理（MCP）
將 Cyzyra 連接到兼容 MCP 的 AI 助手，並詢問銷售、廣告和利潤。

02 / 休息API

端點

認證方式 授權：持票人, 、JSON 回應和遊標分頁。

每個按鍵每分鐘 120 個請求
密鑰僅儲存為哈希值

GET/api/v1/leads列出並蒐索潛在客戶
POST/api/v1/leads創建潛在客戶（帶重複檢查）
GET/api/v1/leads/{id}Um lead com os detalhes
PATCH/api/v1/leads/{id}更新潛在客戶
GET/api/v1/deals談判和漏斗階段
POST/api/v1/deals建立交易
GET/api/v1/payments帳單和付款
GET/api/v1/objects您的物件類型
GET/api/v1/objects/{type}/records物件類型的記錄
POST/api/v1/objects/{type}/records建立記錄
POST/api/v1/query帶有過濾器和周期的指標
POST/api/v1/ask關於數據的葡萄牙語問題

03 / 網路鉤子

它發生在公司，它到達了你的系統。

選擇活動和地址。每次提交都會進行簽名，失敗的最多可重新發送 5 次。

帶時間的 HMAC 簽名，防止重發
儀表板上每次嘗試的歷史記錄

// Cabeçalho: X-Cyzyra-Signature: t=1731000000,v1=<hmac>
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const esperado = hmacSha256(segredo, `${t}.${corpoBruto}`);
if (esperado !== v1) throw new Error("assinatura inválida");

18 可用的事件

Lead criadolead.created
Status do lead mudoulead.status_changed
Cadastros unificadoslead.merged
Negociação criadadeal.created
Negociação mudou de etapadeal.stage_changed
Venda ganhadeal.won
Venda perdidadeal.lost
已發送提案proposal.sent
提案被接受proposal.accepted
Proposta recusadaproposal.rejected
合約已發送contract.sent
Contrato assinadocontract.signed
電荷已創建payment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / 人工智慧助手

從您的助手內部詢問 Cyzyra。

使用您的 API 金鑰將 Cyzyra 的 MCP 位址新增為相容的 AI 助理中的自訂連接器。他開始諮詢利潤、行銷活動和銷售，並用葡萄牙語回答有關他的數據的問題。

URL：https://SEU-PAINEL/api/mcp 標題：授權：Bearer cy_live_... 工具：summary_profit·campaigns·sales Ask·manage_campaigns（寫作）

05 / 問題

技術問題

查看現成的集成

在哪裡建立 API 金鑰？+

在 API 平台儀表板中（選單系統 → API 平台 → API 金鑰）。金鑰僅出現一次； Cyzyra 僅保留其加密版本。

密鑰可以擁有哪些權限？+

閱讀，或說閱讀和寫作。透過 MCP 連線建立潛在客戶或更改行銷活動等操作需要寫入權限。

有使用限制嗎？+

是：每个键每分钟 120 个请求。除此之外，API 會回應 429 並告訴您重試的秒數。

如果 Webhook 失效時我的系統宕機了怎麼辦？+

Cyzyra 最多試 5 次，間隔時間不斷增加，並在儀表板上顯示每次嘗試。

每個鍵看到誰的數據？+

僅來自創建密鑰的公司。其他公司的數據永遠不會出現。

立即建立您的帳戶並產生您的第一個金鑰。

第一個月為 US$ 10,00, ，具有完全存取權限。然後，您選擇計劃。

開始為 US$ 10,00

Prefere falar com uma pessoa? 與團隊交談

取消無罰金 · 保證 30 dias

說明性範例

Cyzyra 在您的系統中。 以及 Cyzyra 中的您的系統。

閱讀、接收和詢問。

休息API

網路鉤子

人工智慧助理（MCP）

端點

它發生在公司，它到達了你的系統。

從您的助手內部詢問 Cyzyra。

技術問題

立即建立您的帳戶並產生您的第一個金鑰。

Cyzyra 在您的系統中。以及 Cyzyra 中的您的系統。