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

جهات الاتصال

دفتر العناوين الذي يراسله هذا الصندوق.

أدوات جهات الاتصال

الأداةما تفعله
listContactsالأشخاص الذين يراسلهم هذا الصندوق، الأحدث مراسلةً أولًا. ابحث بالاسم أو بالعنوان، أو ضيّق النطاق إلى جمهور واحد، أو افصل من أضافهم أحدهم عمّن سُجّلوا تلقائيًا.
getContactجهة اتصال واحدة بعنوان البريد الإلكتروني، مع ملاحظاتها كاملة وكل جمهور تنتمي إليه.
createContactأضف جهة اتصال يدويًا. جهة اتصال واحدة لكل عنوان، فالعنوان الموجود هنا مسبقًا يُرفض بدل أن يُكتب مرتين. وتنضم جهة الاتصال الجديدة إلى الجمهور الافتراضي.
updateContactغيّر اسم جهة اتصال أو الملاحظات المحفوظة عليها. وتمرير null يمسح الحقل، وتركه دون تمرير يُبقيه على حاله.
deleteContactاحذف جهة اتصال نهائيًا. تذهب الملاحظات معها، وكذلك كل جمهور كانت فيه.

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

العنوان هو الهوية ولا يوجد id. لذا لا يستطيع updateContact تغييره، ونقل أحدهم إلى عنوان جديد هو createContact وdeleteContact. وcreateContact لا يأخذ source: فكل ما يُنشأ هنا هو manual، ولا يخفض الإرسال ذلك أبدًا إلى auto.

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