🌐 Webhook Okidač

Webhook Okidač omogućava spoljnim sistemima da pokrenu radne tokove u SmartFlow slanjem podataka putem API zahteva. Ovaj okidač je idealan za integraciju SmartFlow-a sa aplikacijama trećih strana, omogućavajući dinamičnu i besprekornu automatizaciju zadataka.

---

📝 Detalji Okidača

Ime: Webhook
Kategorija: Okidači

---

🔧 Parametri

1. Webhook URL

• Tip: string
• Opis: URL krajnje tačke za webhook da primi dolazne zahteve. Ovaj URL se automatski generiše za svaki radni tok koji koristi ovaj okidač.
• Obavezno: Da
• Primer:

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

2. Payload

• Tip: object
• Opis: Podaci koje šalje spoljni sistem u telu zahteva. Ovaj payload može uključivati prilagođena polja u zavisnosti od integracije.
• Obavezno: Da
• Primer:

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

3. Zaglavlja

• Tip: object
• Opis: Opcionalna zaglavlja koja spoljni sistem može uključiti za autentifikaciju ili svrhe metapodataka.
• Obavezno: Ne
• Primer:

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

---

🚀 Kako to funkcioniše

1. Konfiguracija Webhook URL-a:

   • Kada kreirate radni tok sa Webhook Okidačem, SmartFlow generiše jedinstveni URL za webhook.
   • Podelite ovaj URL sa spoljnim sistemom kako biste konfigurisali njihovu integraciju.

2. Preuzimanje API Ključa:

   • Idite na Podešavanja ChatModel-a.
   • Idite na Integracija → Web.
   • Kliknite na Kopiraj API Ključ da biste preuzeli potrebni autentifikacioni token.

3. Struktura Payload-a:

   • Spoljni sistemi šalju podatke (payload) na webhook URL koristeći HTTP POST zahtev.
   • Payload mora odgovarati strukturi koja je potrebna za radni tok.

4. Izvršenje Okidača:

   • Kada webhook primi validan zahtev, povezani radni tok se automatski pokreće.
   • SmartFlow obrađuje payload, izvršava definisane akcije i vraća odgovor ako je to potrebno.

---

💡 Upotrebe

1. Integracija CRM-a:

   • Scenario: Kupac kreira novi nalog u vašem CRM sistemu.
   • Webhook: CRM šalje POST zahtev SmartFlow-u sa podacima o kupcu.
   • Workflow: Šalje dobrodošlicu email i dodaje kupca na vašu listu za marketing.

2. Upravljanje Narudžbinama:

   • Scenario: E-commerce platforma obrađuje novu narudžbinu.
   • Webhook: Platforma šalje detalje narudžbine SmartFlow-u.
   • Workflow: Ažurira inventar, šalje email sa potvrdom narudžbine i obaveštava skladište.

3. Praćenje Incidenata:

   • Scenario: Sistem za praćenje detektuje kritičnu grešku.
   • Webhook: Sistem šalje upozorenje SmartFlow-u.
   • Workflow: Kreira izveštaj o incidentu i obaveštava inženjerski tim.

---

🔍 Primer Konfiguracije

Dolazni Webhook Zahtev

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"
}

---

🛠️ Najbolje Prakse

1. Validacija:

   • Validirajte dolazne zahteve kako biste osigurali integritet podataka i sprečili zloupotrebu.
   • Koristite sigurne zaglavlja ili tokene za autentifikaciju.

2. Bezbednost API Ključeva:

   • Osigurajte da je API ključ preuzet iz ChatModel Settings → Integration → Web zaštićen i da nije javno izložen.

3. Mapiranje Podataka:

   • Jasno mapirajte dolazna polja na varijable u radnom toku za nesmetano procesuiranje.

4. Testiranje:

   • Testirajte webhook sa uzorcima payload-a kako biste osigurali kompatibilnost i pouzdanost.

5. Obrada Grešaka:

   • Konfigurišite radne tokove da obrade nedostajuće ili neispravne podatke na elegantan način.

---

📊 Praćenje i Debagovanje

• Dnevnici Aktivnosti:
  Pratite dolazne webhook zahteve i njihov status obrade na SmartFlow-ovom kontrolnom panelu.

• Izveštavanje o Greškama:
  Identifikujte neuspele zahteve i pregledajte detalje grešaka za rešavanje problema.

---

Ovaj odeljak pruža detaljan vodič za Webhook Okidač, osiguravajući da korisnici mogu da ga integrišu nesmetano u svoje radne tokove. Javite mi ako su vam potrebna dodatna poboljšanja!