أدوات البريد الإلكتروني

صندوق البريد المربوط هو أيضًا عائلة أدوات للوكيل, قراءة، وبحث، وفتح، وإرسال، وردّ، ووسم، ونقل. وكلها خاصّة بالمالك، ومتمايزة عن البريد الإلكتروني كقناة.

صندوق البريد الذي تربطه كـقناة بريد إلكتروني ذو واجهتين: فإلى جانب الردّ على البريد الوارد، يسلّم وكيلك عائلة أدوات, قراءة صندوق الوارد، والبحث، وفتح رسالة، والإرسال، والردّ داخل السلسلة، والوسم كمقروء/غير مقروء، ونقل الرسائل. وكل واحدة من هذه الأدوات خاصّة بالمالك. وإليك ما يستطيع وكيل داخلي فعله بصندوق بريد بوصفه أدوات.

الربط

لا توجد خطوة ربط منفصلة لأدوات البريد الإلكتروني, فـربط قناة البريد الإلكتروني هو ما يشغّلها. إذ يشغّل صفّ صندوق البريد نفسه كلتا الواجهتين.

اربط صندوق بريد من القنوات ← إضافة قناة ← البريد الإلكتروني, تسجيل دخول Gmail، أو IMAP/SMTP لأي مزوّد آخر. والخطوات الكاملة في صفحة قناة البريد الإلكتروني.
اربط ذلك الاتصال بوكيل داخلي, لوحة التحكم أو BotFather. فأدوات البريد الإلكتروني لا تظهر إلا للمستدعين الداخليين.
تحدّث إلى الوكيل. اطلب منه فحص صندوق الوارد، أو البحث عن مُرسِل، أو صياغة ردّ.

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

ماذا يستطيع الوكيل أن يفعل

الأداة	الوصول	النوع	ما تفعله
`email_list_accounts`	خاصة بالمالك	Read	يسرد صناديق البريد المربوطة بهذا الوكيل مع عناوينها ومزوّدها وحالتها, استدعِه أولًا عند ربط أكثر من صندوق للحصول على معرّف الحساب.
`email_read_inbox`	خاصة بالمالك	Read	يسرد الرسائل الأخيرة من مجلد (والافتراضي INBOX) مع الموضوع والمُرسِل والتاريخ وحالة القراءة.
`email_search`	خاصة بالمالك	Read	يبحث في مجلد بكلمة مفتاحية عبر الموضوع والمُرسِل والنص؛ ويعيد الرسائل المطابقة.
`email_get_message`	خاصة بالمالك	Read	يفتح رسالة واحدة بمعرّفها, الموضوع الكامل، والمُرسِل/المستلم/النسخة، والتاريخ، ونصّ الرسالة.
`email_send`	خاصة بالمالك	Write	يرسل بريدًا جديدًا (نصًّا عاديًا أو HTML) مع نسخة ونسخة مخفية اختياريتين، من العنوان المربوط.
`email_reply`	خاصة بالمالك	Write	يردّ على رسالة داخل السلسلة, فيضبط ترويسات السلسلة ويضيف 'Re:' إلى الموضوع.
`email_mark_read`	خاصة بالمالك	Write	يضع على رسالة علامة مقروءة أو غير مقروءة.
`email_move`	خاصة بالمالك	Write	ينقل رسالة إلى مجلد أو وسم آخر, سلة المهملات والأرشيف وما شابه.

خاصّة بالمالك, والفصل بين القراءة والكتابة

لا شيء منها آمن للعموم. فالأدوات الثماني جميعها محكومة بـمستدعٍ داخلي بالإضافة إلى وجود إضافة البريد الإلكتروني، وكل استدعاء موسوم بأنه حسّاس ليبقى مخفيًا عن تدفّق الدردشة. وضمن ذلك توجد طبقتان: أدوات القراءة الأربع (سرد الحسابات، وقراءة صندوق الوارد، والبحث، وفتح رسالة) وأدوات الكتابة الأربع (الإرسال، والردّ، والوسم كمقروء، والنقل). ومفتاح القراءة فقط في القناة يزيل الأربع الكاتبة, فصندوق البريد للقراءة فقط يتيح للوكيل فرز البريد واقتباسه لكن دون التصرّف به أبدًا.

مثال عملي

تقول لوكيل الدعم الداخلي لديك: «افحص صندوق واردي بحثًا عن أي شيء من Acme هذا الأسبوع، وإن كانوا قد سألوا عن الفاتورة فردّ بأنها في الطريق.» فيشغّل الوكيل email_search عن Acme، ثم email_get_message لقراءة السلسلة، ثم email_reply للردّ داخل السلسلة باسم المُرسِل وتوقيعك, جولة واحدة، دون التبديل إلى برنامج بريدك.

الحدود والصراحة

عمليات الكتابة إرسالات حقيقية. فـemail_send وemail_reply تُسلَّم إلى مستلمين حقيقيين من عنوانك الحقيقي. اختبر على وكيل داخلي أولًا.
القراءة فقط هي الحارس. فمع تفعيل إعداد القراءة فقط في القناة، تُخفى أدوات الكتابة تمامًا, فيستطيع الوكيل القراءة لكن دون الإرسال أو الوسم أو النقل أبدًا.
المعرّفات مبهمة، وبصيغة المزوّد. فمعرّف الرسالة رقم لصناديق IMAP ونصّ لـGmail, أعِد دائمًا ما أعادته email_read_inbox أو email_search بالضبط؛ ولا تخمّن.
اختر صندوق البريد عند وجود أكثر من واحد. فمع ربط عدّة صناديق، استدعِ email_list_accounts أولًا ومرّر account_uid؛ ومع صندوق واحد يُختار لك.

استكشاف الأخطاء

الوكيل لا يرى أدوات البريد الإلكتروني, غالبًا أنك على وكيل عامّ/دردشة ويب. فالعائلة خاصّة بالمالك؛ اربط صندوق البريد بوكيل داخلي.
القراءة تعمل والإرسال مرفوض, صندوق البريد في وضع القراءة فقط، أو (في حالة IMAP) فشلت مصادقة نصف SMTP. تحقّق من كليهما.
«لا توجد حسابات بريد مربوطة», صندوق البريد غير مربوط بهذا الوكيل، أو أخطأ الاتصال. أعِد الربط من القنوات.

أسئلة شائعة

هل يختلف هذا عن قناة البريد الإلكتروني؟ الاتصال نفسه، وواجهة ثانية. فالقناة تردّ على البريد الوارد؛ والأدوات تتيح لوكيل داخلي قراءة صندوق البريد كاملًا والتصرّف فيه.

هل يستطيع زائر موقع قراءة صندوق واردي؟ أبدًا, فالأدوات الثماني كلها خاصّة بالمالك وتبقى مطفأة على الوكلاء الموجّهين للعملاء.

هل أستطيع ربط أكثر من صندوق بريد؟ نعم, ولكلٍّ منها account_uid خاص؛ اسرد الحسابات أولًا، ثم استهدف واحدًا.

قناة البريد الإلكتروني, النصف الآخر: البريد الوارد كمحادثات
Google Workspace, Drive وDocs وCalendar وGmail
قدرات الوكيل, كيف ترتبط الأدوات بوكيل
نظرة عامة على التكاملات