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

القوالب

متن يُكتب مرة واحدة، ويُرسل مرات كثيرة.

أدوات القوالب

الأداةما تفعله
listTemplatesكل قالب على الاتصال النشط، مع ما يتوقّعه كل منها.
getTemplateقالب واحد بالـ id أو بالـ slug، مع مفاتيحه المنشورة وأحدث إصدار له.
createTemplateخزّن متنًا، مع نشره اختياريًا ليصبح قابلًا للإرسال فورًا.
previewTemplateصيّر قالبًا بقيم تزوّده بها، دون إرساله.
sendWithTemplateأرسل رسالة مبنية من قالب، مع تعبئة الخصائص.

القوالب تخصّ الاتصال، فهذه الأدوات تعمل على أي صندوق بريد سمّاه setActiveConnection آخر مرة، والقالب الذي كتبه زميل واحد منها.

المسودّة لا يمكن إرسالها. فـ previewTemplate يصيّرها، وsendWithTemplate يرفضها بـ template_not_published، وعدم التماثل هذا هو المقصود: فالمتن الذي لم ينشره أحد متنٌ لم يوافق عليه أحد.

تُفحص الخصائص بصرامة عند الخروج. فالمفتاح المجهول أو المطلوب الغائب يرفض الإرسال رفضًا قاطعًا بدل إرسال فراغ مكان رقم الطلب، وهو العطل الوحيد الذي لا يبلّغ عنه شيء في المراحل التالية.