🌐 Webhook Okidač

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

---

📝 Detalji Okidača

Ime: Webhook
Kategorija: Okidači

---

🔧 Parametri

1. Webhook URL

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

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

2. Payload

• Tip: object
• Opis: Podaci koje šalje vanjski sistem u tijelu zahtjeva. Ovaj payload može uključivati prilagođena polja u zavisnosti od integracije.
• Obavezno: Da
• Primjer:

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

3. Zaglavlja

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

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

---

🚀 Kako Funkcioniše

1. Konfiguracija Webhook URL-a:

   • Kada kreirate radni tok s Webhook Okidačem, SmartFlow generiše jedinstveni URL za webhook.
   • Podijelite ovaj URL s vanjskim sistemom kako biste konfigurirali njihovu integraciju.

2. Preuzimanje API Ključa:

   • Idite na ChatModel Settings.
   • Idite na Integration → Web.
   • Kliknite Copy API Key da biste preuzeli potrebni autentifikacijski token.

3. Struktura Payload-a:

   • Vanjski sistemi šalju podatke (payload) na webhook URL koristeći HTTP POST zahtjev.
   • Payload mora odgovarati strukturi koja je potrebna radnom toku.

4. Izvršenje Okidača:

   • Kada webhook primi valjani zahtjev, povezani radni tok se automatski pokreće.
   • SmartFlow obrađuje payload, izvršava definirane radnje i vraća odgovor ako je potrebno.

---

💡 Upotrebe

1. CRM Integracija:

   • Scenarij: Kupac kreira novi račun u vašem CRM sistemu.
   • Webhook: CRM šalje POST zahtjev SmartFlow-u sa detaljima kupca.
   • Tok rada: Šalje dobrodošlicu putem e-pošte i dodaje kupca na vašu marketinšku listu.

2. Upravljanje Narudžbama:

   • Scenarij: E-trgovinska platforma obrađuje novu narudžbu.
   • Webhook: Platforma šalje detalje narudžbe SmartFlow-u.
   • Tok rada: Ažurira zalihe, šalje e-poštu sa potvrdom narudžbe i obavještava skladište.

3. Praćenje Incidenata:

   • Scenarij: Sistem za praćenje otkriva kritičnu grešku.
   • Webhook: Sistem šalje upozorenje SmartFlow-u.
   • Tok rada: Kreira izvještaj o incidentu i obavještava inženjerski tim.

---

🔍 Primjer Konfiguracije

Dolazni Webhook Zahtjev

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 zahtjeve kako biste osigurali integritet podataka i spriječili zloupotrebu.
   • Koristite sigurne zaglavlja ili tokene za autentifikaciju.

2. Sigurnost 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 toka rada za nesmetano procesiranje.

4. Testiranje:

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

5. Rukovanje Greškama:

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

---

📊 Praćenje i Debagovanje

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

• Izvještavanje o Greškama:
  Identifikujte neuspjele zahtjeve i pregledajte detalje grešaka za rješavanje problema.

---

Ovaj odjeljak pruža detaljan vodič za Webhook Okidač, osiguravajući da korisnici mogu besprijekorno integrirati u svoje tokove rada. Javite mi ako su vam potrebna dodatna poboljšanja!