🌐 Webhook Udløsning

Den Webhook Udløsning gør det muligt for eksterne systemer at starte arbejdsprocesser i SmartFlow ved at sende data via API-anmodninger. Denne udløsning er ideel til at integrere SmartFlow med tredjepartsapplikationer, hvilket muliggør dynamisk og problemfri automatisering af opgaver.

---

📝 Udløsningsdetaljer

Navn: Webhook
Kategori: Udløsere

---

🔧 Parametre

1. Webhook URL

• Type: string
• Beskrivelse: Endpoint-URL'en for webhook'en til at modtage indkommende anmodninger. Denne genereres automatisk for hver arbejdsproces, der bruger denne udløsning.
• Påkrævet: Ja
• Eksempel:

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

2. Payload

• Type: object
• Beskrivelse: De data, der sendes af det eksterne system i anmodningskroppen. Denne payload kan inkludere brugerdefinerede felter afhængigt af integrationen.
• Påkrævet: Ja
• Eksempel:

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

3. Headers

• Type: object
• Beskrivelse: Valgfri headers, som det eksterne system måtte inkludere til autentifikation eller metadataformål.
• Påkrævet: Nej
• Eksempel:

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

---

🚀 Sådan fungerer det

1. Webhook URL Konfiguration:

   • Når du opretter en arbejdsproces med en Webhook Udløsning, genererer SmartFlow en unik URL til webhook'en.
   • Del denne URL med det eksterne system for at konfigurere deres integration.

2. API Nøgle Hentning:

   • Naviger til ChatModel Indstillinger.
   • Gå til Integration → Web.
   • Klik på Kopier API Nøgle for at hente den nødvendige autentifikations-token.

3. Payload Struktur:

   • Eksterne systemer sender data (payload) til webhook URL'en ved hjælp af en HTTP POST anmodning.
   • Payload'en skal matche den struktur, der kræves af arbejdsprocessen.

4. Udløsningens Udførelse:

   • Når webhook'en modtager en gyldig anmodning, udløses den tilknyttede arbejdsproces automatisk.
   • SmartFlow behandler payload'en, udfører definerede handlinger og returnerer et svar, hvis det er nødvendigt.

---

💡 Brugssager

1. CRM Integration:

   • Scenario: En kunde opretter en ny konto i dit CRM-system.
   • Webhook: CRM-systemet sender en POST anmodning til SmartFlow med kundens oplysninger.
   • Workflow: Sender en velkomst-e-mail og tilføjer kunden til din marketingliste.

2. Ordrehåndtering:

   • Scenario: En e-handelsplatform behandler en ny ordre.
   • Webhook: Platformen sender ordreoplysninger til SmartFlow.
   • Workflow: Opdaterer lagerbeholdningen, sender en ordrebekræftelses-e-mail og underretter lageret.

3. Hændelsesmæssig overvågning:

   • Scenario: Et overvågningssystem opdager en kritisk fejl.
   • Webhook: Systemet sender en alarm til SmartFlow.
   • Workflow: Opretter en hændelsesrapport og underretter ingeniørteamet.

---

🔍 Eksempelkonfiguration

Indkommende Webhook Anmodning

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

---

🛠️ Bedste Praksis

1. Validering:

   • Valider indkommende anmodninger for at sikre dataintegritet og forhindre misbrug.
   • Brug sikre headers eller tokens til autentificering.

2. API Nøgle Sikkerhed:

   • Sørg for, at API-nøglen hentet fra ChatModel Settings → Integration → Web opbevares sikkert og ikke offentliggøres.

3. Datakortlægning:

   • Kortlæg klart indkommende felter til workflow-variabler for problemfri behandling.

4. Testning:

   • Test webhooken med eksempel-payloads for at sikre kompatibilitet og pålidelighed.

5. Fejlhåndtering:

   • Konfigurer workflows til at håndtere manglende eller fejlbehæftede data på en elegant måde.

---

📊 Overvågning og Fejlfinding

• Aktivitetslogger:
  Spor indkommende webhook-anmodninger og deres behandlingsstatus i SmartFlows dashboard.

• Fejlrapportering:
  Identificer mislykkede anmodninger og se fejldetaljer for fejlfinding.

---

Dette afsnit giver en detaljeret vejledning til Webhook Trigger, så brugerne kan integrere det problemfrit i deres workflows. Lad mig vide, hvis du har brug for nogen forbedringer!