اتصال به Gmail

اتصال Gmail در تسکیـ دو مسیر دارد: اتصال شخصی در مرکز اپ‌ها برای معرفی حساب کاربر و اتصال فضای کاری برای دریافت امن اعلان‌های Gmail از Cloud Pub/Sub. اگر payload غنی‌شده شامل subject یا body ایمیل باشد و شناسهٔ وظیفه در آن دیده شود، همان ایمیل به وظیفه لینک می‌شود.

دامنهٔ نسخه فعلی: این نسخه روی App Center، دریافت امن Pub/Sub و لینک خودکار payloadهای غنی‌شده تمرکز دارد. Connected Search واقعی روی inbox شخصی، OAuth کامل Gmail، جستجوی ۳۶۵ روز گذشته، ابزارهای Brain/Agent برای ساخت و جستجوی draft، External Search برای Super Agentها و واکشی history/message با Gmail API در فازهای بعدی اضافه می‌شوند.

پیش از شروع

• اتصال شخصی Gmail فقط برای همان کاربر نمایش داده می‌شود و اتصال فضای کاری را نمی‌سازد.
• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Gmail فضای کاری را بسازد یا قطع کند.
• برای webhook فضای کاری باید یک Cloud Pub/Sub push subscription به endpoint تسکیـ ارسال کند.
• در Google باید Gmail API، Cloud Pub/Sub topic و مجوز publish برای سرویس gmail-api-push@system.gserviceaccount.com تنظیم شده باشد.
• اعلان رسمی Gmail معمولاً فقط emailAddress و historyId دارد؛ برای لینک خودکار، پردازش بعدی باید subject، snippet یا body ایمیل را به payload تسکیـ اضافه کند.

ساخت اتصال شخصی

1. در مرکز اپ‌ها، Gmail را باز کنید.
2. تب «شخصی» را انتخاب کنید.
3. روی «اتصال» بزنید تا اتصال شخصی در App Center ثبت شود.
4. برای حذف، از منوی اتصال شخصی گزینهٔ «قطع اتصال» را بزنید.

ساخت اتصال فضای کاری برای Pub/Sub

1. در Google Cloud، topic و push subscription برای Gmail notifications بسازید.
2. در Gmail API برای mailbox موردنظر users.watch را با topicName و در صورت نیاز labelIds اجرا کنید.
3. در مرکز اپ‌های تسکیـ، Gmail را باز کنید و تب «فضای کاری» را انتخاب کنید.
4. نشانی Gmail، Pub/Sub Secret، توکن دسترسی اختیاری و برچسب اتصال را وارد کنید.
5. در push subscription یا reverse proxy، secret را در هدر X-Taskie-Gmail-Secret یا Authorization Bearer بفرستید.

امنیت Pub/Sub: تسکیـ secret را با مقدار رمزنگاری‌شدهٔ اتصال مقایسه می‌کند. هدر secret و Authorization در رکورد تحویل وب‌هوک ذخیره نمی‌شوند.

لینک خودکار ایمیل به وظیفه

برای لینک خودکار، شناسهٔ وظیفه باید در subject، snippet، body یا task_reference payload غنی‌شده وجود داشته باشد. شکل‌های زیر پشتیبانی می‌شوند:

• TASK-12 — نوشتن مستقیم شناسه.
• #TASK-12 — با پیشوند #.
• CU-TASK-12 — با پیشوند CU-.
• #9fq2b1 — شناسهٔ هش‌شدهٔ وظیفه، فقط با پیشوند # یا CU-.

برای نمونه، ایمیلی با subject برابر TASK-81 client handoff به وظیفهٔ TASK-81 لینک می‌شود و در بخش لینک‌های متصل وظیفه دیده خواهد شد.

وضعیت وظیفه و جستجوی inbox

Gmail در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر عبارت TASK-81[Done] در ایمیل باشد، ایمیل به وظیفه لینک می‌شود اما وضعیت تغییر نمی‌کند. جستجوی مستقیم inbox، draft tools و External Search هنوز در این نسخه فعال نیستند.

مدیریت و قطع اتصال

اتصال شخصی از مرکز اپ‌ها قطع می‌شود. اتصال فضای کاری از تنظیمات یکپارچه‌سازی فضای کاری قطع می‌شود. برای توقف کامل اعلان‌های Gmail، watch را با Gmail API متوقف کنید یا push subscription مربوط را در Google Cloud غیرفعال کنید.

اشتباه‌های رایج

• انتظار جستجوی inbox بعد از ثبت اتصال شخصی؛ جستجوی واقعی Gmail هنوز در نسخه فعلی فعال نیست.
• فرستادن Pub/Sub بدون secret؛ درخواست‌های بدون secret رد می‌شوند.
• فراموش کردن تمدید users.watch؛ Gmail watch باید قبل از انقضا تمدید شود.
• انتظار جزئیات کامل ایمیل در اعلان رسمی Gmail؛ اعلان اصلی فقط emailAddress و historyId دارد.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Gmail فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

گام بعدی: اگر می‌خواهید ایمیل‌ها از طریق اتوماسیون‌های دیگر وارد شوند، راهنمای Zapier را ببینید. برای تقویم گوگل، Google Calendar را مرور کنید.