بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
أطلقت Zapier نسخة تجريبية مفتوحة من Zapier SDK، وهي واجهة برمجية تمنح وكلاء الكود والمطورين وصولاً مباشراً إلى منظومة تطبيقات Zapier الكاملة — أي استدعاء API لأي تطبيق، نيابةً عن المستخدم، دون الحاجة إلى إعداد OAuth من الصفر. الوصول مجاني خلال مرحلة الاختبار.
الفارق الجوهري بين SDK وMCP الذي أطلقته Zapier سابقاً يكمن في العمق البرمجي: MCP يقدّم قائمة منسّقة من الإجراءات الجاهزة مناسبة لوكلاء المحادثة، بينما SDK يفتح الباب أمام كتابة حلقات تكرارية، ومعالجة استثناءات، وتسلسل منطق معقد عبر تطبيقات متعددة. معظم الفرق ستستخدم الاثنين معاً: MCP لواجهات المحادثة، والـ SDK حين يحتاج الوكيل إلى تنفيذ كود موثوق في بيئة الإنتاج.
المشكلة التي يحلّها SDK ليست تقنية بالمعنى الضيّق، بل تشغيلية: كل مطوّر يبني وكلاء اليوم إما يحل مشكلة المصادقة بنفسه — OAuth لكل تطبيق، تجديد الـ tokens، إعادة المحاولة عند الفشل — أو يتجاهلها كلياً وهو ما يعني أتمتة بلا رقابة ولا تدقيق. SDK يستبدل كل ذلك بتكامل واحد مبني على البنية التحتية ذاتها التي تشغّل كتالوج Zapier الكامل. (وفقاً لـ Zapier Docs)
ما المتاح الآن في النسخة التجريبية يمكن تلخيصه في أربعة محاور رئيسية:
- كتالوج الإجراءات الكامل: استدعاء أي إجراء جاهز من كتالوج Zapier عبر واجهة برمجية موحّدة، مع دعم TypeScript الكامل وأنواع مُولَّدة لكل تطبيق وإجراء.
- استدعاءات API المباشرة: HTTP calls موثّقة عبر بنية Zapier التحتية لـ 3,600 تطبيق (وفقاً لـ Zapier Docs)، تتجاوز الإجراءات الجاهزة وتصل إلى أي endpoint مدعوم مباشرةً عبر دالة
.fetch(). - حوكمة التطبيقات والإجراءات: إن كانت مؤسستك قد قيّدت تطبيقات أو إجراءات معينة داخل Zapier، تنطبق هذه السياسات تلقائياً على حركة SDK التي تستخدم الإجراءات الجاهزة. تنبّه مهم: استدعاءات
.fetch()المباشرة لا تخضع لهذه السياسات بعد — هذا على خارطة الطريق. - Triggers تجريبية: الاشتراك في أحداث فورية من التطبيقات المتصلة برمجياً، مع إدارة Zapier لحالة الاشتراك وموثوقية الـ webhooks.
لفهم القيمة العملية، خذ هذا المثال الحرفي من التوثيق: مستخدم يقول “أجّل اجتماعي الساعة 2م إلى الخميس وأخبر الحضور”. الوكيل يبحث عن الاجتماع في Google Calendar، يُعيد جدولته، ثم يرسل رسالة لكل مشارك على Slack — كل ذلك عبر SDK بكود TypeScript نظيف من ثلاثة أسطر لكل عملية. ما كان سيستغرق إعداد OAuth لتطبيقين منفصلين وإدارة token refresh يصبح مجرد zapier.findFirstConnection({ appKey: "google-calendar" }) ثم استدعاء مباشر.
للبدء، يدعم SDK أربع بيئات مباشرةً: Codex وClaude Code وCursor وVS Code Copilot — يشغّل الوكيل أوامر الإعداد نيابةً عنك. كما يمكن استخدامه من ChatGPT وClaude وPerplexity بتوجيه نصي. للإعداد اليدوي، الخطوات التسع تشمل: اكتشاف مدير الحزم، التحقق من Node.js بإصدار 20 أو أعلى، تثبيت @zapier/zapier-sdk، تثبيت أدوات التطوير، المصادقة عبر المتصفح أو بيئة headless، ثم استعراض التطبيقات المتصلة. الـ CLI يتيح لك استكشاف التطبيقات والإجراءات أولاً قبل كتابة سطر كود واحد.
ثلاثة قيود لا يجب تجاهلها: أولاً، حسابات Enterprise معطّلة افتراضياً وتحتاج تفعيلاً يدوياً عبر التواصل مع Zapier. ثانياً، تغطية API المباشرة عبر .fetch() ليست شاملة لكل التطبيقات بعد. ثالثاً، حوكمة API المباشرة غائبة حتى الآن — إن كانت الرقابة المؤسسية ضرورة لديك، اقتصر على الإجراءات الجاهزة في الوقت الراهن. يمكنك إرسال ملاحظاتك مباشرةً لفريق Zapier خلال مرحلة الاختبار.
