اتصال به Zapier

اتصال Zapier در تسکیـ یک ورودی امن برای Zapها فراهم می‌کند. هر Zap می‌تواند با Webhooks by Zapier یا Custom Request یک payload به تسکیـ بفرستد و اگر payload شامل شناسهٔ وظیفه باشد، اجرای همان Zap به وظیفه لینک می‌شود.

دامنهٔ نسخه فعلی: این نسخه یک webhook bridge ورودی است. اپ رسمی Zapier با OAuth، triggerهای Taskie، actionهای ساخت/ویرایش وظیفه، find stepها، triggerهای polling/rest-hook و مدیریت Zapها از داخل تسکیـ در فازهای بعدی اضافه می‌شوند.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Zapier فضای کاری را بسازد یا قطع کند.
• در تسکیـ برای اتصال یک شناسهٔ حساب Zapier و یک Webhook Secret ثبت می‌کنید.
• در Zapier باید همان شناسه را در هدر X-Zapier-Account-ID و همان secret را در هدر X-Taskie-Zapier-Secret یا Authorization Bearer بفرستید.
• Secret در رکورد تحویل وب‌هوک ذخیره نمی‌شود و نباید در payload قرار بگیرد.
• این اتصال برای ساخت مستقیم وظیفه از Zap نیست؛ فعلاً اجرای Zap را به وظیفه‌های موجود لینک می‌کند.

ساخت اتصال فضای کاری

1. در مرکز اپ‌های تسکیـ، Zapier را باز کنید و تب «فضای کاری» را انتخاب کنید.
2. یک Account ID پایدار مثل zapier-team-123 وارد کنید.
3. یک Webhook Secret قوی بسازید و در فیلد secret وارد کنید.
4. در Zapier، یک مرحلهٔ Webhooks by Zapier یا Custom Request بسازید و endpoint تسکیـ را هدف قرار دهید.
5. هدرهای X-Zapier-Account-ID، X-Taskie-Zapier-Secret، و در صورت امکان X-Zapier-Delivery و X-Zapier-Event را تنظیم کنید.

شناسه تحویل: اگر Zap شما هدر X-Zapier-Delivery بفرستد، تسکیـ از آن برای جلوگیری از ثبت تکراری تحویل استفاده می‌کند. اگر این هدر را نفرستید، تسکیـ از event_id یا شناسه‌های payload استفاده می‌کند.

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

برای لینک خودکار، شناسهٔ وظیفه را در title، description، body، message یا task_reference payload بفرستید. شکل‌های زیر پشتیبانی می‌شوند:

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

برای نمونه، payload با title برابر TASK-71 customer reply به وظیفهٔ TASK-71 لینک می‌شود و در بخش لینک‌های متصل وظیفه دیده خواهد شد.

وضعیت وظیفه و actionها

Zapier در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر عبارت TASK-71[Done] را در payload بفرستید، اجرای Zap به وظیفه لینک می‌شود اما وضعیت وظیفه تغییر نمی‌کند. اکشن‌های واقعی مثل ساخت وظیفه، افزودن کامنت، تغییر وضعیت و جستجوی وظیفه هنوز بخشی از اپ رسمی آیندهٔ Zapier هستند.

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

وضعیت اتصال و زمان آخرین رویداد در تب «یکپارچه‌سازی» تنظیمات فضای کاری دیده می‌شود. مالک یا مدیر می‌تواند اتصال را از تسکیـ قطع کند. برای توقف کامل ارسال درخواست، مرحلهٔ Webhook یا Zap مربوط را در Zapier هم غیرفعال کنید.

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

• فرستادن secret داخل payload به‌جای هدر؛ secret باید در هدر امن ارسال شود.
• فراموش کردن هدر X-Zapier-Account-ID؛ تسکیـ با این مقدار اتصال درست را پیدا می‌کند.
• انتظار ساخت وظیفهٔ جدید از Zap؛ نسخه فعلی فقط به وظیفه‌های موجود لینک می‌کند.
• ارسال نکردن شناسهٔ وظیفه در payload؛ بدون شناسه، تحویل پردازش می‌شود اما لینکی ساخته نمی‌شود.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Zapier فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

گام بعدی: برای اتصال پیام‌ها به وظایف، راهنمای Slack را ببینید. برای اتصال فایل‌ها، راهنمای Google Drive و Dropbox را مرور کنید.