API, webhook এবং MCP

শুরু করো

ওয়েব অ্যাপে একটি কী তৈরি করো › সেটিংস › API. কী দেখতে হবে zk_ এর পর ৩২টি অক্ষর, এবং এটা একবারই দেখা যায়। এটি পাঠাও হেডার Authorization এ:

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

বেস URL: https://www.zicelo.com.vtmx.ro/api/v1। সব রেসপন্স JSON, {"ok": true, ...} বা {"ok": false, "error": {"cod", "mesaj"}} নিয়ে। ডেটা UTF-8 এ, সময় রোমানিয়ার সময়ানুসারে।

সীমাবদ্ধতা

সভার নোট

{
  "titlu": "ক্লায়েন্ট Popescu এর কল",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "আনা", "text": "হ্যালো, আমি অফারের জন্য ফোন করছিলাম।"}
  ]
} 

টাস্ক

{ "text": "সংশোধিত অফার পাঠাও", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 } 

{ "gata": true }

অনুসন্ধান

Webhook

Zicelo POST JSON তোমার ঠিকানায় পাঠায় যখনই একটি মিটিংয়ের নোট প্রস্তুত হয়। তুমি অ্যাপ থেকে এগুলো কনফিগার করো (Integrări › Webhook) বা API দিয়ে — Zapier, Make বা n8n-এ ব্যবহার করার জন্য সুবিধাজনক।

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

পাঠানো হেডারসমূহ: 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'] ?? '');

ত্রুটি

MCP: তোমার মিটিং Claude এবং ChatGPT তে

Zicelo এর একটি MCP (Model Context Protocol) সার্ভার আছে। তোমার AI সহকারী তোমার মিটিং খুঁজে, ট্রান্সক্রিপশন এবং নোট পড়ে, কাজ দেখে এবং প্রশ্ন করে, তোমার অনুমতিতে।

1. Claude-এ: সেটিংস › কানেক্টর › কাস্টম কানেক্টর যোগ করো। ChatGPT-তে: সেটিংস › কানেক্টর (ডেভেলপার মোড) › তৈরি করো।
2. সার্ভারের ঠিকানা: https://www.zicelo.com.vtmx.ro/mcp
3. Zicelo অ্যাকাউন্ট দিয়ে লগইন করো এবং অ্যাক্সেস অনুমোদন করো। তুমি যেকোনো সময় ওয়েব অ্যাপ থেকে প্রত্যাহার করতে পারবে।

উপলব্ধ টুলস (শুধু পড়ার জন্য): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (AI ক্রেডিট ব্যবহার করে), dictionar।

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID বা Google Workspace স্বয়ংক্রিয়ভাবে দলের অ্যাকাউন্ট তৈরি এবং নিষ্ক্রিয় করতে পারে। অ্যাডমিন অ্যাপে SCIM টোকেন তৈরী করে (Echipă › Securitate)। ঠিকানা: https://www.zicelo.com.vtmx.ro/scim/v2, প্রমাণীকরণ Bearer। রিসোর্স: /Users (GET, POST, PUT, PATCH, DELETE, ফিল্টার userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas। একজনকে নিষ্ক্রিয় করলে সে দল থেকে বাদ পড়ে এবং তার সেশন বন্ধ হয়ে যায়।