هل لدى ClickUp واجهة برمجية (API)؟ الرموز وإشعارات webhook وحدود الطلبات لفرق تقنية المعلومات في الخليج

إجابة سريعة

نعم. لدى ClickUp واجهة برمجية عامة (API) تقول الشركة إنها متاحة في جميع الباقات. تصادقون برمز شخصي أو عبر تطبيق OAuth، فتقرؤون المهام والقوائم والتعليقات والحقول المخصّصة وسجلات الوقت وتكتبونها، وتصلكم إشعارات webhook موقّعة عند تغيّر العمل. أما حدود الطلبات وبعض واجهات الإدارة فتختلف حسب الباقة.

أرسل إلينا مدير تقنية المعلومات في مجموعة عائلية نعمل معها في الدوحة استبيان المورّدين في الربيع الماضي. في السطر الرابع عشر سؤال واحد: «هل توجد واجهة برمجية (API)؟ نعم/لا». كتبنا: نعم. ثم اتصلنا به، فـ«نعم» أقلّ الإجابات نفعًا عن هذا السؤال. ما أراد أن يعرفه حقًّا: هل تتحوّل طلبات الشراء المعتمدة في نظام تخطيط الموارد إلى مهام دون أن يعيد أحد كتابتها؟ ومَن يملك هذا الربط إذا انقطع ليلة الخميس؟

لذلك نجيب هنا عن السؤال كما سيطرحه فريق تقنية المعلومات لديكم. إلى ماذا تصل الواجهة البرمجية؟ وبصلاحيات مَن يعمل التكامل؟ وماذا يحدث إذا أرسلتم طلبات أكثر من المسموح، وماذا يرسل ClickUp حين يتغيّر العمل؟ كل ما هنا مأخوذ من وثائق المطوّرين لدى ClickUp كما هي اليوم. وحيث تضع الوثائق رقمًا لحدٍّ ما تركنا الرقم عمدًا، فالحدود تتغيّر والباقات تختلف.

الإجابة المختصرة

نعم. لدى ClickUp واجهة برمجية عامة، وتقول الشركة إنها متاحة في جميع الباقات. تتبادل البيانات بصيغة JSON عبر HTTPS، وكل طلب يحمل رمزًا في ترويسة Authorization؛ والرمز إمّا شخصي وإمّا صادر عبر تطبيق OAuth. به تنشئون المهام وتحدّثونها، وتنقلونها بين القوائم، وتملؤون الحقول المخصّصة، وتضيفون التعليقات، وتسجّلون الوقت، ثم تقرؤون ذلك كله.

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

أربعة طرق للربط، وأيّها تحتاجون

قبل أن يكتب أحد سطرًا برمجيًا، اسألوا: هل نحتاج إلى برمجة أصلًا؟ إلى ClickUp أربعة أبواب، والواجهة البرمجية واحد منها فقط.

التكاملات الجاهزة وأدوات الربط بلا برمجة مثل Make تغطّي الحالات الشائعة، ومركز مساعدة ClickUp نفسه يشير إليها لمن لا يريد أن يكتب شيفرة. أما إشعارات webhook من الأتمتة فتجعل قاعدة أتمتة في ClickUp تنادي عنوانًا خارجيًا متى تحقّقت المحفّزات والشروط التي تضعونها، فيبقى المنطق حيث يراه مسؤولو النظام. والواجهة البرمجية العامة، ومعها إشعاراتها الخاصة، للحالات التي تحتاج إلى تحكّم كامل. وأخيرًا تشغّل ClickUp اليوم خادم MCP يتيح للمساعدات الذكية العمل على بيانات مساحة العمل؛ والدخول إليه عبر OAuth فقط، ولا يتضمّن حتى الآن أدوات حذف.

قاعدتنا: ادخلوا من أول باب يؤدّي الغرض. فالبرمجة الخاصة أكثر الخيارات مرونة. وهي كذلك الخيار الذي يجب أن يصونه أحدٌ سنوات.

ما الذي تغطّيه الواجهة، وأين يتعثّر الناس

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

وهذه تفاصيل يوفّر كلٌّ منها على مطوّريكم يومًا:

