🌐 Webhook Trigger

Webhook Trigger-ը հնարավորություն է տալիս արտաքին համակարգերին սկսել աշխատանքային գործընթացներ SmartFlow-ում՝ API հարցումների միջոցով տվյալներ ուղարկելով։ Այս թրիգերը հիանալի է SmartFlow-ը երրորդ կողմի հավելվածների հետ ինտեգրելու համար, թույլ տալով դինամիկ և անխափան ավտոմատացում աշխատանքների։

---

📝 Trigger Details

Name: Webhook
Category: Triggers

---

🔧 Parameters

1. Webhook URL

• Type: string
• Description: Webhook-ի վերջնակետ URL, որը ստանում է եկող հարցումները։ Սա ավտոմատ կերպով ստեղծվում է յուրաքանչյուր աշխատանքային գործընթացի համար, որն օգտագործում է այս թրիգերը։
• Required: Այո
• Example:

  https://api.smartflow.com/webhooks/{workflowId}

2. Payload

• Type: object
• Description: Արտաքին համակարգի կողմից հարցման մարմնում ուղարկված տվյալները։ Այս payload-ը կարող է ներառել հարմարեցված դաշտեր՝ կախված ինտեգրումից։
• Required: Այո
• Example:

  {
    "event": "order_created",
    "orderId": "12345",
    "customer": {
      "name": "John Doe",
      "email": "john@example.com"
    }
  }

3. Headers

• Type: object
• Description: Ընտրովի գլխիկներ, որոնք արտաքին համակարգը կարող է ներառել վավերացման կամ մետադիտման նպատակներով։
• Required: Ոչ
• Example:

  {
    "Authorization": "Bearer your-api-key",
    "Content-Type": "application/json"
  }

---

🚀 How It Works

1. Webhook URL Configuration:

   • Երբ ստեղծվում է աշխատանքային գործընթաց Webhook Trigger-ով, SmartFlow ստեղծում է եզակի URL webhook-ի համար։
   • Այս URL-ը կիսեք արտաքին համակարգի հետ՝ նրանց ինտեգրումը կարգավորելու համար։

2. API Key Retrieval:

   • Գնացեք ChatModel Settings։
   • Գնացեք Integration → Web։
   • Սեղմեք Copy API Key՝ անհրաժեշտ վավերացման տոմսը ստանալու համար։

3. Payload Structure:

   • Արտաքին համակարգերը տվյալներ (payload) ուղարկում են webhook URL-ին HTTP POST հարցման միջոցով։
   • Payload-ը պետք է համապատասխանեն աշխատանքային գործընթացի պահանջվող կառուցվածքին։

4. Trigger Execution:

   • Երբ webhook-ը ստանում է վավեր հարցում, համապատասխան աշխատանքային գործընթացը ավտոմատ կերպով սկսվում է։
   • SmartFlow-ը մշակել է payload-ը, իրականացնում է սահմանված գործողությունները և անհրաժեշտության դեպքում վերադարձնում է պատասխան։

---

💡 Օգտագործման դեպքեր

1. CRM ինտեգրում:

   • Սցենար: Հաճախորդը ստեղծում է նոր հաշիվ ձեր CRM համակարգում:
   • Webhook: CRM-ը ուղարկում է POST հարցում SmartFlow-ին հաճախորդի տվյալներով:
   • Աշխատանքային գործընթաց: Ուղարկում է ողջույնի էլփոստ և ավելացնում հաճախորդին ձեր մարքեթինգային ցուցակում:

2. Պատվերի կառավարում:

   • Սցենար: Էլեկտրոնային առևտրի հարթակը մշակել է նոր պատվեր:
   • Webhook: Հարթակը ուղարկում է պատվերի տվյալները SmartFlow-ին:
   • Աշխատանքային գործընթաց: Թարմացնում է պաշարները, ուղարկում է պատվերի հաստատման էլփոստ և տեղեկացնում պահեստը:

3. Պատահարների մոնիտորինգ:

   • Սցենար: Մոնիտորինգի համակարգը հայտնաբերում է κρίական սխալ:
   • Webhook: Համակարգը ուղարկում է ծանուցում SmartFlow-ին:
   • Աշխատանքային գործընթաց: Ստեղծում է պատահարի հաշվետվություն և տեղեկացնում ինժեներական թիմին:

---

🔍 Օրինակ Կոնֆիգուրացիա

Գործող Webhook Հարցում

URL:

https://api.smartflow.com/webhooks/abc123

Payload:

{
  "event": "user_registered",
  "userId": "67890",
  "name": "Jane Doe",
  "email": "jane@example.com"
}

Headers:

{
  "Authorization": "Bearer 123456789",
  "Content-Type": "application/json"
}

---

🛠️ Լավագույն պրակտիկաներ

1. Վավերացում:

   • Վավերացրեք եկող հարցումները, որպեսզի ապահովեք տվյալների ամբողջականությունը և կանխեք չարաշահումը:
   • Օգտագործեք անվտանգ headers կամ tokens վավերացման համար:

2. API բանալու անվտանգություն:

   • Համոզվեք, որ ChatModel Settings → Integration → Web-ից ստացված API բանալին պահպանվում է անվտանգ և չի հրապարակվում հանրային:

3. Տվյալների քարտեզավորում:

   • Հստակ քարտեզեք եկող դաշտերը աշխատանքային փոփոխականներին՝ անխափան մշակման համար:

4. Թեստավորում:

   • Թեստեք webhook-ը նմուշ payload-ներով, որպեսզի ապահովեք համատեղելիություն և հուսալիություն:

5. Սխալների կառավարում:

   • Կոնֆիգուրացրեք աշխատանքային գործընթացները՝ բացակայող կամ սխալ ձևավորված տվյալները հարմար կերպով մշակելու համար:

---

📊 Մոնիտորինգ և Դեբագինգ

• Անգործունեության գրառումներ:
  Հետևեք եկող webhook հարցումներին և նրանց մշակման կարգավիճակին SmartFlow-ի վահանակում:

• Սխալների հաշվետվություն:
  Հետաքրքրվեք ձախողված հարցումների մասին և դիտեք սխալների մանրամասները խնդիրների լուծման համար:

---

Այս բաժինը տրամադրում է մանրամասն ուղեցույց Webhook Trigger-ի համար, ապահովելով, որ օգտվողները կարողանան այն անխափան ինտեգրել իրենց աշխատանքային գործընթացներում: Let me know if you need any refinements!