BITEX التوثيق English

إشعار

يمكنك تكوين العديد من الإشعارات في نظامك لتذكيرك بالأنشطة المهمة.

  1. تاريخ الانتهاء من المهمة.
  2. تاريخ التسليم المتوقع لأمر المبيعات.
  3. تاريخ الدفع المتوقع.
  4. تذكير بالمتابعة.
  5. إذا تم استلام أو إرسال طلب أكبر من قيمة معينة.
  6. إشعار انتهاء العقد.
  7. إكمال/تغيير حالة المهمة.

للوصول إلى إعداد الإشعارات، انتقل إلى:

الصفحة الرئيسية > الإعدادات > الإشعارات

  1. إعداد تنبيه

لإعداد إشعار:

  1. حدد الأحداث التي تريد مشاهدتها ضمن إرسال التنبيه. الأحداث هي: جديد: عند إنشاء مستند جديد من النوع المحدد.
  2. حفظ/إرسال/إلغاء: عند حفظ مستند من النوع المحدد أو إرساله أو إلغاؤه.
  3. الأيام السابقة/الأيام اللاحقة: قم بتشغيل هذا التنبيه قبل بضعة أيام من التاريخ المرجعي أو بعده. لتعيين الأيام، قم بتعيين الأيام السابقة أو اللاحقة. يمكن أن يكون هذا مفيدًا في تذكيرك بتواريخ الاستحقاق القادمة أو تذكيرك بمتابعة بعض العملاء المحتملين لعروض الأسعار.
  4. تغيير القيمة: عندما تتغير قيمة معينة في النوع المحدد.
  5. الطريقة: يرسل إشعارًا عند تشغيل طريقة معينة. على سبيل المثال: before_insert.
  6. Custom: Send a notification to an Email Account selected.

حدد نوع المستند الذي تريد مشاهدة التغييرات عليه. من الإصدار 16، يمكنك أيضًا تحديد أنواع المستندات الفرعية إذا تم تعيين إرسال التنبيه إلى _الأيام السابقة_أو الأيام اللاحقة.

قم بتعيين شروط إضافية إذا لزم الأمر.

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

قم بتأليف الرسالة.

حفظ.

1.1 تحديد الموضوع

You can retrieve the data for a particular field by using doc.[field_name]. To use it in your subject/message, you have to surround it with {% raw %}{{ }}{% endraw %}. These are called Jinja tags. For example, to get the name of a document, you use {% raw %}{{ doc.name }}{% endraw %}. The following example sends an email on saving a Task with the Subject, "TASK#### has been created"

1.2 تحديد الشروط

تتيح لك الإشعارات ضبط الشروط وفقًا للبيانات الميدانية الموجودة في مستنداتك. على سبيل المثال، إذا كنت تريد تلقي بريد إلكتروني إذا تم حفظ العميل المحتمل كـ "مهتم" كحالته، فيمكنك وضع doc.status == "Interested" في مربع نص الشروط. يمكنك أيضًا تعيين شروط أكثر تعقيدًا من خلال دمجها مع عامل التشغيل و أو أو.

سيرسل المثال أعلاه إشعارًا عند حفظ مهمة بالحالة "مفتوحة" و"تاريخ الانتهاء المتوقع" للمهمة هو التاريخ الموجود في التاريخ الذي تم حفظها فيه أو قبله.

1.3 إعداد الرسالة

يمكنك استخدام علامات Jinja ({% raw %}{{ doc.[field_name] }}{% endraw %}) وعلامات HTML في مربع نص الرسالة.

{% raw %}<h3>Order Overdue</h3>

لقد تجاوزت المعاملة {{ doc.name }} تاريخ الاستحقاق. يرجى اتخاذ الإجراءات اللازمة.

{% if comments %} آخر تعليق: {{ comments[-1].comment }} بواسطة {{ comments[-1].by }} {% endif %}

<h4>Details</h4>
  • العميل: {{ doc.customer }}
  • المبلغ: {{ doc.total_amount }}

{% endraw %}

1.4 تحديد القيمة بعد ضبط التنبيه

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

ثم يمكنك استخدام ذلك كشرط في قواعد الشرط لضمان عدم إرسال رسائل البريد الإلكتروني عدة مرات

1.5 مثال

  1. تحديد المعايير

  2. ضبط المستلمين والرسالة

  3. إشعارات الركود

