🌐 Aktivizimi i Webhook

Aktivizimi i Webhook lejon sistemet e jashtme të nisin flukset e punës në SmartFlow duke dërguar të dhëna përmes kërkesave API. Ky aktivizim është ideal për integrimin e SmartFlow me aplikacione të palëve të treta, duke lejuar automatizimin dinamik dhe pa ndërprerje të detyrave.

---

📝 Detajet e Aktivizimit

Emri: Webhook
Kategoria: Aktivizime

---

🔧 Parametrat

1. Webhook URL

• Tipi: string
• Përshkrimi: URL e pikës së fundit për webhook për të pranuar kërkesat e ardhshme. Kjo krijohet automatikisht për çdo fluks pune që përdor këtë aktivizim.
• E nevojshme: Po
• Shembuj:

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

2. Payload

• Tipi: object
• Përshkrimi: Të dhënat e dërguara nga sistemi i jashtëm në trupin e kërkesës. Ky payload mund të përfshijë fusha të personalizuara në varësi të integrimit.
• E nevojshme: Po
• Shembuj:

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

3. Headers

• Tipi: object
• Përshkrimi: Headers opsionale që sistemi i jashtëm mund të përfshijë për qëllime autentikimi ose metadata.
• E nevojshme: Jo
• Shembuj:

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

---

🚀 Si Funksionon

1. Konfigurimi i Webhook URL:

   • Kur krijoni një fluks pune me një Aktivizim Webhook, SmartFlow krijon një URL unik për webhook.
   • Ndani këtë URL me sistemin e jashtëm për të konfiguruar integrimin e tyre.

2. Marrja e Çelësit API:

   • Shkoni te ChatModel Settings.
   • Shkoni te Integration → Web.
   • Klikoni Copy API Key për të marrë token-in e nevojshëm për autentikim.

3. Struktura e Payload:

   • Sistemet e jashtme dërgojnë të dhëna (payload) në URL-në e webhook duke përdorur një kërkesë HTTP POST.
   • Payload duhet të përputhet me strukturën e kërkuar nga fluksi i punës.

4. Ekzekutimi i Aktivizimit:

   • Kur webhook merr një kërkesë të vlefshme, fluksi i punës i lidhur aktivizohet automatikisht.
   • SmartFlow përpunon payload-in, ekzekuton veprimet e përcaktuara dhe kthen një përgjigje nëse është e nevojshme.

---

💡 Rastet e Përdorimit

1. Integrimi i CRM:

   • Scenario: Një klient krijon një llogari të re në sistemin tuaj CRM.
   • Webhook: CRM dërgon një kërkesë POST në SmartFlow me detajet e klientit.
   • Workflow: Dërgon një email mirëseardhjeje dhe e shton klientin në listën tuaj të marketingut.

2. Menaxhimi i Porosive:

   • Scenario: Një platformë e-commerce përpunon një porosi të re.
   • Webhook: Platforma dërgon detajet e porosisë në SmartFlow.
   • Workflow: Përditëson inventarin, dërgon një email konfirmimi të porosisë dhe njofton magazinën.

3. Monitorimi i Incidentëve:

   • Scenario: Një sistem monitorimi zbulon një gabim kritik.
   • Webhook: Sistemi dërgon një alarm në SmartFlow.
   • Workflow: Krijon një raport incidenti dhe njofton ekipin inxhinierik.

---

🔍 Konfigurimi i Shembullit

Kërkesa e Webhook-it të Hyjshëm

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

---

🛠️ Praktikat më të Mira

1. Validimi:

   • Validoni kërkesat e hyjshme për të siguruar integritetin e të dhënave dhe për të parandaluar keqpërdorimin.
   • Përdorni headers ose tokene të sigurta për autentifikim.

2. Siguria e Çelësit të API:

   • Sigurohuni që çelësi i API-së i marrë nga ChatModel Settings → Integration → Web të mbahet i sigurt dhe të mos ekspozohet publikisht.

3. Hartimi i Të Dhënave:

   • Hartoni qartë fushat e hyjshme me variablat e workflow për përpunim pa probleme.

4. Testimi:

   • Testoni webhook-un me payload të mostrave për të siguruar përputhshmërinë dhe besueshmërinë.

5. Menaxhimi i Gabimeve:

   • Konfiguroni workflow-t për të trajtuar të dhënat e humbura ose të deformuara me dinjitet.

---

📊 Monitorimi dhe Debugging

• Regjistrat e Aktivitetit:
  Ndjekni kërkesat e webhook-it të hyjshëm dhe statusin e përpunimit në panelin e SmartFlow.

• Raportimi i Gabimeve:
  Identifikoni kërkesat e dështuara dhe shikoni detajet e gabimeve për zgjidhje.

---

Ky seksion ofron një udhëzues të detajuar për Trigger-in e Webhook, duke siguruar që përdoruesit të mund ta integrojnë atë pa probleme në workflow-t e tyre. Më njoftoni nëse keni nevojë për ndonjë përmirësim!