🌐 Webhook Trigger

Ο Webhook Trigger επιτρέπει σε εξωτερικά συστήματα να ξεκινούν ροές εργασίας στο SmartFlow στέλνοντας δεδομένα μέσω API αιτημάτων. Αυτός ο trigger είναι ιδανικός για την ενσωμάτωση του SmartFlow με εφαρμογές τρίτων, επιτρέποντας τη δυναμική και απρόσκοπτη αυτοματοποίηση εργασιών.

---

📝 Trigger Details

Name: Webhook
Category: Triggers

---

🔧 Parameters

1. Webhook URL

• Type: string
• Description: Η διεύθυνση URL του endpoint για τον webhook ώστε να δέχεται εισερχόμενα αιτήματα. Αυτή δημιουργείται αυτόματα για κάθε ροή εργασίας που χρησιμοποιεί αυτόν τον trigger.
• 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: Προαιρετικοί headers που μπορεί να περιλαμβάνει το εξωτερικό σύστημα για σκοπούς αυθεντικοποίησης ή μεταδεδομένων.
• 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.
   • Πηγαίνετε στο Ενσωμάτωση → Web.
   • Κάντε κλικ στο Αντιγραφή API Key για να ανακτήσετε το απαραίτητο διαπιστευτήριο αυθεντικοποίησης.

3. Payload Structure:

   • Τα εξωτερικά συστήματα στέλνουν δεδομένα (payload) στη διεύθυνση URL του webhook χρησιμοποιώντας ένα HTTP POST αίτημα.
   • Το payload πρέπει να ταιριάζει με τη δομή που απαιτεί η ροή εργασίας.

4. Trigger Execution:

   • Όταν ο webhook λαμβάνει ένα έγκυρο αίτημα, η σχετική ροή εργασίας ενεργοποιείται αυτόματα.
   • Το SmartFlow επεξεργάζεται το payload, εκτελεί τις καθορισμένες ενέργειες και επιστρέφει μια απάντηση αν είναι απαραίτητο.

---

💡 Χρήσεις

1. Ενοποίηση CRM:

   • Σενάριο: Ένας πελάτης δημιουργεί νέο λογαριασμό στο σύστημα CRM σας.
   • Webhook: Το CRM στέλνει ένα POST αίτημα στο SmartFlow με λεπτομέρειες πελάτη.
   • Ροή εργασίας: Στέλνει ένα email καλωσορίσματος και προσθέτει τον πελάτη στη λίστα μάρκετινγκ σας.

2. Διαχείριση Παραγγελιών:

   • Σενάριο: Μια πλατφόρμα ηλεκτρονικού εμπορίου επεξεργάζεται μια νέα παραγγελία.
   • Webhook: Η πλατφόρμα στέλνει λεπτομέρειες παραγγελίας στο SmartFlow.
   • Ροή εργασίας: Ενημερώνει το απόθεμα, στέλνει ένα email επιβεβαίωσης παραγγελίας και ειδοποιεί την αποθήκη.

3. Παρακολούθηση Συμβάντων:

   • Σενάριο: Ένα σύστημα παρακολούθησης ανιχνεύει ένα κρίσιμο σφάλμα.
   • Webhook: Το σύστημα στέλνει μια ειδοποίηση στο SmartFlow.
   • Ροή εργασίας: Δημιουργεί μια αναφορά συμβάντος και ειδοποιεί την ομάδα μηχανικών.

---

🔍 Παράδειγμα Ρύθμισης

Εισερχόμενο Αίτημα Webhook

URL:

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

Φορτίο:

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

Κεφαλίδες:

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

---

🛠️ Καλές Πρακτικές

1. Επικύρωση:

   • Επικυρώστε τα εισερχόμενα αιτήματα για να διασφαλίσετε την ακεραιότητα των δεδομένων και να αποτρέψετε κακή χρήση.
   • Χρησιμοποιήστε ασφαλείς κεφαλίδες ή tokens για την αυθεντικοποίηση.

2. Ασφάλεια Κλειδιού API:

   • Διασφαλίστε ότι το κλειδί API που αποκτάται από ChatModel Settings → Integration → Web διατηρείται ασφαλές και δεν εκτίθεται δημόσια.

3. Χαρτογράφηση Δεδομένων:

   • Χαρτογραφήστε σαφώς τα εισερχόμενα πεδία σε μεταβλητές ροής εργασίας για ομαλή επεξεργασία.

4. Δοκιμές:

   • Δοκιμάστε το webhook με δείγματα φορτίων για να διασφαλίσετε τη συμβατότητα και την αξιοπιστία.

5. Διαχείριση Σφαλμάτων:

   • Ρυθμίστε τις ροές εργασίας για να χειρίζονται τα ελλιπή ή κακώς διαμορφωμένα δεδομένα με ευγένεια.

---

📊 Παρακολούθηση και Αποσφαλμάτωση

• Καταγραφές Δραστηριότητας:
  Παρακολουθήστε τα εισερχόμενα αιτήματα webhook και την κατάσταση επεξεργασίας τους στον πίνακα ελέγχου του SmartFlow.

• Αναφορά Σφαλμάτων:
  Εντοπίστε αποτυχημένα αιτήματα και δείτε λεπτομέρειες σφαλμάτων για την αποσφαλμάτωση.

---

Αυτή η ενότητα παρέχει έναν λεπτομερή οδηγό για το Webhook Trigger, διασφαλίζοντας ότι οι χρήστες μπορούν να το ενσωματώσουν ομαλά στις ροές εργασίας τους. Ενημερώστε με αν χρειάζεστε οποιεσδήποτε βελτιώσεις!