# نمونه ورک‌فلو: فرم/لید → اعلان تلگرام

**سطح:** مبتدی  
**زمان تقریبی:** ۳۰–۶۰ دقیقه  
**فایل ایمپورت:** `workflow-form-to-telegram.json`  
**برند:** همیار آکادمی

---

## این ورک‌فلو چه می‌کند؟

هر بار کسی فرم لید را پر کند:

1. n8n درخواست را از **Webhook** می‌گیرد  
2. متن فارسی اعلان را می‌سازد  
3. همان لحظه در **تلگرام** به تو (یا گروه تیم) پیام می‌فرستد  

مناسب فریلنسر و SME ایرانی برای پیگیری سریع سرنخ — بدون اکسل دستی.

---

## چه چیزهایی باید از قبل آماده باشد؟

1. n8n بالا باشد (کلاد یا لوکال)  
2. بات تلگرام از BotFather + توکن  
3. Chat ID مقصد اعلان  
4. یک فرم که بتواند POST به URL وب‌هوک بزند  

---

## مراحل دستی (اگر ایمپورت کار نکرد)

### گام ۱ — نود Webhook
- نوع: **Webhook**
- Method: `POST`
- Path: مثلاً `hamyar-lead`
- Response: `Immediately` (یا When Last Node Finishes)

بعد از Active شدن، URL عمومی را کپی کن (Production URL).

### گام ۲ — نود Set (اختیاری ولی مفید)
فیلدهای ورودی را به نام‌های ثابت نگاشت کن، مثلاً:

| نام خروجی | مقدار نمونه |
|---|---|
| `leadName` | `{{$json.body.name}}` یا `{{$json.name}}` |
| `leadContact` | `{{$json.body.phone}}` یا ایمیل |
| `leadMessage` | `{{$json.body.message}}` |

بسته به فرم، داده گاهی داخل `body` است، گاهی در ریشهٔ JSON.

### گام ۳ — نود Telegram
- Resource: Message  
- Operation: Send Message  
- Chat ID: شناسهٔ خودت/گروه  
- Text (نمونه):

```text
🆕 لید جدید — همیار Starter

نام: {{$json.leadName}}
تماس: {{$json.leadContact}}
پیام: {{$json.leadMessage}}

منبع: free-n8n-starter
```

- Credential تلگرام را وصل کن.

### گام ۴ — اتصال و فعال‌سازی
Webhook → Set → Telegram را به هم وصل کن، Save، سپس **Active**.

### گام ۵ — تست
با `curl` یا ارسال واقعی فرم:

```bash
curl -X POST 'https://YOUR-N8N-HOST/webhook/hamyar-lead' \
  -H 'Content-Type: application/json' \
  -d '{"name":"علی تست","phone":"0912xxxxxxx","message":"درخواست مشاوره اتوماسیون"}'
```

در Executions باید سبز باشد و پیام در تلگرام بیاید.

---

## تنظیمات مهم بعد از ایمپورت JSON

1. Credential تلگرام را دوباره انتخاب کن (رمزها داخل فایل نیستند).  
2. Chat ID را با مقدار واقعی عوض کن.  
3. اگر Form Trigger داری و Webhook نمی‌خواهی: نود اول را با **n8n Form Trigger** عوض کن و فیلدها را هم‌نام نگه دار.  
4. URL وب‌هوک را در فرم سایت/لندینگ قرار بده.  
5. برای وردپرس: فرم را به همان Production Webhook اشاره بده؛ Test URL فقط برای آزمایش است.

---

## خطاهای رایج

| علامت | احتمال |
|---|---|
| هیچ اجرایی نیست | ورک‌فلو Active نیست یا URL اشتباه است |
| ۴۰۳/۴۰۴ وب‌هوک | Path یا دامنه n8n اشتباه است |
| خطای Telegram credential | توکن باطل یا Credential وصل نشده |
| پیام خالی | مسیر expression فیلدها با JSON واقعی جور نیست — یک بار Raw JSON را در Execution ببین |

---

## گام بعدی (نرم)

همین الگو را برای «ثبت‌نام وبینار» تکرار کن و در وبینار رایگان همیار جزئیات بیشتری بپرس:  
https://hamyar.co/ai-webinar/

بعداً می‌توانی SMS یا زرین‌پال را روی همین اسکلت اضافه کنی — در دورهٔ تخصصی N8N همیار عمیق‌تر کار می‌شود.

---

## دربارهٔ فایل JSON

`workflow-form-to-telegram.json` یک اسکلت سازگار با ایمپورت n8n است (Webhook + Set + Telegram).  
بعد از ایمپورت حتماً Credential و Chat ID را دستی تنظیم کن. اگر نسخهٔ n8nت typeVersion متفاوت داشت، نودها را نگه دار و پارامترها را از UI دوباره ست کن.