واجهة برمجة التطبيقات وMCP

ابدأ

قم بإنشاء مفتاح في تطبيق الويب › الإعدادات › API. يظهر المفتاح على شكل zk_ متبوعًا بـ 32 حرفًا ويُعرض مرة واحدة فقط. أرسله في ترويسة Authorization:

curl https://zicelo.com.vtmx.ro/api/v1/me \
  -H "Authorization: Bearer zk_..."

العنوان الأساسي: https://zicelo.com.vtmx.ro/api/v1. جميع الردود بصيغة JSON، مع {"ok": true, ...} أو {"ok": false, "error": {"cod", "mesaj"}}. البيانات بتشفير UTF-8، والأوقات بتوقيت رومانيا.

الحدود

الباقة	الطلبات يوميًا
مجاني	500
Pro	5.000
Business	20.000
Enterprise	50.000

اجتماعات

GET/me

حسابك، باقتك والاستهلاك الشهري الحالي.

GET/sedinte

قائمة الاجتماعات، الأحدث أولاً. المعاملات: pagina، pe_pagina (حتى 100 كحد أقصى)، q (في العنوان)، de_la، pana_la (YYYY-MM-DD).

GET/sedinte/{id}

اجتماع كامل: الملاحظات (ملخص، نقاط، قرارات، مهام، أسئلة)، تحليل المحادثة، نص التفريغ مع المتكلم والزمن، المهام.

POST/sedinte

أضف اجتماعًا من نظامك الخاص (مثل تفريغ مكالمة). ترسل إما linii أو text. إذا لم تكن notite موجودة، يقوم Zicelo بعمل الملخص.

{
  "عنوان": "مكالمة العميل بوبسكو",
  "بداية": "2026-11-03 10:00:00",
  "لغة": "ro",
  "المشاركون": ["ana@firma.ro"],
  "الأسطر": [
    {"t0": 0, "t1": 6.5, "المتحدث": "أنا", "النص": "مرحباً، أتصل بك بشأن العرض."}
  ]
}

DELETE/sedinte/{id}

احذف الاجتماع (بما في ذلك التفريغ الصوتي وملف الصوت).

مهام

GET/sarcini

مهامك. الفلاتر: gata=0|1، sedinta=ID.

POST/sarcini

أضف مهمة.

{ "نص": "أرسل العرض المعدل"، "من": "Mihai"، "موعد": "2026-11-07"، "اجتماع": 123 }

PATCH/sarcini/{id}

عدل مهمة: gata، text، cine، termen.

{ "gata": true }

بحث

GET/cautare?q=reducere

ابحث في تفريغ جميع اجتماعاتك وأعد العبارة المكتشفة، الاجتماع والوقت (بالثواني).

Webhook

Zicelo يرسل POST JSON إلى عنوانك في كل مرة تصبح ملاحظات الاجتماع جاهزة. يمكنك ضبطها من التطبيق (التكاملات › webhook) أو عبر API - مفيد لـ Zapier، Make أو n8n.

GET/webhooks

Webhooks الخاصة بك.

POST/webhooks

اشترك بعنوان https. ce: ماذا يجب أن يحتوي - rezumat، sarcini، transcript.

{ "url": "https://hooks.zapier.com/...", "secret": "un-secret", "ce": ["rezumat", "sarcini"] }

DELETE/webhooks/{id}

إلغاء الاشتراك.

رؤوس مرسلة: X-Zicelo-Event (sedinta.gata، sarcina، test) وإذا قمت بتعيين سر، X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. المحتوى:

{
  "eveniment": "sedinta.gata",
  "trimis": "2026-11-03T10:42:00+02:00",
  "sedinta": {
    "id": 123, "titlu": "...", "inceput": "...", "durata": 1840,
    "participanti": ["..."],
    "notite": { "rezumat": "...", "puncte": [...], "decizii": [...], "actiuni": [...], "intrebari": [...] },
    "sarcini": [{ "id": 1, "text": "...", "cine": "...", "termen": "..." }],
    "url": "https://zicelo.ro/app/#/sedinta/123"
  }
}

التحقق من التوقيع، في PHP:

$ok = hash_equals('sha256=' . hash_hmac('sha256', file_get_contents('php://input'), $secret),
                  $_SERVER['HTTP_X_ZICELO_SIGNATURE'] ?? '');

أخطاء

HTTP	الرمز	ما يعنيه
400	`json`, `text`, `url`	بيانات مفقودة أو خاطئة
401	`cheie`	مفتاح مفقود أو خاطئ أو ملغي
403	`pachet`, `plafon`	الميزة غير موجودة في الباقة أو وصلت للحد
404	`negasit`, `ruta`	غير موجود
429	`plafon`	تجاوزت عدد الطلبات اليومية
500 / 503	`server`, `baza`	مشكلة لدينا - حاول مجددًا

MCP: اجتماعاتك في Claude وChatGPT

يحتوي Zicelo على خادم MCP (بروتوكول سياق النموذج). يبحث مساعدك الذكي في الاجتماعات، يقرأ التفريغ النصي والملاحظات، يرى المهام ويطرح أسئلة مع موافقتك.

في Claude: الإعدادات › الموصلات › أضف موصل مخصص. في ChatGPT: الإعدادات › الموصلات (وضع المطور) › أنشئ.
عنوان السيرفر: https://zicelo.com.vtmx.ro/mcp
تتصل بحساب Zicelo وتوافق على الوصول. يمكنك سحب الوصول في أي وقت من تطبيق الويب.

الأدوات المتاحة (للقراءة فقط): cauta_sedinte، sedinta، transcriere، sarcini، intreaba (تستهلك رصيد AI)، dictionar.

SCIM 2.0 (للمؤسسات)

Okta، Microsoft Entra ID أو Google Workspace يمكنهم إنشاء وتعطيل حسابات الفريق تلقائياً. يقوم المسؤول بإنشاء رمز SCIM في التطبيق (الفريق › الأمان). العنوان: https://zicelo.com.vtmx.ro/scim/v2، التوثيق Bearer. الموارد: /Users (GET, POST, PUT, PATCH, DELETE، فلتر userName eq)، /ServiceProviderConfig، /ResourceTypes، /Schemas. تعطيل شخص يخرجه من الفريق ويغلق جلساته.

واجهة برمجة التطبيقات، webhook وMCP