• في الإصدار الثاني كلمة team تعني مساحة العمل، وteam_id هو معرّف مساحة العمل. الجميع يتعثّر بهذا مرة.
• قوائم المهام تعود صفحةً صفحة، مئة مهمة في الصفحة. فتصدير ليلي لأربعين ألف مهمة يعني مئات الطلبات، فاحسبوا حسابه.
• الحقول المخصّصة تُملأ بمعرّف الحقل لا باسمه. غيّروا اسم الحقل في التطبيق فلا ينكسر شيء؛ احذفوه وأعيدوا إنشاءه فينكسر كل شيء.

الرموز: بصلاحيات مَن يعمل تكاملكم؟

هذا القسم نرجو أن تقرؤوه مرتين. الرمز الشخصي يبدأ بـ pk_، ويستطيع أي صاحب حساب أن يولّده، وتقول وثائق ClickUp إنه لا تنتهي صلاحيته. يحمل صلاحيات صاحبه كما هي في المتصفح، وفي كل مساحة عمل ينتمي إليها. وتصفه ClickUp بأنه للاستخدام الشخصي والاختبار.

أما تطبيق OAuth فهو الطريق لكل ما يعتمد عليه الآخرون. يسجّل التطبيقَ مالكُ مساحة العمل أو أحد مسؤوليها، ثم يدخل كل مستخدم ويختار مساحات العمل التي يأذن بها، فيحصل على رمز خاص به لا يتجاوز ما يراه هو. وتقول الوثائق إن هذه الرموز أيضًا لا تنتهي صلاحيتها حاليًا، وإن ذلك قد يتغيّر.

في مجموعة مقاولات في أبوظبي، ظلّ الربط بين نظام تخطيط الموارد وClickUp يعمل ثمانية أشهر برمز شخصي لمهندس مشاريع. ثم استقال. أغلقت الموارد البشرية حسابه في يومه الأخير، وهذا الصواب. وصباح الاثنين توقفت طلبات الشراء المعتمدة عن الوصول مهامَّ. لا تنبيه لأحد. ومضت ثلاثة أيام قبل أن ينتبه فريق المشتريات إلى أن القائمة صامتة.

فهذا ما ننصح به: اجعلوا لكل تكامل مستخدمًا خاصًّا به في ClickUp، له مالك بشري مُسمّى، ولا يصل إلا إلى المساحات التي يحتاجها، واحفظوا رمزه في خزنة الأسرار لديكم. نعم، هذا مقعد إضافي. لكنه أرخص من البديل. ولأن الرموز لا تنتهي من تلقاء نفسها، ضعوا تدويرها في تقويمكم؛ فلن يفعلها أحد غيركم.

حدود الطلبات: خطّطوا للسقف

تحدّ ClickUp عدد الطلبات لكل رمز في الدقيقة، والسقف يتبع باقة مساحة العمل التي تستضيف الرمز. والفارق بين أدنى الباقات وأعلاها واسع، فلا تبنوا تقديركم على مقال، ومقالنا منها. خذوا الرقم الحالي لباقتكم من وثائق المطوّرين لدى ClickUp.

وإذا تجاوزتم الحدّ ردّت الواجهة بالرمز 429، وفي ترويسات الردّ حدّكم وما بقي منه وموعد تجدّد النافذة. التكامل المتقن يقرأ هذه الترويسات وينتظر. والرديء يعيد المحاولة فورًا فيزيد الأمر سوءًا.

إشعارات webhook: دعوا ClickUp يتصل بكم

الاستطلاع الدوري يسأل ClickUp كل بضع دقائق: هل تغيّر شيء؟ إشعار webhook يقلب الاتجاه: تسجّلون عنوانًا، وتختارون الأحداث والموقع، فيرسل ClickUp طلب POST حين تُنشأ مهمة أو تتغيّر حالتها أو مسؤولها أو تاريخ استحقاقها أو يُضاف إليها تعليق. وللقوائم والمجلدات والمساحات والأهداف أحداثها كذلك.

أربع حقائق من الوثائق سيسأل عنها فريقا الأمن والبنية التحتية لديكم:

