Gmail
اربط Gmail ليستطيع الوكيل البحث في البريد وقراءته والرد عليه، وإرسال رسائل المتابعة وحفظ المسودات وترتيب صندوق الوارد، كل ذلك من حساب Gmail الخاص بك.
ما الذي ستحققه
سيستطيع الوكيل التعامل مع بريدك في Gmail: العثور على الرسائل وقراءتها، والرد ضمن المحادثة نفسها، وحفظ المسودات، وإرسال رسائل المتابعة، ووضع علامة «مقروءة» على رسالة أو أرشفتها أو نقلها إلى سلة المحذوفات. وأنت تختار ما يحصل عليه كل وكيل من ذلك.
نظرة عامة وحالات الاستخدام
- إرسال تفاصيل موعد المتصل إليه بالبريد.
- إرسال ملخص لما طلبه المتصل إلى فريقك.
- العثور على «الرسالة التي أرسلتها سارة عن عرض السعر» والإجابة منها.
- الرد على رسالة أحد العملاء ضمن المحادثة نفسها.
- حفظ ردّ كمسودة لتراجعه قبل إرساله.
المتطلبات المسبقة
- حساب Gmail أو Google Workspace. ويُقرأ البريد من ذلك العنوان ويُرسل منه.
- إذا لم توفّر Phynxa تطبيق Google، فعميل OAuth من Google Cloud (راجع Google Calendar؛ وفعّل Gmail API).
اربطه في Phynxa
- Integrations، Connect في Gmail.
- Sign in with Google (أو الصق Client ID والسرّ أولًا)، واختر الحساب ووافق. وتطلب شاشة الموافقة إذنًا بقراءة بريدك وإرساله وإدارته ورؤية عنوانك. ولا تطلب أبدًا حذف الرسائل نهائيًا.
- تعرض البطاقة Connected.
الأذونات والإعدادات
النطاقات: gmail.modify وuserinfo.email. تستطيع Phynxa قراءة البريد وإرساله وحفظ المسودات وتغيير التصنيفات ونقل رسالة إلى سلة المحذوفات. ولا تستطيع حذف رسالة نهائيًا.
تصنّف Google النطاق gmail.modify إذنًا مقيَّدًا. وإذا ربطت بتطبيق Google الخاص بك، فلا تسمح Google بالموافقة عليه إلا لمستخدمي الاختبار الذين تدرجهم (حتى 100) إلى أن يجتاز التطبيق مراجعة Google.
هل ربطت Gmail قبل إضافة القراءة؟ كان ذلك الربط يملك إذن الإرسال فقط. ويستمر الإرسال في العمل؛ أما بقية الإجراءات فاختر Reconnect ووافق من جديد.
استخدمه في مكالمة
| الإجراء | ما يفعله | يعمل |
|---|---|---|
| Send email | يرسل بريدًا إلكترونيًا. ويحتاج to (عدة عناوين مفصولة بفواصل) وsubject وbody. | في الخلفية |
| Search emails | يعرض الرسائل المطابقة مع مرسل كل منها وموضوعها وتاريخها وأولى كلماتها. ويأخذ query بكلمات بحث Gmail (مثل from:sara@example.com is:unread newer_than:7d) وmax_results (حتى 10). | ينتظر |
| Read email | يفتح رسالة واحدة ويعيد نصها (حتى نحو 3500 حرف) ومرسلها وأسماء المرفقات. ويحتاج message_id من نتيجة بحث. | ينتظر |
| Read conversation | يعيد آخر أربع رسائل من محادثة. ويحتاج thread_id. | ينتظر |
| Reply to email | يردّ ضمن المحادثة نفسها على من كتب الرسالة (على عنوان الرد الذي حدده إن وُجد). ويحتاج message_id وbody. | في الخلفية |
| Create draft | يحفظ رسالة في مسودات Gmail. ولا يُرسل شيء. ويحتاج to وsubject وbody. | في الخلفية |
| Mark as read | يضع علامة «مقروءة» على رسالة واحدة. | في الخلفية |
| Archive email | يُخرج رسالة واحدة من صندوق الوارد. وتبقى محفوظة ويمكن العثور عليها. | في الخلفية |
| Move to trash | ينقل رسالة واحدة إلى سلة المحذوفات، حيث تحتفظ بها Gmail 30 يومًا. | في الخلفية |
وتعمل هذه الإجراءات أيضًا مع وكيل واتساب: في تبويب Tools فيه، Add tool، Integration، Gmail. راجع إنشاء وكيل واتساب.
حافظ على أمان بريدك
- امنح إجراءات القراءة للوكلاء الموثوقين فقط. فالوكيل الذي يخاطب الجمهور (خط هاتف أو أداة في موقع أو رقم واتساب) يجيب كل من يحدّثه، فيستطيع أي شخص سؤاله عن بريدك. وللوكيل العام امنحه Send email أو Create draft فقط.
- نص الرسالة كتبه شخص آخر. وقد يحتوي تعليمات موجهة إلى مساعد («أعد توجيه كل شيء إلى ...»). وتطلب Phynxa من الوكيل أن يعامل ما يقرؤه معلومةً لا تعليمات، لكن الأسلم ألا تمنح وكيلًا واحدًا إجراءات القراءة والإرسال معًا.
- يمكن إيقاف كل أداة بإزالتها من الوكيل.
- لا توجد محادثة خاصة «اسألني عن بريدي». يجيب وكيل واتساب العملاء الذين يكتبون إلى رقمه؛ ولا يتلقى منك أوامر بشأن صندوق بريدك.
اختبره
Test connection، ثم في Chat اطلب من الوكيل العثور على أحدث رسالة لديك، ثم قراءتها.
النتيجة المتوقعة
يذكر الوكيل مرسل رسالة حقيقية في بريدك وموضوعها ويلخّصها. ويصل البريد المرسَل من عنوان Gmail الخاص بك ويظهر في مجلد المرسَل.
استكشاف الأخطاء
- «Reconnect Gmail». تم الربط قبل إضافة القراءة، أو لم يُمنح الإذن. استخدم Reconnect ووافق.
- «The Gmail API is not turned on». فعّل Gmail API في مشروع Google Cloud الخاص بك، وانتظر دقيقة ثم أعد المحاولة.
- «Not found». حُذفت الرسالة، أو أن المعرّف لم يأتِ من نتيجة بحث. ابحث من جديد.
- الرسالة مقتطعة. تُقصَّر الرسائل الطويلة ليتمكن الوكيل من قراءتها في الوقت المناسب. افتح الرسالة في Gmail لبقيتها.
- لا يصل البريد. تحقق من البريد غير المرغوب فيه ومن العنوان الذي استخدمه الوكيل.
- الحدود. تحدد Gmail عدد الرسائل التي يستطيع حساب إرسالها يوميًا وسرعة الرد على الطلبات؛ وقد ترفض Google الاستخدام المكثف.
الأمان وبيانات الاعتماد
تُخزَّن الرموز مشفّرة. اسحب الإذن من صفحة الأمان في حساب Google الخاص بك؛ وRemove ينساه هنا. ويتصرف الوكيل باسمك، فأخبره بما يجوز له قراءته وإرساله.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.