کلیک‌آپ

Workspace (فضای کاری - سازمان)
  └── Space (فضا - تیم یا دپارتمان)
       └── Folder (پوشه - پروژه یا دسته‌بندی) [اختیاری]
            └── List (لیست - مجموعه تسک‌ها)
                 └── Task (تسک - واحد کار)
                      └── Subtask (زیرتسک)
                           └── Checklist (چک‌لیست)

Webhook (ثبت‌نام مشتری جدید از CRM)
  -> ClickUp (folder-create)
    Space: "Client Projects"
    Name: "{{$json.companyName}}"
  -> ClickUp (list-create)
    Folder: folder ایجاد شده
    Name: "Phase 1 - Discovery"
  -> ClickUp (list-create)
    Name: "Phase 2 - Design"
  -> ClickUp (list-create)
    Name: "Phase 3 - Development"
  -> ClickUp (task-create - در لیست Phase 1)
    Name: "جلسه معرفی و شناخت نیازها"
    Assignee: مدیر پروژه
    Due Date: یک هفته بعد
  -> ClickUp (task-create)
    Name: "تحلیل نیازمندی‌ها و مستندسازی"
  -> ClickUp (checklist-create)
    Name: "مراحل Onboarding"
  -> ClickUp (checklist-item-create)
    Items: ["ارسال خوش‌آمدگویی", "تنظیم دسترسی‌ها", "جلسه Kickoff", "تحویل Timeline"]
  -> Email (ارسال خوش‌آمدگویی به مشتری)

Email Trigger (ایمیل جدید با label "task")
  -> ClickUp (task-create)
    List: "Inbox"
    Name: "\[Email] ${subject}"
    Description: "از: ${from}\n---\n${body}"
    Priority: 3 (Normal)
    Due Date: 7 روز بعد
  -> IF (ایمیل از مشتری VIP)
    -> ClickUp (task-update)
      Priority: 1 (Urgent)
    -> ClickUp (tag-add: "vip-client")
  -> IF (ایمیل دارای پیوست)
    -> ClickUp (comment-create)
      Text: "پیوست‌های ایمیل: [${attachment.name}]"
  -> ClickUp (comment-create)
    Text: "تسک از ایمیل ایجاد شده - \[مشاهده ایمیل اصلی]"

