للمطوّرين ومساعدي الذكاء الاصطناعي

REST API، وWebhooks موقّعة، وخادم MCP.

أضف العملاء المحتملين من نماذجك ومنتجك، وضعهم في التسلسلات، واقرأ المحادثات، واعرف فورًا عندما يرد أحدهم أو يحجز موعدًا. أما الموافقة والإرسال فيبقيان بيد شخص داخل التطبيق.

مفاتيح لكل مساحة عمل، للقراءة فقط أو للقراءة والتعديل، تظهر مرة واحدة
120 طلب في الدقيقة لكل مفتاح
ملف OpenAPI لكل نقطة نهاية وكل حقل

إضافة عميل محتمل

curl -X POST https://auth.zorosdr.com/functions/v1/api/v1/leads \
  -H "Authorization: Bearer zk_live_…" \
  -H "content-type: application/json" \
  -d '{"email": "sara@pearldental.ae",
       "first_name": "Sara",
       "company": "Pearl Dental"}'

REST API

كل نقاط النهاية.

العنوان الأساسي https://auth.zorosdr.com/functions/v1/api/v1. أرسل مفتاحك كرمز Bearer. وتُسمّى التسلسلات campaigns في الـ API.

الطريقة	المسار	ما تقوم به	صلاحية المفتاح
GET	/v1/me	مساحة العمل والمفتاحمساحة العمل التي ينتمي إليها هذا المفتاح، ومنطقتها الزمنية، واسم المفتاح وصلاحياته.	قراءة
GET	/v1/stages	مراحل مسار المبيعاتمراحل مساحة العمل بالترتيب. استخدم مفتاح المرحلة لتصفية العملاء المحتملين أو نقلهم.	قراءة
GET	/v1/leads	عرض العملاء المحتملينالأحدث أولًا. صفِّ حسب البريد الإلكتروني أو المرحلة أو كلمة بحث أو وقت، وتنقّل بين الصفحات باستخدام cursor.	قراءة
POST	/v1/leads	إضافة عميل محتمليتطلب بريدًا إلكترونيًا أو رقم هاتف أو رابط LinkedIn. الشخص الموجود مسبقًا في مساحة العمل (بالبريد نفسه أو حساب LinkedIn نفسه) لا يُضاف مرتين: يُعاد عميله المحتمل مع created: false. ولا يمكن إضافة الأشخاص الذين طلبوا حذف بياناتهم. ويمكن اختياريًا إضافة العميل المحتمل إلى تسلسل.	قراءة وتعديل
GET	/v1/leads/{id}	عرض عميل محتملعميل محتمل واحد مع مرحلته ووسومه وحقوله المخصصة وتسلسلاته.	قراءة
PATCH	/v1/leads/{id}	تحديث عميل محتملغيّر الحقول، أو الوسوم (add_tags وremove_tags)، أو الحقول المخصصة، أو المرحلة. ونقله إلى مرحلة تُنهي التسلسل (Meeting وCustomer وLost…) يوقفه، كما في التطبيق.	قراءة وتعديل
POST	/v1/leads/{id}/opt-out	إلغاء اشتراك عميل محتملطلب العميل المحتمل عدم التواصل معه: تتوقف كل التسلسلات له ولا يُرسل إليه شيء بعد ذلك. ولا يستطيع التراجع عن ذلك إلا شخص، داخل التطبيق.	قراءة وتعديل
GET	/v1/leads/{id}/messages	محادثة عميل محتملالرسائل المرسلة والمستلمة على كل القنوات، الأقدم أولًا (حتى 200 رسالة).	قراءة
GET	/v1/campaigns	عرض التسلسلاتكل التسلسلات مع نوعها وحالتها.	قراءة
GET	/v1/campaigns/{id}	عرض تسلسلتسلسل مع خطواته وعدد العملاء المحتملين فيه حسب الحالة.	قراءة
POST	/v1/campaigns/{id}/leads	إضافة عملاء محتملين إلى تسلسلحتى 500 معرّف لعملاء محتملين. يُتخطّى العملاء المحتملون الموجودون فيه مسبقًا ومن ألغوا اشتراكهم. تتوزع الرسائل الأولى على مدى ساعة، وتنتظر كل رسالة الموافقة في التطبيق ما لم يكن التسلسل يرسل تلقائيًا.	قراءة وتعديل
GET	/v1/drafts	مسودات تنتظر الموافقةرسائل صاغها الذكاء الاصطناعي وتنتظر شخصًا. للقراءة فقط: وافق عليها أو تخطَّها في التطبيق.	قراءة

