واتساپ

Webhook (سفارش جدید)
  → Set (آماده‌سازی داده)
  → WhatsApp (sendTemplate)
    PhoneNumberId: YOUR_PHONE_ID
    To: {{$json.customerPhone}}
    TemplateName: order_confirmation
    LanguageCode: fa
    Components: [
      {type: "body", parameters: [
        {type: "text", text: "{{$json.orderId}}"},
        {type: "text", text: "{{$json.totalAmount}} تومان"},
        {type: "text", text: "{{$json.estimatedDelivery}}"}
      ]}
    ]

Webhook (پیام واتساپ دریافتی)
  → WhatsApp (markAsRead)
    MessageId: {{$json.messageId}}
  → Switch (بررسی محتوای پیام)
    Case "سلام/شروع":
      → WhatsApp (sendInteractiveButtons)
        BodyText: "سلام! به پشتیبانی خوش آمدید. چه کاری می‌توانم انجام دهم؟"
        Buttons: [
          {id: "track_order", title: "پیگیری سفارش"},
          {id: "products", title: "لیست محصولات"},
          {id: "human_support", title: "ارتباط با پشتیبانی"}
        ]
    Case "track_order":
      → MySQL (جستجوی سفارش)
      → WhatsApp (sendTextMessage)
        Text: "سفارش شما: {{$json.status}}"
    Default:
      → OpenAI (Chat)
      → WhatsApp (sendTextMessage)

Schedule (هر ساعت)
  → MySQL (نوبت‌های فردا)
  → Loop
    → WhatsApp (sendTemplate)
      TemplateName: appointment_reminder
      Components: [
        {type: "body", parameters: [
          {type: "text", text: "{{$json.patientName}}"},
          {type: "text", text: "{{$json.doctorName}}"},
          {type: "text", text: "{{$json.appointmentTime}}"}
        ]}
      ]
    → Wait (500ms)

Webhook (پرداخت موفق)
  → HTTP Request (دریافت PDF فاکتور)
  → WhatsApp (uploadMedia)
    File: Binary PDF
    MimeType: application/pdf
  → WhatsApp (sendDocument)
    To: {{$json.customerPhone}}
    DocumentUrl: {{$json.mediaId}}
    Filename: "فاکتور-{{$json.invoiceId}}.pdf"
    Caption: "فاکتور خرید شما - مبلغ: {{$json.amount}} تومان"

Webhook (درخواست کاتالوگ)
  → MySQL (دسته‌بندی محصولات)
  → Code (ساخت ساختار لیست)
  → WhatsApp (sendInteractiveList)
    BodyText: "محصولات ما را مشاهده کنید:"
    ButtonText: "مشاهده محصولات"
    Sections: [
      {
        title: "لوازم الکترونیکی",
        rows: [
          {id: "p1", title: "گوشی سامسونگ", description: "12,500,000 تومان"},
          {id: "p2", title: "لپ‌تاپ ایسوس", description: "28,000,000 تومان"}
        ]
      },
      {
        title: "لوازم جانبی",
        rows: [
          {id: "p3", title: "هدفون بلوتوثی", description: "850,000 تومان"},
          {id: "p4", title: "پاوربانک", description: "450,000 تومان"}
        ]
      }
    ]

Webhook (بروزرسانی وضعیت ارسال)
  → Switch (وضعیت)
    Case "shipped":
      → WhatsApp (sendTemplate)
        TemplateName: order_shipped
    Case "out_for_delivery":
      → WhatsApp (sendTextMessage)
        Text: "مرسوله شما در حال تحویل است."
      → WhatsApp (sendLocation)
        Latitude: {{$json.driverLat}}
        Longitude: {{$json.driverLng}}
        Name: "موقعیت پیک"
    Case "delivered":
      → WhatsApp (sendInteractiveButtons)
        BodyText: "سفارش تحویل داده شد. از خرید شما ممنونیم!"
        Buttons: [
          {id: "rate", title: "امتیاز دهید"},
          {id: "issue", title: "مشکلی دارم"}
        ]

Schedule (شنبه ساعت 10 صبح)
  → MySQL (مشتریان فعال با رضایت بازاریابی)
  → Loop
    → WhatsApp (sendTemplate)
      TemplateName: weekly_promotion
      Components: [
        {type: "header", parameters: [
          {type: "image", image: {link: "https://example.com/promo.jpg"}}
        ]},
        {type: "body", parameters: [
          {type: "text", text: "{{$json.customerName}}"},
          {type: "text", text: "20%"},
          {type: "text", text: "PROMO20"}
        ]},
        {type: "button", sub_type: "url", index: 0,
          parameters: [{type: "text", text: "winter-sale"}]
        }
      ]
    → Wait (1 second)  // رعایت Rate Limit
  → MySQL (لاگ ارسال)