Schedule (هر ۲ هفته - شنبه ساعت ۹)
  -> ClickUp (list-create)
    Space: "Engineering"
    Name: "Sprint ${sprintNumber} - ${startDate}"
  -> ClickUp (task-list)
    List: "Backlog"
    Statuses: ["Ready for Sprint"]
    Order By: priority
  -> Loop (حداکثر ۱۵ تسک)
    -> ClickUp (task-update)
      Move to: لیست Sprint جدید
      Status: "To Do"
  -> ClickUp (task-create - Sprint Summary)
    Name: "Sprint ${sprintNumber} Goals"
    Description: "تعداد تسک: ${count}\nمجموع تخمین: ${totalEstimate}"
  -> Telegram (اعلان شروع Sprint به تیم)
  -> Slack (ارسال Sprint Goals به کانال #engineering)

Schedule (آخر هر هفته - پنج‌شنبه ساعت ۱۸)
  -> ClickUp (time entries - این هفته)
  -> Code (محاسبه آمار)
    - مجموع ساعات هر عضو تیم
    - زمان Billable vs Non-billable
    - پروژه‌هایی با بیشترین زمان
    - میانگین ساعات روزانه
  -> Google Sheets (ذخیره گزارش هفتگی)
  -> Code (ساخت گزارش مدیریتی)
  -> Email (ارسال گزارش به مدیر)
  -> Telegram (ارسال خلاصه به کانال تیم)

ClickUp Trigger (تغییر وضعیت تسک)
  -> IF (Tag = "client-visible")
    -> IF (Status = "complete")
      -> ClickUp (task-get: دریافت جزئیات)
      -> Email (ارسال به مشتری)
        Subject: "به‌روزرسانی پروژه: ${taskName} تکمیل شد"
        Body: "با سلام، مرحله ${taskName} از پروژه شما تکمیل شده..."
      -> ClickUp (comment-create)
        Text: "اعلان به مشتری ارسال شد"
    -> IF (Status = "blocked")
      -> Telegram (هشدار به مدیر پروژه)
      -> ClickUp (task-update: Priority = Urgent)

GitHub Trigger (Pull Request)
  -> Code (استخراج Task ID از branch name: feature/CU-abc123-add-login)
  -> IF (action = opened)
    -> ClickUp (task-update)
      Status: "In Review"
    -> ClickUp (comment-create)
      Text: "PR ایجاد شد: ${prUrl}\nBranch: ${branchName}"
  -> IF (action = closed AND merged)
    -> ClickUp (task-update)
      Status: "Done"
    -> ClickUp (comment-create)
      Text: "PR merge شد. Ready for QA."
    -> ClickUp (time-entry-create)
      Description: "Development completed"

Webhook (گزارش باگ از فرم وبسایت / Sentry / Grafana)
  -> ClickUp (task-create)
    List: "Bug Reports"
    Name: "[Bug] ${title}"
    Description: "\n**گزارش‌دهنده:** ${reporter}\n**محیط:** ${environment}\n**مرورگر:** ${browser}\n**توضیحات:** ${description}\n**مراحل بازتولید:**\n${steps}"
    Priority: بر اساس severity
    Tags: ["bug", "${severity}"]
  -> ClickUp (checklist-create)
    Name: "Bug Fix Checklist"
  -> ClickUp (checklist-item-create)
    Items: ["بازتولید باگ", "شناسایی Root Cause", "نوشتن Fix", "نوشتن Unit Test", "Code Review", "QA Testing", "Deploy"]
  -> ClickUp (custom-field-set)
    Field: "Severity"
    Value: "${severity}"
  -> IF (severity = critical)
    -> ClickUp (task-update: Priority = 1)
    -> Telegram (هشدار فوری به تیم)
    -> Slack (alert به #incidents)

Webhook (رزومه جدید از فرم)
  -> ClickUp (task-create)
    List: "Candidates"
    Name: "${candidateName} - ${position}"
    Description: "ایمیل: ${email}\nموبایل: ${phone}\nسابقه: ${experience} سال"
    Tags: ["${position}", "${source}"]
  -> ClickUp (custom-field-set)
    Field: "Position": "${position}"
    Field: "Experience": ${years}
    Field: "Source": "${source}"
  -> ClickUp (checklist-create: "Hiring Pipeline")
  -> ClickUp (checklist-item-create)
    Items: ["بررسی رزومه", "تماس اولیه HR", "تست فنی", "مصاحبه فنی", "مصاحبه فرهنگی", "بررسی رفرنس", "ارسال پیشنهاد"]
  -> ClickUp (comment-create)
    Text: "کاندید جدید از طریق ${source} ثبت شد"
  -> Email (تایید دریافت رزومه به کاندید)

Schedule (هر روز صبح ساعت ۹)
  -> ClickUp (task-list)
    List: "Content Calendar"
    Due Date: امروز
    Status: "Ready to Publish"
  -> Loop (تسک‌های آماده انتشار)
    -> ClickUp (task-get: جزئیات محتوا)
    -> IF (Tag = "blog")
      -> WordPress (انتشار پست)
      -> ClickUp (task-update: Status = "Published")
    -> IF (Tag = "telegram")
      -> Telegram (ارسال به کانال)
      -> ClickUp (task-update: Status = "Published")
    -> IF (Tag = "social")
      -> Twitter / Instagram API (انتشار)
    -> ClickUp (comment-create)
      Text: "محتوا منتشر شد - ${platforms}"
    -> ClickUp (time-entry-create)
      Description: "Content publishing"

Schedule (هر روز ساعت ۸ صبح)
  -> ClickUp (task-list)
    List: "Client Tasks"
    Due Date < فردا
    Status != "complete"
  -> Loop
    -> IF (Due Date = امروز)
      -> Telegram (هشدار: "تسک '${name}' امروز ددلاین دارد!")
      -> ClickUp (comment-create)
        Text: "یادآوری: ددلاین امروز!"
    -> IF (Due Date < امروز - Overdue)
      -> ClickUp (task-update: Priority = 1 Urgent)
      -> ClickUp (tag-add: "overdue")
      -> Email (هشدار به مدیر پروژه)
      -> Slack (alert به کانال #deadlines)
  -> Code (خلاصه وضعیت: تعداد overdue, at risk, on track)
  -> Telegram (گزارش وضعیت به مدیر)

ClickUp Trigger (تسک جدید با Due Date)
  -> IF (Due Date موجود)
    -> Google Calendar (ایجاد رویداد)
      Title: "[ClickUp] ${taskName}"
      Date: ${dueDate}
      Description: "Link: ${taskUrl}\nAssignee: ${assignee}\nPriority: ${priority}"
    -> ClickUp (comment-create)
      Text: "رویداد تقویم ایجاد شد"

ClickUp Trigger (تغییر Due Date)
  -> Google Calendar (ویرایش رویداد)
    Date: ${newDueDate}

Schedule (جمعه ساعت ۱۷)
  -> ClickUp (task-list: Status = "complete", Updated This Week)
  -> ClickUp (task-list: Status = "in progress")
  -> ClickUp (task-list: Status = "blocked")
  -> Code (محاسبه آمار)
    - تسک‌های تکمیل شده: ${doneCount}
    - در حال انجام: ${progressCount}
    - مسدود شده: ${blockedCount}
    - مجموع ساعات Time Tracking
    - بهره‌وری هر عضو تیم
  -> Telegram (گزارش هفتگی)
  -> Google Sheets (ذخیره آمار)
  -> Notion (ایجاد صفحه گزارش هفتگی)

Workspace (سازمان)
  Space (تیم/دپارتمان - مثل: Engineering, Marketing, HR)
    Folder (پروژه - اختیاری)
      List (مجموعه تسک - مثل: Sprint 1, Backlog, In Progress)
        Task (واحد کار)
          Subtask (زیرتسک)
            Checklist (چک‌لیست)
              Checklist Item (آیتم چک‌لیست)

// Team (Workspace) ID:
GET /api/v2/team

// Space ID:
GET /api/v2/team/{team_id}/space

// Folder ID:
GET /api/v2/space/{space_id}/folder

// List ID:
GET /api/v2/folder/{folder_id}/list
// یا Folderless:
GET /api/v2/space/{space_id}/list

// Task ID از URL:
https://app.clickup.com/t/abc123xyz -> Task ID: abc123xyz

// Member IDs:
GET /api/v2/team/{team_id}/member

// دریافت وضعیت‌های یک لیست
GET /api/v2/list/{listId}
-> statuses: [
    {"status": "to do", "type": "open", "color": "#d3d3d3"},
    {"status": "in progress", "type": "custom", "color": "#4194f6"},
    {"status": "review", "type": "custom", "color": "#a875ff"},
    {"status": "complete", "type": "done", "color": "#6bc950"},
    {"status": "closed", "type": "closed", "color": "#6bc950"}
  ]

// دریافت Custom Fields یک لیست:
GET /api/v2/list/{listId}/field

// تنظیم مقدار:
POST /api/v2/task/{taskId}/field/{fieldId}

// فرمت مقادیر:
Text/Short Text: {"value": "متن"}
Number: {"value": 42}
Money/Currency: {"value": 50000}
Dropdown: {"value": "option_orderindex"} // UUID گزینه
Date: {"value": 1704067200000, "value_options": {"time": true}}
Checkbox: {"value": true}
Rating: {"value": 4}
Labels: {"value": ["label_uuid_1"]}
Email: {"value": "test@example.com"}
Phone: {"value": "+989121234567"}
Location: {"value": {"location": {"lat": 35.6892, "lng": 51.3890}, "formatted_address": "Tehran"}}

// اضافه کردن وابستگی
POST /api/v2/task/{taskId}/dependency
{
  "depends_on": "other_task_id",  // این تسک منتظر تسک دیگر است
  "dependency_of": "other_task_id"  // تسک دیگر منتظر این تسک است
}

// Blocking: تسک A باید قبل از تسک B تکمیل شود
// Waiting On: تسک B منتظر تکمیل تسک A است
// Linked: تسک‌ها مرتبط هستند (بدون ترتیب)

// تخمین زمان (در میلی‌ثانیه)
1 ساعت = 3600000
30 دقیقه = 1800000
1 روز (8 ساعت) = 28800000

// ثبت Time Entry:
POST /api/v2/team/{team_id}/time_entries
{
  "tid": "task_id",
  "start": 1704067200000,  // Unix timestamp ms
  "duration": 7200000,     // 2 ساعت
  "description": "کدنویسی API",
  "billable": true,
  "tags": [{"name": "development"}]
}

// شروع تایمر:
POST /api/v2/team/{team_id}/time_entries/start
{"tid": "task_id", "description": "شروع کار"}

// توقف تایمر:
POST /api/v2/team/{team_id}/time_entries/stop

**Bold** / *Italic* / ~~Strikethrough~~
[Link](https://example.com)
- لیست نامرتب
1. لیست مرتب
> نقل قول
\`کد inline\`
\`\`\`
بلوک کد
\`\`\`
| جدول | ستون |
|-------|------|
| مقدار | مقدار |
/mention @username

ClickUp (task-list: لیست تسک‌ها)
  -> Split In Batches (batch size: 10)
  -> Loop
    -> ClickUp (عملیات روی تسک)
    -> Wait (700ms)  // رعایت rate limit (100 req/min)
  -> Merge Results

GET /api/v2/list/{listId}/task?
  archived=false&
  page=0&
  order_by=due_date&
  reverse=false&
  subtasks=true&
  statuses[]=in%20progress&
  statuses[]=to%20do&
  assignees[]=12345678&
  due_date_gt=1704067200000&
  due_date_lt=1706745600000&
  tags[]=urgent&
  include_closed=false

// Goals ساختار OKR دارند:
Goal (هدف بلندمدت)
  └── Key Result / Target (نتیجه کلیدی)

// دریافت Goals:
GET /api/v2/team/{team_id}/goal

// هر Goal شامل Targets است که می‌تواند:
- Number: رسیدن به عدد مشخص (مثل: ۱۰۰ مشتری)
- Percentage: درصد پیشرفت
- Currency: مبلغ درآمد
- True/False: انجام شد / نشد
- Task: تکمیل تسک‌های مشخص
- List: تکمیل تمام تسک‌های یک لیست

// اضافه کردن Tag به تسک:
POST /api/v2/task/{task_id}/tag/{tag_name}

// حذف Tag:
DELETE /api/v2/task/{task_id}/tag/{tag_name}

// کاربرد در workflow:
ClickUp Trigger (Tag Added: "needs-review")
  -> Telegram (اعلان به reviewer)
  -> ClickUp (task-update: Assignee = reviewer)

ClickUp Trigger (Tag Added: "approved")
  -> ClickUp (task-update: Status = "Ready for Deploy")
  -> ClickUp (tag-add: "ready-to-deploy")

// Folderless List: لیست مستقیم در Space
POST /api/v2/space/{space_id}/list
{"name": "Quick Tasks"}  // بدون Folder - ساده‌تر

// Folder List: لیست داخل Folder
POST /api/v2/folder/{folder_id}/list
{"name": "Sprint 1"}  // داخل Folder - سازماندهی بهتر

// توصیه: از Folder برای پروژه‌های بزرگ و از Folderless برای لیست‌های عمومی استفاده کنید

// در ایجاد تسک:
{"assignees": [12345678, 87654321]}

// در ویرایش تسک (اضافه/حذف):
{
  "assignees": {
    "add": [12345678],
    "rem": [87654321]
  }
}

ClickUp: مدیریت پروژه جامع، Custom Fields قوی، Time Tracking داخلی
Jira: توسعه نرم‌افزار، Sprint/Scrum پیشرفته، JQL
Trello: Kanban ساده، یادگیری آسان
Notion: مستندات + دیتابیس، ویکی تیمی
Asana: مدیریت وظایف، Timeline View

نکته: n8n می‌تواند داده‌ها را بین همه این ابزارها همگام‌سازی کند!

// فعال کردن: Space Settings > Custom Task IDs
// فرمت: PREFIX-NUMBER (مثل: DEV-001)

// استفاده در API:
GET /api/v2/task/DEV-001?custom_task_ids=true&team_id=123456

Webhook (نوع درخواست)
  -> Switch
    -> type = "bug_report":
      -> ClickUp (task-create)
        Name: "[Bug] ${title}"
        Description: Template باگ
        Priority: 2 (High)
        Tags: ["bug"]
      -> ClickUp (checklist-create: "QA Steps")
    -> type = "feature_request":
      -> ClickUp (task-create)
        Name: "[Feature] ${title}"
        Description: Template فیچر
        Priority: 3 (Normal)
        Tags: ["feature-request"]
      -> ClickUp (checklist-create: "Definition of Done")
    -> type = "onboarding":
      -> ClickUp (task-create)
        Name: "[Onboarding] ${clientName}"
        Tags: ["onboarding"]
      -> ClickUp (checklist-create: "Onboarding Steps")
      -> ClickUp (checklist-item-create: items...)

از URL: https://app.clickup.com/t/abc123xyz
  از API: GET /api/v2/list/{listId}/task

Loop -> ClickUp -> Wait (700ms) -> Next

Retry on Fail: ON
  Max Tries: 3
  Wait Between: 5000ms

صحیح: 1704067200000
  نادرست: "2024-01-01"
  نادرست: 1704067200 (ثانیه بدون میلی‌ثانیه)

GET /api/v2/list/{listId}
  -> statuses: [{"status": "to do", "type": "open"}, {"status": "in progress", "type": "custom"}, ...]

Text: {"value": "متن"}
  Number: {"value": 42}
  Dropdown: {"value": "option_uuid"} (UUID گزینه، نه متن)
  Date: {"value": 1704067200000} (Unix timestamp ms)
  Checkbox: {"value": true}
  Email: {"value": "user@example.com"}
  Phone: {"value": "+989121234567"}
  URL: {"value": "https://example.com"}
  Currency: {"value": 50000}
  Labels: {"value": ["label_uuid_1", "label_uuid_2"]}

GET /api/v2/team/{team_id}/webhook

GET /api/v2/team/{team_id}/member
  -> [{"user": {"id": 12345678, "username": "john", "email": "john@example.com"}}]