ربط برامج أخرى: API وwebhooks وتنبيهات Slack أو Teams

في التكاملات (ضمن الإعدادات) يمكنك ربط Kaam360 ببرامج أخرى. هذا جزء من باقة Business. لا يفتحها إلا المسؤولون.

اقرأ بياناتك بمفتاح API

1. افتح الإعدادات واختر التكاملات.
2. تحت مفاتيح API اكتب الاسم (مثل Zapier أو جدول المحاسبة) واضغط إنشاء مفتاح API.
3. انسخ المفتاح الظاهر. يُعرض مرة واحدة فقط. من يملك المفتاح يمكنه قراءة كل بيانات مؤسستك، فاحفظه سرًا.
4. أعطِ المفتاح للبرنامج. يرسله في الترويسة Authorization: Bearer .... يعرض قسم استخدام API العناوين ومثالًا.
5. المفتاح يقرأ فقط، إلا إذا حددت السماح لهذا المفتاح بإضافة عملاء محتملين عند إنشائه. عندها يمكنه أيضًا إضافة عملاء محتملين. لا يمكنه تغيير أو حذف أي شيء آخر. اضغط إلغاء لإيقاف المفتاح فورًا. يتوقف المفتاح أيضًا عن العمل عندما يُوقف الشخص الذي أنشأه في المستخدمون؛ أنشئ مفتاحًا جديدًا من حساب مسؤول آخر.

استخدم Zapier أو Make

تربط Zapier وMake البرامج دون برمجة. لا تحتاج إلى تطبيق خاص من Kaam360.

1. أنشئ مفتاح API كما سبق. حدد السماح لهذا المفتاح بإضافة عملاء محتملين إذا أردت أن ترسل النماذج أو الإعلانات أو الجداول عملاء محتملين إلى Kaam360.
2. في Zapier أو Make اختر خطوة تستدعي عنوان ويب (في Zapier: Webhooks by Zapier؛ وفي Make: HTTP). استخدم الترويسة Authorization: Bearer ... مع مفتاحك.
3. لقراءة البيانات استدعِ العناوين المذكورة في استخدام API (مثل /api/v1/leads أو /api/v1/deals). لإضافة عميل محتمل أرسل POST إلى /api/v1/leads مع اسم العائلة أو البريد الإلكتروني.
4. يرتبط قسم استخدام API أيضًا بـ /api/v1/openapi.json، الوصف الكامل لواجهة API. دليل المطورين الكامل مع الواجهة الأحدث (الإصدار 2) موجود في /developers.
5. لتعرف عندما يحدث شيء، استخدم برنامج آخر (JSON موقّع) في قسم webhooks.

تلقَّ تنبيهات في Slack أو Microsoft Teams

1. في Slack أو Teams أنشئ webhook وارد للقناة التي تريدها وانسخ عنوانه.
2. في التكاملات تحت Webhooks وتنبيهات الدردشة اكتب الاسم واختر قناة في Slack أو قناة في Microsoft Teams والصق عنوان الويب.
3. تحت أبلغه عندما حدد ما تريد معرفته. لا تحدد شيئًا لتعرف كل شيء.
4. اضغط إضافة عنوان ثم إرسال اختبار. يجب أن تظهر رسالة تجريبية قصيرة في القناة.

أخبر برنامجًا آخر

1. اختر برنامج آخر (JSON موقّع) واكتب عنوانه. يجب أن يبدأ بـ https:// وأن يكون على الإنترنت العام.
2. انسخ سر التوقيع الظاهر. يُعرض مرة واحدة فقط. يستخدمه البرنامج الآخر للتحقق من أن الرسالة جاءت فعلًا من Kaam360.
3. كل رسالة JSON فيها معرّف واسم الحدث وملخص قصير وأهم التفاصيل. استخدم API لجلب السجل الكامل.
4. كل رسالة موقعة: تحتوي الترويسة X-Kaam360-Signature على HMAC-SHA256 لوقت الإرسال (X-Kaam360-Timestamp) والرسالة. على المستقبِل رفض أي رسالة أقدم من خمس دقائق، حتى لا يمكن إعادة إرسال رسالة منسوخة لاحقًا. يحتوي دليل المطورين على شيفرة جاهزة لهذا الفحص.
5. لتغيير عنوان أو أحداثه أو ملاحظته اضغط تعديل. إذا كان السر قد تسرب، اضغط سر توقيع جديد: يتوقف القديم فورًا، فأعطِ الجديد للبرنامج الآخر مباشرة.

ما الذي يمكنك معرفته

إضافة عميل أو عميل محتمل، الفوز بصفقة أو خسارتها، إنشاء مشروع أو تغييره، إضافة مهمة أو تغييرها أو إكمالها، كتابة فاتورة أو إصدارها (إرسالها) أو دفعها أو إلغاؤها، انتقال دفعة مشروع إلى مرحلة أخرى، توقيع عقد، وفتح تذكرة دعم.

سجل التسليم

يعرض سجل التسليم كل رسالة خلال الأسبوعين الماضيين: متى أُرسلت، وإلى أي عنوان، ورد المستقبِل (رمز الحالة والمدة)، والنتيجة.

1. اختر عنوانًا أو نتيجة (تم التسليم، بانتظار إعادة المحاولة، تم التخلي) أو حدثًا لرؤيتها فقط.
2. اضغط عرض ما أُرسل لرؤية الرسالة وبداية رد المستقبِل.
3. اضغط إرسال مرة أخرى لإعادة إرسال رسالة سُلّمت أو تم التخلي عنها. تحتفظ بالمعرّف نفسه ليعرف المستقبِل أنها تكرار.

إذا حدث خطأ

• إذا كان المستقبِل متوقفًا، يعيد Kaam360 المحاولة بعد دقيقة و5 دقائق و30 دقيقة وساعتين و12 ساعة، ثم يتوقف.
• العنوان الذي يفشل 15 مرة متتالية يُوقف، ويتلقى كل من يدير التكاملات بريدًا إلكترونيًا. تظهر ملاحظة حمراء في الصفحة تبين متى حدث ذلك. أصلح المشكلة، واضغط استئناف، ثم أعد إرسال الرسائل الفائتة من سجل التسليم.
• العناوين داخل شبكة خاصة (مثل localhost أو 10.0.0.1 أو 192.168.1.5) غير مسموح بها، ويُعاد فحصها في كل إرسال.
• إذا لم ترَ التكاملات، فقد لا تشملها باقتك، أو لا يملك دورك صلاحية إدارة التكاملات.