🌐 Webhook Okidač

Webhook Okidač omogućuje vanjskim sustavima 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ćujući dinamičnu i neometanu automatizaciju zadataka.

---

📝 Detalji Okidača

Naziv: Webhook
Kategorija: Okidači

---

🔧 Parametri

1. Webhook URL

• Tip: string
• Opis: URL krajnje točke za webhook za primanje dolaznih zahtjeva. Ovaj URL se automatski generira za svaki radni tok koji koristi ovaj okidač.
• Obavezno: Da
• Primjer:

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

2. Payload

• Tip: object
• Opis: Podaci koje vanjski sustav šalje u tijelu zahtjeva. Ovaj payload može uključivati prilagođena polja ovisno o integraciji.
• 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 sustav može uključiti za autentifikaciju ili svrhe metapodataka.
• Obavezno: Ne
• Primjer:

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

---

🚀 Kako to radi

1. Konfiguracija Webhook URL-a:

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

2. Preuzimanje API Ključa:

   • Idite na Postavke ChatModel-a.
   • Idite na Integracija → Web.
   • Kliknite Kopiraj API Ključ kako biste preuzeli potrebni autentifikacijski token.

3. Struktura Payload-a:

   • Vanjski sustavi šalju podatke (payload) na webhook URL koristeći HTTP POST zahtjev.
   • Payload mora odgovarati strukturi koju zahtijeva radni tok.

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. Integracija s CRM-om:

   • Scenarij: Kupac kreira novi račun u vašem CRM sustavu.
   • Webhook: CRM šalje POST zahtjev SmartFlow-u s podacima o kupcu.
   • Workflow: Š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.
   • Workflow: Ažurira zalihe, šalje potvrdu narudžbe putem e-pošte i obavještava skladište.

3. Praćenje Incidenata:

   • Scenarij: Sustav za praćenje otkriva kritičnu grešku.
   • Webhook: Sustav šalje upozorenje SmartFlow-u.
   • Workflow: Stvara 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"
}

Zaglavlja:

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

---

🛠️ Najbolje Prakse

1. Validacija:

   • Validirajte dolazne zahtjeve kako biste osigurali integritet podataka i spriječili zloupotrebu.
   • Koristite sigurnosne zaglavlja ili tokene za autentifikaciju.

2. Sigurnost API Ključeva:

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

3. Mapiranje Podataka:

   • Jasno mapirajte dolazna polja na varijable radnog toka za nesmetano procesuiranje.

4. Testiranje:

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

5. Rukovanje Pogreškama:

   • Konfigurirajte radne tokove da se nosi s nedostajućim ili neispravnim podacima na prikladan način.

---

📊 Praćenje i Debagiranje

• Zapis aktivnosti:
  Pratite dolazne webhook zahtjeve i njihov status obrade na SmartFlow-ovoj nadzornoj ploči.

• Izvještavanje o pogreškama:
  Identificirajte neuspjele zahtjeve i pregledajte detalje pogreške za rješavanje problema.

---

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