تخطّ إلى المحتوى الرئيسي
SVDY Logo
دليل المطوّر
متاح الآن

استقبل تنبيهات فريقك في Slack

تأخّر التسجيل، طلبات الإجازة، اعتماد العمليات تظهر في قناتك على Slack. يتوقّف فريقك عن التنقّل بين ثلاثة تطبيقات كل صباح. قناة واحدة، مصدر حقيقة واحد.

لماذا سيشكرك فريقك

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

بدون تذكرة لقسم تقنية المعلومات

ينقر مسؤول القناة على Connect ويختار القناة فينتهي الأمر. لا حاجة لموافقة مسؤول التينَنت ولا لدورة شراء تستغرق 30 يومًا.

رسائل مرتبة

كل تنبيه عبارة عن رسالة Slack منسّقة مع رابط مباشر يعيد المستخدم إلى الطلب — ينقر فريقك مرة واحدة لاتخاذ الإجراء.

اكتم ما لا تحتاجه

لا تهتم بإسناد الورديات؟ أوقف هذا التنبيه فقط دون أن تفقد تنبيهات تأخّر الحضور. التحكم لكل تنبيه متاح في الفئة Pro.

أسرار محمية بإحكام

تُشفَّر رموز Slack أثناء التخزين. حتى فريق دعم SVDY لا يستطيع قراءتها بعد التثبيت.

ثبّت في 30 ثانية

1

افتح /admin/integrations في تينَنت QuTime / PureOA الخاص بك.

2

اضغط على بطاقة Slack ثم Connect.

3

يفتح Slack صفحة التفويض؛ اختر القناة التي تريد استلام التنبيهات فيها.

4

يعود Slack إلى svdy؛ ستظهر شارة خضراء "Connected" وقائمة بمفاتيح تشغيل/إيقاف لكل حدث.

5

(اختياري) اضغط Send test للتحقق من التكامل برسالة فعلية.

الفئة المطلوبة: Starter أو أعلى. تحصل المؤسسات على الفئة المجانية على استجابة 402 مع الكود license_required عند Connect.


تنبيهات يمكنك تفعيلها

7 أنواع من التنبيهات — تأخّر الحضور، طلبات الإجازة، موافقات العمليات. تتضمّن كل رسالة Slack ملخصًا من سطر واحد وزرّ "Open request" حتى يستطيع المدير اتخاذ الإجراء بنقرة واحدة. التنبيهات السبعة قابلة للتشغيل أو الإيقاف، فلا تتحوّل قناتك إلى آلة ضوضاء.

تأخّر في الحضور

المصدر: attendance

clock_in_late
افتراضيًا مُفعّل

Pro: كتم

🌴

إرسال طلب إجازة

المصدر: leaves

leave_request_submitted
افتراضيًا مُفعّل

Pro: كتم

اعتماد إجازة

المصدر: leaves

leave_request_approved
افتراضيًا مُفعّل

Pro: كتم

رفض إجازة

المصدر: leaves

leave_request_rejected
افتراضيًا مُفعّل

Pro: كتم

📋

إرسال طلب عملية

المصدر: process

process_request_submitted
افتراضيًا مُفعّل

Pro: كتم

🔄

تغيّر حالة العملية

المصدر: process

process_request_status_changed
افتراضيًا مُفعّل

Pro: كتم

📅

إسناد وردية

المصدر: attendance

shift_assigned
افتراضيًا مُعطّل

Pro: كتم

Professional+

كتم لكل حدث

في خطتي Professional و Enterprise، يعرض مربع حوار الاتصال مفاتيح تبديل لكل من الأحداث السبعة. اكتم الأحداث الكثيرة الإزعاج (مثلًا shift_assigned في جداول الورديات السريعة التغيّر) دون فصل التكامل. ترى الفئات الأدنى الأحداث السبعة كلها افتراضيًا — لا توجد إغراءات في الواجهة لميزات غير مفعّلة.

PATCH /v1/integrations/connections/slack/event-subscriptions