Webhook (پیام واتساپ)
  → WhatsApp (markAsRead)
  → IF (پیام متنی)
    → OpenAI (Chat)
      System: "تو دستیار فارسی‌زبان فروشگاه آنلاین هستی.
      پاسخ‌ها باید کوتاه و مفید باشند.
      اگر نمی‌دانی، بگو به پشتیبانی انسانی وصل می‌کنی."
      User: {{$json.text}}
      Temperature: 0.3
    → WhatsApp (sendTextMessage)
      Text: {{$json.response}}
  → IF (تصویر)
    → WhatsApp (getMediaUrl)
    → WhatsApp (downloadMedia)
    → OpenAI (Vision)
    → WhatsApp (sendTextMessage)

Schedule (هر شب)
  → MySQL (خریدهای ۲ روز قبل بدون نظرسنجی)
  → Loop
    → WhatsApp (sendInteractiveButtons)
      BodyText: "{{$json.name}} عزیز، از خرید محصول {{$json.product}} چقدر راضی هستید؟"
      Buttons: [
        {id: "rate_5", title: "عالی بود"},
        {id: "rate_3", title: "معمولی بود"},
        {id: "rate_1", title: "ناراضی هستم"}
      ]
    → Wait (500ms)

Webhook (پاسخ دکمه)
  → MySQL (ذخیره نظرسنجی)
  → IF (rate_1)
    → WhatsApp (sendTextMessage)
      Text: "متأسفیم. لطفاً مشکل خود را شرح دهید تا پیگیری کنیم."
    → MySQL (ایجاد تیکت پشتیبانی)

Webhook (پیام /order)
  → WhatsApp (sendInteractiveList)
    BodyText: "دسته مورد نظر را انتخاب کنید:"
    ButtonText: "مشاهده دسته‌ها"
    Sections: [محصولات]

Webhook (انتخاب محصول)
  → MySQL (اطلاعات محصول)
  → WhatsApp (sendImage)
    ImageUrl: {{$json.imageUrl}}
    Caption: "{{$json.name}}\nقیمت: {{$json.price}} تومان\n\nبرای سفارش عدد بفرستید"

Webhook (تعداد)
  → MySQL (ثبت سفارش)
  → WhatsApp (sendTextMessage)
    Text: "سفارش ثبت شد!\nکد پیگیری: {{$json.orderId}}"

Schedule (هر شب ساعت 23)
  → MySQL (آمار فروش روز)
  → Code (فرمت فارسی)
  → WhatsApp (sendTextMessage)
    To: MANAGER_PHONE
    Text: "📊 گزارش فروش امروز\n\nتعداد سفارش: {{$json.orders}}\nمبلغ کل: {{$json.total}} تومان\nمیانگین: {{$json.avg}} تومان\nپرفروش‌ترین: {{$json.topProduct}}"

Webhook (درخواست OTP)
  → Code (تولید کد 6 رقمی)
  → Redis (ذخیره کد با TTL 5 دقیقه)
  → WhatsApp (sendTemplate)
    TemplateName: otp_verification
    Components: [
      {type: "body", parameters: [
        {type: "text", text: "{{$json.otpCode}}"}
      ]},
      {type: "button", sub_type: "url", index: 0,
        parameters: [{type: "text", text: "{{$json.otpCode}}"}]
      }
    ]

ایران: 989121234567 (نه 09121234567 یا +989121234567)
   ترکیه: 905321234567
   امارات: 971501234567

// متن Template در Meta Business Suite:
   "{{1}} عزیز، سفارش شماره {{2}} با موفقیت ثبت شد.
   مبلغ: {{3}} تومان
   زمان تحویل: {{4}}"

   // ارسال در n8n:
   Components: [{
     type: "body",
     parameters: [
       {type: "text", text: customerName},
       {type: "text", text: orderId},
       {type: "text", text: amount},
       {type: "text", text: deliveryDate}
     ]
   }]

Webhook (پیام دریافتی)
     → MySQL (ذخیره lastMessageAt = NOW())
     → ادامه workflow...

   // قبل از ارسال:
   MySQL (بررسی lastMessageAt)
     → IF (NOW() - lastMessageAt < 24h)
       → پیام آزاد (Text, Image, ...)
     → ELSE
       → Template Message

