تخطَّ إلى المستندات
خادم MCP

القواعد

ما يحدث للبريد عند وصوله.

أدوات القواعد

الأداةما تفعله
listRulesكل قاعدة على الاتصال النشط، بترتيب تقييمها، مع ما تفعله كل واحدة وكم مرة انطلقت.
getRuleقاعدة واحدة بالكامل: شروطها وإجراءاتها وهل هي مفعّلة.
createRuleاكتب قاعدة: شروطًا على رسالة واردة، وما ينبغي أن يحدث لكل ما يطابقها. وتُنشأ القاعدة معطَّلة.
testRuleأي رسائل الثلاثين يومًا الماضية كانت القاعدة ستلتقطها، وما كانت ستفعله بها. ولا تغيّر شيئًا.
setRuleEnabledفعّل قاعدة واحدة أو عطّلها، بعد أن يكون شخص قد قرأها.

يكتب createRule القاعدة معطَّلة، وهذا هو الموضع الوحيد الذي يختلف فيه هذا الخادم عمدًا عن الـ REST API. فـ POST /rules يُنشئها مفعّلة افتراضيًا. والقاعدة التي تؤرشف البريد أو تُلقيه في المهملات أو تعيد توجيهه لا ينبغي أن تبدأ بفعل ذلك بناءً على رسالة محادثة: اكتبها، ثم استدعِ testRule لتُري الشخص الذي تعمل لحسابه أي رسائله كانت ستلتقطها، وعندئذٍ فقط اطلب setRuleEnabled.

لا يوجد updateRule ولا deleteRule ولا إعادة ترتيب، للسبب نفسه الذي لا يوجد من أجله حذفٌ للقوالب: فتلك هي العمليات التي تُفسد إعداد شخص آخر من داخل نافذة محادثة. فالقاعدة المحذوفة لا يمكن استرجاعها، وإعادة الترتيب تغيّر بصمت ما تفعله كل رسالة مقبلة. وثلاثتها موجودة في الإعدادات ← القواعد وعلى الـ REST API، حيث يكون شخص هو من ينقر.

القواعد تخصّ الاتصال، فهذه الأدوات تعمل على أي صندوق بريد سمّاه setActiveConnection آخر مرة، والقاعدة التي كتبها زميل واحدة منها. ويحمل الصندوق 100 قاعدة، لكل منها 20 شرطًا و10 إجراءات كحدّ أقصى.

لا شيء هنا رجعي الأثر. فالقاعدة تقرّر ما يحدث للبريد الوارد بعد تفعيلها؛ ولا تكنس صندوقًا قائمًا بالفعل، وtestRule يُبلِّغ ولا يُرتّب شيئًا.