المواصفات الكاملة متاحة في openapi.json.

Webhooks

اعرف فورًا عندما يحدث شيء.

أضف عنوان https من الإعدادات، المطوّرون، واختر الأحداث، وانسخ مفتاح التوقيع السري. كل حدث موقّع، وتُعاد محاولة إرساله إذا كان نظامك متوقفًا.

موقّع بالترويسة Zoro-Signature: t=<unix seconds>,v1=<HMAC-SHA256 of "<t>.<raw body>">
إعادة المحاولة بعد 1 و5 و30 دقيقة، ثم بعد 2 و6 و24 ساعة
العنوان الذي يفشل 25 مرة متتالية يُوقف مؤقتًا ويُبلَّغ المالكون
زر «إرسال اختبار» يرسل ping فورًا

lead.createdإضافة عميل محتمل
lead.stage_changedتغيّر مرحلة عميل محتمل
lead.opted_outإلغاء اشتراك عميل محتمل
message.receivedوصول رد
message.sentإرسال رسالة
draft.createdمسودة تنتظر الموافقة
meeting.bookedحجز اجتماع
meeting.cancelledإلغاء اجتماع

خادم MCP

دع مساعد الذكاء الاصطناعي يعمل على عملائك المحتملين.

يستطيع Claude وCursor وغيرهما من المساعدين الذين يدعمون MCP البحث عن العملاء المحتملين وإضافتهم وتحديثهم ووضعهم في التسلسلات بمفتاحك. ويمكنهم قراءة المسودات، لكن لا يمكنهم أبدًا الموافقة عليها أو إرسالها.

Claude Code

claude mcp add --transport http zorosdr https://auth.zorosdr.com/functions/v1/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor والتطبيقات الأخرى

{
  "mcpServers": {
    "zorosdr": {
      "url": "https://auth.zorosdr.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

workspace_infoقراءة
مساحة عمل ZOROSDR التي ينتمي إليها هذا المفتاح: الاسم والمنطقة الزمنية وما يُسمح للمفتاح بفعله.
list_stagesقراءة
مراحل مسار المبيعات بالترتيب، مع مفاتيحها.
search_leadsقراءة
ابحث عن العملاء المحتملين بكلمة (الاسم أو الشركة أو البريد)، أو ببريد إلكتروني محدد، أو بمفتاح مرحلة. الأحدث أولًا؛ مرّر قيمة cursor المُعادة للمزيد.
get_leadقراءة
عميل محتمل واحد مع مرحلته ووسومه وحقوله المخصصة ودرجة اهتمامه وتسلسلاته.
get_conversationقراءة
رسائل عميل محتمل على كل القنوات، الأقدم أولًا.
create_leadتعديل
أضف عميلًا محتملًا (يتطلب بريدًا إلكترونيًا أو هاتفًا أو رابط LinkedIn). الشخص الموجود مسبقًا في مساحة العمل لا يُضاف مرتين. ويمكن اختياريًا إضافته إلى تسلسل، وتبقى الرسائل بانتظار الموافقة في التطبيق.
update_leadتعديل
غيّر حقول عميل محتمل أو وسومه أو مرحلته. ومرحلة مثل MEETING أو LOST توقف تسلسلاته، كما في التطبيق.
opt_out_leadتعديل
سجّل أن عميلًا محتملًا طلب عدم التواصل معه: تتوقف كل التسلسلات له. ولا يستطيع التراجع عن ذلك إلا شخص.
list_campaignsقراءة
كل التسلسلات مع نوعها وحالتها.
get_campaignقراءة
خطوات تسلسل وعدد العملاء المحتملين فيه حسب الحالة.
add_leads_to_campaignتعديل
أضف عملاء محتملين إلى تسلسل (حتى 500). يُتخطّى من ألغوا اشتراكهم ومن هم فيه مسبقًا. وتنتظر كل رسالة الموافقة في التطبيق ما لم يكن التسلسل يرسل تلقائيًا.
list_draftsقراءة
مسودات تنتظر موافقة شخص. للقراءة فقط: تتم الموافقة عليها أو تخطيها في التطبيق.

ابنِ على ZOROSDR.

أنشئ مفتاحًا من الإعدادات، المطوّرون، في أي خطة. وابدأ مجانًا لمدة 14 يومًا.

ابدأ مجانًا لمدة 14 يومًا احجز عرضًا توضيحيًا

لا حاجة لبطاقة دفع خلال التجربة.