🌐 Declanșator Webhook

Declanșatorul Webhook permite sistemelor externe să inițieze fluxuri de lucru în SmartFlow prin trimiterea de date prin cereri API. Acest declanșator este ideal pentru integrarea SmartFlow cu aplicații terțe, permițând automatizarea dinamică și fără întreruperi a sarcinilor.

---

📝 Detalii Declanșator

Nume: Webhook
Categorie: Declanșatoare

---

🔧 Parametrii

1. Webhook URL

• Tip: string
• Descriere: URL-ul endpoint pentru webhook pentru a primi cereri de intrare. Acesta este generat automat pentru fiecare flux de lucru care utilizează acest declanșator.
• Necesar: Da
• Exemplu:

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

2. Payload

• Tip: object
• Descriere: Datele trimise de sistemul extern în corpul cererii. Acest payload poate include câmpuri personalizate în funcție de integrare.
• Necesar: Da
• Exemplu:

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

3. Headers

• Tip: object
• Descriere: Headeri opționali pe care sistemul extern le-ar putea include pentru autentificare sau scopuri de metadate.
• Necesar: Nu
• Exemplu:

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

---

🚀 Cum Funcționează

1. Configurarea URL-ului Webhook:

   • Atunci când creați un flux de lucru cu un Declanșator Webhook, SmartFlow generează un URL unic pentru webhook.
   • Distribuiți acest URL sistemului extern pentru a configura integrarea lor.

2. Recuperarea Cheii API:

   • Navigați la Setările ChatModel.
   • Mergeți la Integrare → Web.
   • Faceți clic pe Copiați Cheia API pentru a recupera tokenul de autentificare necesar.

3. Structura Payload-ului:

   • Sistemele externe trimit date (payload) la URL-ul webhook folosind o cerere HTTP POST.
   • Payload-ul trebuie să corespundă structurii cerute de fluxul de lucru.

4. Executarea Declanșatorului:

   • Atunci când webhook-ul primește o cerere validă, fluxul de lucru asociat este declanșat automat.
   • SmartFlow procesează payload-ul, execută acțiunile definite și returnează un răspuns, dacă este necesar.

---

💡 Cazuri de Utilizare

1. Integrarea CRM:

   • Scenariul: Un client creează un nou cont în sistemul dumneavoastră CRM.
   • Webhook: CRM-ul trimite o cerere POST către SmartFlow cu detaliile clientului.
   • Flux de lucru: Trimite un email de bun venit și adaugă clientul pe lista dumneavoastră de marketing.

2. Gestionarea Comenzilor:

   • Scenariul: O platformă de comerț electronic procesează o nouă comandă.
   • Webhook: Platforma trimite detaliile comenzii către SmartFlow.
   • Flux de lucru: Actualizează inventarul, trimite un email de confirmare a comenzii și notifică depozitul.

3. Monitorizarea Incidentelor:

   • Scenariul: Un sistem de monitorizare detectează o eroare critică.
   • Webhook: Sistemul trimite o alertă către SmartFlow.
   • Flux de lucru: Creează un raport de incident și notifică echipa de inginerie.

---

🔍 Exemplu de Configurare

Cerere Webhook Întrare

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

---

🛠️ Cele Mai Bune Practici

1. Validare:

   • Validați cererile de intrare pentru a asigura integritatea datelor și a preveni utilizarea abuzivă.
   • Utilizați antete sau token-uri securizate pentru autentificare.

2. Securitatea Cheii API:

   • Asigurați-vă că cheia API obținută din ChatModel Settings → Integration → Web este păstrată în siguranță și nu este expusă public.

3. Maparea Datelor:

   • Mapați clar câmpurile de intrare la variabilele fluxului de lucru pentru un procesare fără întreruperi.

4. Testare:

   • Testați webhook-ul cu payload-uri de exemplu pentru a asigura compatibilitatea și fiabilitatea.

5. Gestionarea Erorilor:

   • Configurați fluxurile de lucru pentru a gestiona datele lipsă sau malformate într-un mod elegant.

---

📊 Monitorizare și Depanare

• Jurnale de Activitate:
  Urmăriți cererile webhook de intrare și starea lor de procesare în tabloul de bord SmartFlow.

• Raportare a Erorilor:
  Identificați cererile eșuate și vizualizați detaliile erorilor pentru depanare.

---

Această secțiune oferă un ghid detaliat pentru Trigger-ul Webhook, asigurându-se că utilizatorii pot integra fără probleme în fluxurile lor de lucru. Anunțați-mă dacă aveți nevoie de vreo ajustare!