للمطورين

Cyzyra داخل أنظمتك. وأنظمتك داخل Cyzyra.

REST API وخطافات الويب الموقعة والاتصال بمساعدي الذكاء الاصطناعي. لنقل بيانات الشركة إلى ERP أو BI أو التطبيق الخاص بك.

حليقة https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "التفويض: الحامل cy_live_..."

{ "بيانات": [{ "المعرف": "..."، "الاسم": "..."، "الحالة": "جديد" }]، "المؤشر_التالي": خالي }

مثال توضيحي للنداء والاستجابة.

01/ ثلاث طرق للتكامل

اقرأ واستقبل واسأل.

استخدم واحدًا أو اثنين أو الثلاثة. إنهم جميعًا يحترمون أذونات المفتاح وبيانات الشركة التي تمتلكه.

واجهة برمجة تطبيقات REST
العملاء المتوقعون والمفاوضات والمدفوعات والأشياء والمقاييس بتنسيق JSON، مع وثائق OpenAPI.
خطافات الويب
18 يتم إرسال أحداث الشركة إلى نظامك بشكل فوري، مع الاشتراك.
مساعدو الذكاء الاصطناعي (MCP)
قم بتوصيل Cyzyra بمساعدي الذكاء الاصطناعي المتوافقين مع MCP واسأل عن المبيعات والإعلانات والأرباح.

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 مرات.

توقيع 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 من داخل مساعدك.

أضف عنوان MCP الخاص بـ Cyzyra كموصل مخصص في مساعد AI متوافق، باستخدام مفتاح API الخاص بك. ويبدأ في استشارة الأرباح والحملات والمبيعات، ويجيب على الأسئلة باللغة البرتغالية حول بياناته.

عنوان URL: https://SEU-PAINEL/api/mcp الرأس: التفويض: Bearer cy_live_... الأدوات: Summary_profit · الحملات · طلب المبيعات · إدارة_الحملات (كتابة)

05/ أسئلة

الأسئلة الفنية

عرض عمليات التكامل الجاهزة

أين أقوم بإنشاء مفتاح API؟+

في لوحة معلومات API Platform (القائمة System → API Platform → API Keys). يظهر المفتاح مرة واحدة فقط؛ تحتفظ Cyzyra بنسخة مشفرة منها فقط.

ما الأذونات التي يمكن أن يمتلكها المفتاح؟+

القراءة، أو القراءة والكتابة. تتطلب إجراءات مثل إنشاء عملاء محتملين أو تغيير الحملات عبر اتصال MCP إذنًا بالكتابة.

هل هناك حد للاستخدام؟+

نعم: 120 طلبًا في الدقيقة لكل مفتاح. وفوق ذلك، تستجيب واجهة برمجة التطبيقات (API) للرقم 429 وتخبرك بعدد الثواني التي يجب أن تحاول فيها مرة أخرى.

ماذا لو كان نظامي معطلاً عند انقطاع الاتصال عبر الويب؟+

تقوم Cyzyra بإعادة المحاولة حتى 5 مرات، مع فترات زمنية متزايدة، وتعرض كل محاولة على لوحة المعلومات.

بيانات من يرى كل مفتاح؟+

فقط من الشركة التي أنشأت المفتاح. لا تظهر البيانات من الشركات الأخرى أبدًا.

أنشئ حسابك وأنشئ مفتاحك الأول اليوم.

الشهر الأول ل US$ 10,00, ، مع الوصول الكامل. وبعد ذلك، اخترت الخطة.

ابدأ ل US$ 10,00

تفضل التحدث مع شخص؟ التحدث مع الفريق

لا توجد عقوبة للإلغاء · الضمان 30 dias

مثال توضيحي