إذا كنت تفضل إرسال إشعاراتك إلى قناة Slack مخصصة، فيمكنك أيضًا اختيار الخيار "Slack" في خيارات القناة وتحديد عنوان URL المناسب لـ Slack Webhook.

2.1 عنوان URL لـ Slack Webhook

عنوان URL لـ Slack webhook هو عنوان URL يشير مباشرة إلى قناة Slack.

لإنشاء عناوين URL للخطاف على الويب، تحتاج إلى إنشاء تطبيق Slack جديد:

  1. انتقل إلى https://api.slack.com/slack-apps.
  2. انقر فوق "إنشاء تطبيق Slack".
  3. قم بتسمية تطبيقك واختر مساحة العمل المناسبة. بمجرد إنشاء تطبيقك، انتقل إلى قسم "Webhooks الوارد" وأضف Webhook جديدًا إلى Workspace.
  4. انسخ الرابط الذي تم إنشاؤه، وارجع إلى BITEX واستخدمه لإنشاء عنوان URL جديد لـ Slack Webhook في عمليات التكامل > Slack Webhook URL.
  5. حدد Slack وقناة Slack الخاصة بك في حقول القناة وقناة Slack ضمن الإشعار الخاص بك

2.2 تنسيق الرسالة

على عكس رسائل البريد الإلكتروني، لا يسمح Slack بتنسيق HTML.

Instead, you can use markdown formatting: Slack Documentation

مثال: {% raw %} الطلب متأخر

Transaction {{ doc.name }} has exceeded Due Date. Please take the necessary action.

{% if comments %}
Last comment: {{ comments[-1].comment }} by {{ comments[-1].by }}
{% endif %}

*Details*

• Customer: {{ doc.customer }}
• Amount: {{ doc.grand_total }}
{% endraw %}
  1. إشعارات النظام

في الإصدار 12، قدمنا إشعارات النظام الخاصة بـ المهام، والإشارات، والمستندات المشتركة، ونقاط الطاقة. تظهر هذه الإشعارات في قائمة الإشعارات المنسدلة في الزاوية اليمنى العليا من شريط التنقل.

في الإصدار 13 قدمنا قناة إضافية لإرسال التنبيهات - إشعارات النظام:

سيؤدي اختيار هذه القناة إلى إرسال إشعار النظام عند تشغيل الإشعار، بدلاً من البريد الإلكتروني أو إشعار Slack.

يؤدي النقر فوق مسارات الإشعارات إلى مستند سجل الإشعارات الذي يحتوي على الموضوع الذي تم تكوينه والرسالة بالإضافة إلى الملف المرفق، في حالة تعيين إرفاق طباعة:

إذا كانت تنبيهات البريد الإلكتروني/Slack وإشعارات النظام مطلوبة، فيمكن تعيين القناة الرئيسية كبريد إلكتروني أو Slack ويمكن تحديد هذا الخيار:

  1. واتساب

إذا كنت تفضل إرسال إشعاراتك إلى رقم WhatsApp، فيمكنك أيضًا اختيار خيار "WhatsApp" في خيارات القناة وتحديد رقم Twilio المناسب. يمكن إضافة أرقام Twilio إلى إعدادات Twilio في Frappe. لا يمكن إرسال رسائل WhatsApp إلا إلى الأرقام التي تحتوي على رموز البلد.

4.1 إعدادات تويليو

4.2 تنسيق الرسالة

  1. SMS

In order to use this channel, you would need to complete the configuration of SMS Settings.

6. موضوعات ذات صلة

  1. SMS Settings
  2. Document Follow

7. تذكير لمرة واحدة

ملاحظة: هذه الميزة متاحة فقط في الإصدار الليلي اعتبارًا من الآن.

نظرًا لأن إعداد الإشعارات عملية معقدة للغاية، فإن Frappe Framework يوفر أيضًا طريقة لإعداد تذكيرات لمرة واحدة على المستندات. مثال على هذا الإشعار سيكون "ذكّرني بمتابعة هذا العميل المحتمل خلال 4 ساعات"

لإعداد تذكير لمرة واحدة على المستند:

  1. افتح المستند الذي تريد تعيين تذكير عليه
  2. انقر على القائمة (ثلاث نقاط) > "ذكّرني"
  3. حدد الوقت وأضف وصفًا لنفسك وانقر فوق "إنشاء"
  4. سيرسل لك النظام إشعارًا بالنظام في الوقت الذي قمت فيه بتكوينه مع وصف التذكير كموضوع.