🌐 Webhook Trigger

Webhook Trigger omogoča zunanjim sistemom, da zaženejo delovne tokove v SmartFlow s pošiljanjem podatkov prek API zahtevkov. Ta sprožilec je idealen za integracijo SmartFlow z aplikacijami tretjih oseb, kar omogoča dinamično in brezhibno avtomatizacijo nalog.

---

📝 Podrobnosti sprožilca

Ime: Webhook
Kategorija: Sprožilci

---

🔧 Parametri

1. Webhook URL

• Tip: string
• Opis: Končna točka URL za webhook, da prejme prihajajoče zahtevke. Ta URL se samodejno generira za vsak delovni tok, ki uporablja ta sprožilec.
• Obvezno: Da
• Primer:

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

2. Payload

• Tip: object
• Opis: Podatki, ki jih zunanjega sistema pošlje v telesu zahtevka. Ta payload lahko vključuje prilagojena polja, odvisno od integracije.
• Obvezno: Da
• Primer:

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

3. Headers

• Tip: object
• Opis: Neobvezni glave, ki jih zunanjega sistema morda vključuje za avtorizacijo ali namene metapodatkov.
• Obvezno: Ne
• Primer:

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

---

🚀 Kako deluje

1. Konfiguracija Webhook URL:

   • Ko ustvarite delovni tok s sprožilcem Webhook, SmartFlow generira edinstven URL za webhook.
   • Ta URL delite z zunanjim sistemom, da konfigurirate njihovo integracijo.

2. Pridobitev API Ključa:

   • Pojdite na Nastavitve ChatModel.
   • Pojdite na Integracija → Web.
   • Kliknite Kopiraj API Ključ, da pridobite potreben avtorizacijski žeton.

3. Struktura Payload:

   • Zunanjih sistemov pošiljajo podatke (payload) na URL webhook z uporabo HTTP POST zahtevka.
   • Payload mora ustrezati strukturi, ki jo zahteva delovni tok.

4. Izvršitev sprožilca:

   • Ko webhook prejme veljavno zahtevo, se povezan delovni tok samodejno sproži.
   • SmartFlow obdela payload, izvede določene akcije in vrne odgovor, če je potrebno.

---

💡 Uporabniški Primeri

1. Integracija CRM:

   • Scenarij: Stranka ustvari nov račun v vašem CRM sistemu.
   • Webhook: CRM pošlje POST zahtevo v SmartFlow z informacijami o stranki.
   • Delovni tok: Pošlje dobrodošlico po elektronski pošti in doda stranko na vaš seznam za trženje.

2. Upravljanje naročil:

   • Scenarij: E-trgovinska platforma obdeluje novo naročilo.
   • Webhook: Platforma pošlje podrobnosti naročila v SmartFlow.
   • Delovni tok: Posodobi zalogo, pošlje potrditveno elektronsko pošto o naročilu in obvesti skladišče.

3. Nadzor incidentov:

   • Scenarij: Nadzorni sistem zazna kritično napako.
   • Webhook: Sistem pošlje opozorilo v SmartFlow.
   • Delovni tok: Ustvari poročilo o incidentu in obvesti inženirsko ekipo.

---

🔍 Primer Konfiguracije

Prejeta Webhook Zahteva

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

---

🛠️ Najboljše Prakse

1. Validacija:

   • Validirajte prihajajoče zahteve, da zagotovite celovitost podatkov in preprečite zlorabe.
   • Uporabite varne glave ali žetone za avtentikacijo.

2. Varnost API Ključa:

   • Poskrbite, da je API ključ, pridobljen iz ChatModel Settings → Integration → Web, shranjen varno in ni javno izpostavljen.

3. Zemljevid podatkov:

   • Jasno preslikajte prihajajoča polja na spremenljivke delovnega toka za nemoteno obdelavo.

4. Testiranje:

   • Testirajte webhook z vzorčnimi payloadi, da zagotovite združljivost in zanesljivost.

5. Obravnava napak:

   • Konfigurirajte delovne tokove, da obravnavajo manjkajoče ali nepravilne podatke na prijazen način.

---

📊 Nadzor in Odpravljanje Napak

• Dnevniki dejavnosti:
  Sledite prihajajočim webhook zahtevam in njihovemu statusu obdelave na nadzorni plošči SmartFlow.

• Poročanje o napakah:
  Ugotovite neuspele zahteve in si oglejte podrobnosti napak za odpravljanje težav.

---

Ta oddelek ponuja podroben vodnik za Webhook Trigger, kar zagotavlja, da lahko uporabniki brez težav integrirajo v svoje delovne tokove. Sporočite mi, če potrebujete kakršne koli izboljšave!