• لا عناوين IP ثابتة. تقول ClickUp إن إشعاراتها لا تصدر من عناوين مخصّصة، فقائمة السماح بالعناوين لن تنفع. تحقّقوا من التوقيع بدلًا منها: كل طلب يحمل ترويسة X-Signature، وهي توقيع HMAC لجسم الطلب بسرّ خاص بذلك الإشعار.
• ردّوا بسرعة. التسليم الذي يتأخر أكثر من ثوانٍ قليلة أو يعود بخطأ يُعدّ فاشلًا. أقرّوا بالاستلام فورًا، وضعوا الحدث في طابور، وافحصوا التكرار قبل معالجته.
• الفشل صامت. تعيد ClickUp إرسال الحدث مرات قليلة ثم تتركه، وبعد فشل متكرر يُعلَّق الإشعار، ولا يصلكم تنبيه. افحصوا صحة الإشعارات بجدول منتظم.
• الإشعار ملك للمستخدم الذي أُنشئ برمزه. إن عُطّل ذلك المستخدم بقي الإشعار في مكانه وتوقف عن العمل. إنها قصة أبوظبي نفسها.

ما الذي تربطه فرق الخليج فعلًا

في مشاريعنا تتكرّر أربعة روابط.

• نظام تخطيط الموارد أو النظام المالي. طلب شراء معتمد أو رمز مشروع جديد ينشئ مهمة أو قائمة من قالب، والوقت المسجّل يعود لاحتساب التكلفة. ويبقى نظام تخطيط الموارد المرجع في كل ما يخص المال.
• Salesforce. الصفقة المغلقة تفتح مشروع التنفيذ واسم الحساب وقيمة العقد في حقولهما المخصّصة سلفًا. مقالنا عن أنماط تكامل Salesforce ومقارنتنا للأدوات يبيّنان متى يكفي موصّل جاهز ومتى تلزم الواجهة البرمجية.
• مزوّد واتساب للأعمال. رسائل العملاء الواردة تصل إلى ClickUp عبر webhook المزوّد من جهة والواجهة البرمجية لـ ClickUp من الجهة الأخرى. ومقالنا عن واتساب يشرح الخيارات.
• ذكاء الأعمال والتقارير. يسحب Power BI أو مستودع البيانات المهام وسجلات الوقت كل ليلة للتقارير التي يقرؤها مجلس الإدارة أصلًا. وهنا تظهر أهمية حدود الطلبات وتقسيم الصفحات.

خطة من أربعة أسابيع لأول تكامل

لا تحتاجون إلى ربع سنة لهذا. تكامل واحد، وقائمة واحدة، وأربعة أسابيع.

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

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

ثلاثة أخطاء نراها

وقلّما تكون في الشيفرة.

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

كيف يساعدكم BuyClickUp

BuyClickUp شريك ClickUp مستقل تديره Inspark، وهي شركة استشارات متخصصة في Salesforce وClickUp تخدم الإمارات وقطر والكويت من دبي. نصمّم تكاملات ClickUp مع Salesforce وأنظمة تخطيط الموارد والمالية ومزوّدي المراسلة ونبنيها، ونبدأ دائمًا بالسؤال: هل تحتاجون إلى برمجة خاصة أصلًا؟ ونجيب مع فريق تقنية المعلومات لديكم عن استبيان الأمن، بالعربية والإنجليزية. إن كان عندكم نظام ينبغي أن يتحدث إلى ClickUp ولا يفعل، تواصلوا معنا أو خذوا تقييم الجاهزية المجاني.

ClickUp علامة تجارية مسجّلة لشركة Mango Technologies, Inc. وBuyClickUp ليس ClickUp. وSalesforce وWhatsApp وPower BI وMake علامات تجارية لأصحابها. يعكس هذا المقال قراءتنا لوثائق المطوّرين ووثائق المساعدة لدى ClickUp في نوفمبر 2026. وتختلف إتاحة الواجهة البرمجية وواجهاتها وحدود الطلبات وسلوك الرموز وإشعارات webhook وخادم MCP حسب الباقة وتتغيّر مع الوقت؛ فتأكدوا من التفاصيل الحالية لدى ClickUp قبل أن تبنوا عليها.