🌐 Webhook Trigger

Webhook Trigger საშუალებას აძლევს გარე სისტემებს დაიწყონ სამუშაო პროცესები SmartFlow-ში API მოთხოვნების საშუალებით მონაცემების გაგზავნით. ეს ტრიგერი იდეალურია SmartFlow-ის ინტეგრაციისთვის მესამე მხარის აპლიკაციებთან, რაც საშუალებას იძლევა დინამიური და უწყვეტი ავტომატიზაცია დავალებების შესრულებაში.

---

📝 Trigger Details

Name: Webhook
Category: Triggers

---

🔧 Parameters

1. Webhook URL

• Type: string
• Description: ვებსაიტის URL, სადაც webhook იღებს შემომავალი მოთხოვნებს. ეს ავტომატურად გენერირდება თითოეული სამუშაო პროცესისთვის, რომელიც იყენებს ამ ტრიგერს.
• Required: Yes
• Example:

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

2. Payload

• Type: object
• Description: მონაცემები, რომლებიც გარე სისტემამ გამოიგზავნა მოთხოვნის სხეულში. ეს payload შეიძლება მოიცავდეს მორგებულ ველებს ინტეგრაციის მიხედვით.
• Required: Yes
• Example:

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

3. Headers

• Type: object
• Description: სავალდებულო ჰედერები, რომლებიც გარე სისტემამ შეიძლება მოიცვას ავტორიზაციის ან მეტადატების მიზნებისთვის.
• Required: No
• 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-თან მომხმარებლის დეტალებით.
   • Workflow: აგზავნის მისასალმებელ ელფოსტას და ამატებს მომხმარებელს თქვენს მარკეტინგულ სიაში.

2. შეკვეთების მართვა:

   • სცენარი: ელექტრონული კომერციის პლატფორმა პროცესებს ახალ შეკვეთას.
   • Webhook: პლატფორმა აგზავნის შეკვეთის დეტალებს SmartFlow-თან.
   • Workflow: განახლებებს ინვენტარს, აგზავნის შეკვეთის დადასტურების ელფოსტას და აცნობებს საწყობს.

3. შემთხვევების მონიტორინგი:

   • სცენარი: მონიტორინგის სისტემა აღმოაჩენს კრიტიკულ შეცდომას.
   • Webhook: სისტემა აგზავნის გაფრთხილებას SmartFlow-თან.
   • Workflow: ქმნის შემთხვევის ანგარიშს და აცნობებს საინჟინრო გუნდს.

---

🔍 მაგალითის კონფიგურაცია

შემომავალი 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. ვალიდაცია:

   • ვალიდაცია მოახდინეთ შემომავალი მოთხოვნების, რათა უზრუნველყოთ მონაცემების მთლიანობა და თავიდან აიცილოთ ბოროტად გამოყენება.
   • გამოიყენეთ უსაფრთხო ჰედერები ან ტოკენები ავტორიზაციისთვის.

2. API გასაღების უსაფრთხოება:

   • დარწმუნდით, რომ API გასაღები, რომელიც მიღებულია ChatModel Settings → Integration → Web-დან, დაცულია და არ არის საჯაროდ გამჟღავნებული.

3. მონაცემების რუკირება:

   • ნათლად რუკირეთ შემომავალი ველები workflow ცვლადებზე შეუფერხებელი პროცესისთვის.

4. ტესტირება:

   • ტესტირება მოახდინეთ webhook-ის მაგალითური payload-ებით, რათა უზრუნველყოთ თავსებადობა და სანდოობა.

5. შეცდომების მართვა:

   • კონფიგურაცია მოახდინეთ workflows-ისთვის, რათა სწორად მოიქცნენ დაკარგული ან არასწორად ფორმატირებული მონაცემების შემთხვევაში.

---

📊 მონიტორინგი და დებაგირება

• აქტივობის ლოგები:
  დააკვირდით შემომავალ webhook მოთხოვნებს და მათი პროცესირების სტატუსს SmartFlow-ის პანელში.

• შეცდომების ანგარიშგება:
  გამოავლინეთ წარუმატებელი მოთხოვნები და იხილეთ შეცდომების დეტალები პრობლემების გადასაჭრელად.

---

ეს ნაწილი უზრუნველყოფს დეტალურ სახელმძღვანელოს Webhook Trigger-ისთვის, რათა მომხმარებლებს შეუძლიათ ის შეუფერხებლად ინტეგრირდეთ თავიანთ workflows-ში. თუ საჭირო იქნება რაიმე გაუმჯობესება, მომწერეთ!