{
  "event_subscriptions": {
    "clock_in_late": false,
    "shift_assigned": true
  }
}

PATCH جزئي — تحتفظ المفاتيح المحذوفة من البودي بقيمتها الحالية. تُتجاهل مفاتيح الأحداث غير المعروفة بصمت (دفاعًا ضد أخطاء الكتابة لدى العميل).


تنسيق رسالة Block Kit

يُعرض كل حدث في أربع كتل Block Kit: header يضم رمز تعبيري وعنوانًا، وsection بصيغة mrkdwn، وزرّ actions اختياري عند توفّر رابط مباشر، وتذييل context رمادي صغير يحتوي مفتاح الحدث والطابع الزمني.

{
  "text": "⏰ Alice late by 12 min",
  "blocks": [
    { "type": "header",
      "text": { "type": "plain_text", "text": "⏰ Alice late by 12 min", "emoji": true } },
    { "type": "section",
      "text": { "type": "mrkdwn", "text": "Clocked in at 09:12 · scheduled 09:00 · Front Office" } },
    { "type": "actions",
      "elements": [
        { "type": "button", "style": "primary",
          "text": { "type": "plain_text", "text": "Open in svdy" },
          "url": "https://qutime.com/admin/attendance/entries/te_..." }
      ] },
    { "type": "context",
      "elements": [
        { "type": "mrkdwn",
          "text": "`clock_in_late` · 2026-05-24 14:00 UTC" }
      ] }
  ]
}

استكشاف الأخطاء وإصلاحها

عند فشل التثبيت، يعيد svdy التوجيه إلى /admin/integrations?integration_error=<code>. الأكواد الشائعة:

license_required

خطة المؤسسة أدنى من Starter (لـ Slack) أو Professional (لـ Teams / WeCom).

يمكن الترقية من /admin/billing أو التواصل مع فريق المبيعات.

state_expired_or_invalid

انتهت صلاحية رمز state الخاص بـ OAuth (TTL مدته 5 دقائق) أو تم تزويره.

اضغط Connect Slack مجددًا من /admin/integrations.

provider_mismatch

أُصدر state الخاص بـ OAuth لمزوّد مختلف عن المذكور في الـ URL.

هذا في الغالب هجوم — ارفض الطلب وأعد التثبيت من الصفر.

code_exchange_failed

رفض Slack رمز التفويض.

افصل ثم أعد الاتصال. إن استمرّت المشكلة، تواصل مع support@svdy.com.

provider_error:access_denied

ضغط المسؤول على "إلغاء" في نافذة تفويض Slack.

اضغط Connect Slack مجددًا ثم وافق على الصلاحيات.


مزوّدات مراسلة أخرى

يستخدم Slack بروتوكول OAuth لأن واجهته البرمجية تتيح نطاق incoming-webhook الذي يُعيد URL مرتبطًا بقناة. لا تتيح Microsoft و Tencent ما يماثل ذلك — كلاهما يعتمد نموذج "لصق الـ URL": تُنشئ connector / بوت داخل المنصّة وتلصق رابطه في svdy.

Microsoft Teams

Professional+

استخدم Power Automate Workflow بمشغّل HTTP — أوقفت Microsoft دعم Office 365 Connectors بتاريخ 2025-12-31. حمولة Adaptive Card v1.5.

مضيفات webhook المقبولة: *.webhook.office.com, *.logic.azure.com, *.azurewebsites.net.

WeCom (企业微信)

Professional+

أنشئ روبوت مجموعة (群机器人) داخل WeCom وانسخ رابط الـ webhook الخاص به. الحمولة Markdown (بسقف 4096 بايت).

المضيف المقبول: qyapi.weixin.qq.com. تُعتبر الاستجابة فاشلة سواء كانت حالة HTTP خارج 2xx أو كانت قيمة errcode غير صفرية.

هل أنت جاهز لتوصيل Slack؟

افتح صفحة التكاملات في تينَنتك واضغط Connect — 30 ثانية فقط لإتمام التثبيت. تفاصيل الخطط على بُعد نقرة إن أردت المقارنة أولًا.