اربط Zapier وMake وn8n وPipedream

احجز الأعمال وتفاعل مع الأحداث من أدوات الأتمتة التي يستخدمها فريقك بالفعل — دون كتابة كود، أو بقليل منه.

تطبيقات Crisphive الرسمية لـ Zapier وMake وn8n وPipedream قيد الإعداد. تستخدم جميعها الواجهة العامة نفسها الموصوفة هنا، لذا يمكنك اليوم فعل كل ما تفعله باستخدام خطوات HTTP وwebhook العامة في كل منصّة.

ما تفعله التطبيقات

احجز وأكّد في استدعاء واحد

لا تستطيع الأتمتة عادةً تنفيذ التدفق الكامل: إنشاء ← جدولة ← اختيار موعد ← تأكيد. ينفّذ book-and-confirm كل ذلك في طلب واحد: ينشئ العمل، ويحدّد حجمه من المدة الافتراضية لنوع العمل (أو من job_duration_minutes التي ترسلها)، ويؤكّده عند scheduled_at، بينما يختار Crisphive الفنّي.

curl -X POST "https://api.crisphive.com/v1/job-requests/book-and-confirm" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Idempotency-Key: form-submission-4815" \
  -H "Content-Type: application/json" \
  -d '{"customer":{"full_name":"Lamar Bakery","phone":"+16135550142"},"address":{"line":"120 Bank St","city":"Ottawa","state":"ON","postal_code":"K1P 5N1","country":"CA"},"scheduled_at":"2026-10-06T10:00:00"}'

• scheduled_at هو توقيت الساعة المحلي للنشاط التجاري، دون إزاحة للمنطقة الزمنية.
• أرسل customer_id، أو كائن customer: المتصل الموجود مسبقًا (بالهاتف أو البريد الإلكتروني نفسه) يُطابَق ولا يُكرَّر أبدًا.
• job_type_id اختياري. بدونه يُستخدم نوع العمل الافتراضي للنشاط التجاري (“General”)؛ ويجب أن تكون لكل نوع عمل قد تحجزه الأتمتة مدة افتراضية.
• تُرفض المدخلات غير الصالحة باستجابة 4xx عادية ولا يُنشأ أي شيء.
• بمجرد إنشاء العمل لا يُتخلّص منه أبدًا. إن لم يتمكّن أي فنّي من تولّيه في ذلك الوقت، يظل الاستدعاء يجيب بـ 200 مع confirmed: false وrefusal (بقيمتي error_code وdata نفسيهما اللتين كانت خطوة التأكيد ستعيدهما)؛ وينتظر العمل في قائمة المنسّق.

المُشغِّلات: الاشتراك عبر webhook

المُشغِّل هو webhook تنشئه منصّة الأتمتة عند تفعيله وتحذفه عند تعطيله («REST hook»). تأتي قائمة الأحداث من GET /v1/webhooks/event-types، لذا تظهر أحداث Crisphive الجديدة دون تحديث التطبيق.

من يمكنه ربط ماذا

• يتطلب تفعيل مُشغِّل صلاحية وصول المطوّر (developer_manage_api_keys). افتراضيًا يملكها مالك النشاط التجاري وحده؛ ويمكن للمالك منح وحدة Developer لمجموعة أخرى في مصفوفة الأدوار.
• لا يمكن للمُشغِّل الاشتراك إلا في الأحداث التي يستطيع الحساب المتصل قراءتها: customer.* تتطلب customers_view، وtechnician.* تتطلب team_view، وjob_request.* تتطلب job_view. ويُرفض أي شيء آخر بـ 403 WEBHOOK_EVENT_NOT_PERMITTED.
• يتطلب الحجز job_create وjob_manage.
• يُرسَل بريد إلكتروني إلى المالك والمسؤولين في أول مرة يشترك فيها تطبيق أو مفتاح API في أحداث النشاط التجاري.
• يتوقف الاشتراك من تلقاء نفسه عند إبطال مفتاح API الذي أنشأه، أو عند فصل التطبيق، أو عند مغادرة العضو الذي ربط التطبيق أو تعليقه.

المصادقة

يتصل n8n وPipedream بمفتاح API (chsk_test_… لتجربته على بيانات sandbox، وchsk_live_… للعمل الفعلي). ويتصل Zapier وMake عبر OAuth: يسجّل الشخص الذي يربط الحساب دخوله إلى Crisphive ويوافق على التطبيق، ولا يمكن للاتصال بعد ذلك إلا فعل ما يُسمح لذلك الشخص بفعله في لوحة التحكم.