{
     "type": "button",
     "body": {"text": "سفارش شما آماده است. تأیید می‌کنید؟"},
     "action": {
       "buttons": [
         {"type": "reply", "reply": {"id": "confirm", "title": "تأیید"}},
         {"type": "reply", "reply": {"id": "cancel", "title": "لغو"}},
         {"type": "reply", "reply": {"id": "change", "title": "تغییر آدرس"}}
       ]
     }
   }

{
     "type": "list",
     "body": {"text": "دسته‌بندی مورد نظر را انتخاب کنید:"},
     "action": {
       "button": "انتخاب دسته",
       "sections": [{
         "title": "محصولات",
         "rows": [
           {"id": "cat_1", "title": "موبایل", "description": "گوشی و تبلت"},
           {"id": "cat_2", "title": "لپ‌تاپ", "description": "نوت‌بوک و PC"}
         ]
       }]
     }
   }

WhatsApp (sendImage)
     ImageUrl: "https://example.com/product.jpg"
     Caption: "*محصول جدید*\n\nنام: {{$json.name}}\nقیمت: {{$json.price}} تومان\n\nبرای خرید عدد 1 ارسال کنید"

// تأیید امضای Webhook Meta:
   Code Node:
   const crypto = require('crypto');
   const signature = $headers['x-hub-signature-256'];
   const expected = 'sha256=' + crypto
     .createHmac('sha256', APP_SECRET)
     .update(JSON.stringify($json))
     .digest('hex');
   if (signature !== expected) throw new Error('Invalid signature');

Webhook (Status Update)
     → Switch (status)
       Case "sent": MySQL (وضعیت: ارسال شد)
       Case "delivered": MySQL (وضعیت: تحویل شد)
       Case "read": MySQL (وضعیت: خوانده شد)
       Case "failed": Telegram (هشدار خطا)

پیام متنی: 4096 کاراکتر
    Caption: 1024 کاراکتر
    دکمه‌های تعاملی: حداکثر 3 عدد
    آیتم لیست: حداکثر 10 در هر بخش
    بخش‌های لیست: حداکثر 10 بخش
    عکس: 5 مگابایت
    ویدیو: 16 مگابایت
    صوت: 16 مگابایت
    فایل: 100 مگابایت
    Reaction: فقط یک اموجی
    Template نام: حداکثر 512 کاراکتر

Tier 1: 1,000 مخاطب یکتا / 24 ساعت
    Tier 2: 10,000 مخاطب یکتا / 24 ساعت
    Tier 3: 100,000 مخاطب یکتا / 24 ساعت
    Tier 4: نامحدود

    // افزایش Tier:
    - Quality Rating بالا نگه دارید
    - حجم ارسال را تدریجی افزایش دهید
    - 2 برابر Tier فعلی ارسال کنید تا ارتقا دهند

Marketing: پروموشن، تخفیف، اخبار
      → نیاز به Opt-in کاربر
      → ممکن است توسط Meta محدود شود

    Utility: اعلان سفارش، تحویل، تأیید
      → بدون نیاز به Opt-in
      → Rate Limit بالاتر

    Authentication: OTP و تأیید هویت
      → بدون نیاز به Opt-in
      → اولویت بالا در ارسال

// ابتدا آپلود و ذخیره Media ID
    WhatsApp (uploadMedia)
      → MySQL (ذخیره: file_hash → media_id)

    // استفاده مکرر بدون آپلود مجدد
    MySQL (بررسی media_id)
      → IF (موجود) → WhatsApp (sendImage با media_id)
      → ELSE → Upload → WhatsApp (sendImage)

Loop (لیست مخاطبین)
      → WhatsApp (sendTemplate)
        → On Error:
          → IF (429 Rate Limit)
            → Wait (30 seconds) → Retry
          → IF (400 Invalid Number)
            → MySQL (علامت شماره نامعتبر)
          → IF (131026 Outside Window)
            → Queue (صف ارسال Template بعدی)
          → Default:
            → Telegram (هشدار ادمین)
            → MySQL (لاگ خطا)

IF (lastMessageTime + 24h > now)
    → WhatsApp (sendTextMessage)   // پیام آزاد
  ELSE
    → WhatsApp (sendTemplate)      // فقط Template

{
    "type": "body",
    "parameters": [
      {"type": "text", "text": "مقدار اول"},
      {"type": "text", "text": "مقدار دوم"}
    ]
  }