تنظیم پاسخ خارج از دفتر
ذخیرهٔ پاسخ یک نشانی یا catch-all، به‌جای هر چه پیش‌تر ذخیره شده بود.
فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.
PUT /out-of-office
ذخیرهٔ پاسخ یک نشانی یا catch-all، به‌جای هر چه پیش‌تر ذخیره شده بود.
نمونه
به settings:write نیاز دارد. address در query می‌آید، و message تنها فیلد الزامی است: متن ساده از 1 تا 10,000 نویسه.
curl -X PUT "$OE/[email protected]" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "startsAt": "2026-12-22T00:00:00Z", "endsAt": "2027-01-04T08:00:00Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back." }'{ "object": "out_of_office", "address": "[email protected]", "enabled": true, "active": true, "startsAt": "2026-12-22T00:00:00.000Z", "endsAt": "2027-01-04T08:00:00.000Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back.", "contactsOnly": false, "updatedAt": "2026-12-22T09:14:03.117Z"}startsAt را نگذارید تا همین حالا شروع شود، یا تا آغازِ پاسخی که از پیش روشن است حفظ شود، و endsAt را نگذارید یا null بدهید تا پاسخ تا وقتی خاموش شود روشن بماند. subject حداکثر 255 نویسه می‌گیرد، و اگر خالی بماند پاسخ با Re: و موضوع دریافت‌شده جواب می‌دهد. enabled: false متن را نگه می‌دارد و پاسخ را متوقف می‌کند، و contactsOnly: true فقط به مخاطبان و کسانی که فضای کاری به آن‌ها نامه نوشته پاسخ می‌دهد.
هر فرستنده برای کل دورهٔ نبودن یک بار پاسخ را می‌گیرد، درون همان رشته، از نشانی‌ای که نامه به آن رسیده است. تغییر startsAt دورهٔ تازه‌ای را شروع می‌کند که در آن به همه یک بار دیگر پاسخ داده می‌شود، و تغییر دادنِ فقط متن یا endsAt چنین نمی‌کند. بدون endsAt به هر فرستنده پس از 30 روز دوباره پاسخ داده می‌شود. پاسخ Auto-Submitted: auto-replied دارد، بدون ردیابی و بدون امضا، در ارسال‌های ماهانه شمرده می‌شود، و در رشتهٔ بی‌صداشده هم همچنان بیرون می‌رود.
نامه‌ای که به کسی هشدار نمی‌داد پاسخی نمی‌گیرد: هرزنامه، نامه‌ای که یک قاعده به سطل زباله برده، خبرنامه‌ها و دیگر نامه‌های انبوه، نامه‌های خودکار، پیام‌های برگشتی، فرستنده‌های مسدودشده و نشانی‌های خود فضای کاری. اول پاسخی اعمال می‌شود که برای دقیقاً همان نشانی ذخیره شده، بعد پاسخ نشانیِ بدون تگ بعلاوه‌اش، بعد پاسخ catch-all، و یک catch-all هرگز به جای نشانی‌ای که کسی دستی ساخته پاسخ نمی‌دهد.
422 invalid_parameter یعنی address داده نشده، نشانی‌ای از فضای کاری نیست یا کل یک دامنه را نام می‌برد، پیام خالی است، یا endsAt پس از startsAt نیست یا از پیش گذشته است. هیچ چیز با زمان‌سنج اجرا نمی‌شود: تاریخ‌ها هنگام رسیدن نامه بررسی می‌شوند.