أسرع طريق في المجموعة. لا مدير، ولا أذونات تطلبها، والشيء الوحيد الذي يعطب باستمرار هو خانة اختيار على شاشة Google نفسها.
هذه هي الدليلة الصحيحة لـ*“Any single-user inbox you own — either a personal
@gmail.com or your Google Workspace email like you@your-company.com.”*
إن كان عدة أشخاص يجيبون على العنوان، فأنت تريد
صندوق وارد مشتركًا
أو مجموعة Google بدلًا من هذا.
الشاشات
Channels → Add → Email → /channels/email/new.
| الشاشة | ما تقوله |
|---|---|
| Connect a mailbox | ”Omni Octo connects to your Gmail or Outlook mailbox to read and reply to email.” |
| Connect a Gmail mailbox | ”Authorize Omni Octo through Google’s consent screen.” |
| شاشة موافقة Google | شاشة Google نفسها — انظر أدناه |
| Verify mailbox setup | ”Round-trip a test message to confirm inbound and outbound delivery.” |
| Finish your mailbox setup | ”Pick an agent, default reply mode, and signature.” |
Gmail يحتفظ بتلك الشاشة الأخيرة. تدفقات Microsoft لا — إنها تجمع الحقول نفسها أبكر — فإن كنت قد ربطت صندوق Outlook من قبل، فهذه خطوة إضافية هنا وهذا متوقع.
الخانة التي تكسر كل شيء
Google لا تمنح الأذونات ككتلة واحدة. تعرضها خانات قابلة للتحديد فرديًا، معطّلة افتراضيًا، والمعالج يحذّرك قبل أن تصل إلى هناك:
Google will ask you which permissions to grant. Omni Octo needs both Gmail permissions to read inbound email and reply on your behalf. Click “Select all” (or tick both boxes individually) before clicking Continue.
ويقول ما يحدث إن لم تفعل:
If you skip either checkbox, sending or receiving won’t work and you’ll have to re-do this flow.
هذا هو الفشل الأكثر شيوعًا على طريق Gmail، ويفشل بصمت — يبدو الاتصال ناجحًا، ثم لا يصل شيء أو لا يُرسل شيء. حدّد الخانتين.
ما هذان الإذنان
| النطاق | ما يغطيه |
|---|---|
gmail.modify | قراءة بريدك، كتابة المسودات، تغيير التسميات، والإرسال |
gmail.settings.basic | قراءة توقيعك وإعدادات الصندوق الأساسية |
نطاقان واسعان بدل قائمة طويلة من النطاقات الضيقة — هكذا شُكّلت واجهة Google
البرمجية. gmail.modify يتضمن الإرسال، فإذن الإرسال موجود من لحظة الربط. وما
يقرّر إن كان شيء يُرسل تلقائيًا هو وضع الردّ، وDraft يحبس كل شيء بانتظار
الموافقة.
جولة التحقق ذهابًا وإيابًا
خطوة التحقق ترسل رسالة من الصندوق إلى نفسه. تثبت القراءة والإرسال في حركة واحدة، وهذا هو المغزى — شاشة موافقة فاتت فيها خانة تجتاز تسجيل الدخول وترسب هنا.
إن لم تعد الرسالة، فالمعالج يسمّي السبب المعتاد بدل أن يتهامس:
This usually means the Pub/Sub push subscription isn’t configured correctly — see the runbook or contact support.
هذا عطل بنية تحتية لدينا، ليس شيئًا نقرتَه خطأً.
ما لن يفعله
لا يستورد بريدك الحالي. المراقبة تبدأ عند الربط.
يراقب صندوق الوارد فقط. مراقبة Gmail مسلّحة على تسمية INBOX تحديدًا.
البريد الذي يتخطى الوارد — مصفّى مباشرة إلى تسمية، أو مؤرشف فور وصوله — لا
يُرى. إن كنت تشغّل مرشحات قوية، فتحقق من أن البريد الذي تتوقع أن يعالجه الذكاء
الاصطناعي يهبط في الوارد فعلًا.
الردّ الذي ترسله أنت من Gmail لا يُحسب كإجابة. المنصة تحتسب الردود التي خرجت عبرها. أجب عن سلسلة من Gmail على هاتفك وقد تظل تظهر هنا كمنتظرة.