डेवलपर्स के लिए

आपके सिस्टम के भीतर Cyzyra। और Cyzyra के भीतर आपके सिस्टम।

REST API, हस्ताक्षरित वेबहुक और AI सहायकों से कनेक्शन। कंपनी डेटा को ईआरपी, बीआई या अपने स्वयं के एप्लिकेशन पर ले जाने के लिए।

दस्तावेज़ीकरण पढ़ें एपीआई प्लेटफॉर्म खोलें

कर्ल https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "प्राधिकरण: बियरर cy_live_..."

{ "डेटा": [{ "आईडी": "...", "नाम": "...", "स्थिति": "नया" }], "अगला_कर्सर": शून्य }

कॉल और प्रतिक्रिया का उदाहरणात्मक उदाहरण.

01 / एकीकृत करने के तीन तरीके

पढ़ें, प्राप्त करें और पूछें।

एक, दो या तीनों का प्रयोग करें। वे सभी कुंजी की अनुमतियों और उस कंपनी के डेटा का सम्मान करते हैं जो इसका मालिक है।

बाकी एपीआई
OpenAPI दस्तावेज़ीकरण के साथ JSON में लीड, बातचीत, भुगतान, ऑब्जेक्ट और मेट्रिक्स।
वेबहुक
18 कंपनी के इवेंट सदस्यता के साथ तुरंत आपके सिस्टम पर भेजे जाते हैं।
एआई सहायक (एमसीपी)
Cyzyra को MCP-संगत AI सहायकों से कनेक्ट करें और बिक्री, विज्ञापन और लाभ के बारे में पूछें।

02 / रेस्ट एपीआई

अंतिमबिंदुओं

द्वारा प्रमाणीकरण प्राधिकरण: वाहक, JSON प्रतिक्रियाएँ और कर्सर पेजिनेशन।

प्रति कुंजी प्रति मिनट 120 अनुरोध
कुंजी केवल हैश के रूप में संग्रहीत है

GET/api/v1/leadsलीड की सूची बनाएं और खोजें
POST/api/v1/leadsएक लीड बनाएं (डुप्लिकेट चेकिंग के साथ)
GET/api/v1/leads/{id}विवरण के साथ एक लीड
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 बार तक नाराजगी जताई जाती है।

समय के साथ एचएमएसी हस्ताक्षर, पुनः भेजने के विरुद्ध
डैशबोर्ड पर प्रत्येक प्रयास का इतिहास

// 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 / एआई सहायक

अपने सहायक के अंदर से साइज़िरा से पूछें।

अपनी API कुंजी के साथ संगत AI सहायक में कस्टम कनेक्टर के रूप में Cyzyra का MCP पता जोड़ें। वह लाभ, अभियान और बिक्री पर परामर्श देना शुरू करता है और अपने डेटा के बारे में पुर्तगाली में सवालों के जवाब देता है।

यूआरएल: https://SEU-PAINEL/api/mcp शीर्षलेख: प्राधिकरण: वाहक cy_live_... उपकरण: सारांश_लाभकारी · अभियान · बिक्री पूछना · प्रबंधन_अभियान (लेखन)

05/प्रश्न

तकनीकी प्रश्न

तैयार एकीकरण देखें

मैं एपीआई कुंजी कहां बनाऊं?+

एपीआई प्लेटफ़ॉर्म डैशबोर्ड में (मेनू सिस्टम → एपीआई प्लेटफ़ॉर्म → एपीआई कुंजी)। कुंजी केवल एक बार प्रकट होती है; साइज़िरा इसका केवल एक एन्क्रिप्टेड संस्करण रखता है।

किसी कुंजी की क्या अनुमतियाँ हो सकती हैं?+

पढ़ना, या पढ़ना और लिखना। एमसीपी कनेक्शन पर लीड बनाने या अभियान बदलने जैसी कार्रवाइयों के लिए लेखन अनुमति की आवश्यकता होती है।

क्या उपयोग की कोई सीमा है?+

हाँ: 120 अनुरोध प्रति मिनट प्रति कुंजी। इससे ऊपर, एपीआई 429 पर प्रतिक्रिया देता है और आपको बताता है कि दोबारा प्रयास करने के लिए कितने सेकंड हैं।

यदि वेबहुक बंद होने पर मेरा सिस्टम डाउन हो जाए तो क्या होगा?+

साइज़िरा बढ़ते अंतराल के साथ 5 बार तक पुनः प्रयास करता है, और प्रत्येक प्रयास को डैशबोर्ड पर प्रदर्शित करता है।

प्रत्येक कुंजी किसका डेटा देखती है?+

केवल उस कंपनी से जिसने चाबी बनाई है। अन्य कंपनियों का डेटा कभी सामने नहीं आता.

आज ही अपना खाता बनाएं और अपनी पहली कुंजी बनाएं।

के लिए पहला महीना US$ 10,00, पूर्ण पहुंच के साथ। फिर, आप योजना चुनें.

के लिए प्रारंभ करें US$ 10,00

किसी व्यक्ति से बात करना पसंद करते हैं? टीम से बात करें

रद्द करने पर कोई जुर्माना नहीं है · गारंटी 30 dias

उदाहरणात्मक उदाहरण