📋 SmartForm bħala Għodda ta' Konversazzjoni

Il SmartForm Trigger jaħdem bħala punt ta' dħul għal flussi ta' xogħol billi jiġbor ir-risposti tal-utent permezz ta' forma. Id-data kollha miġbura, inklużi r-riżultati kalkulati mill-AI (jekk attivati fil-konfigurazzjoni tal-forma), tiġi mgħoddija lil SmartFlow. Dan jippermettilek tuża d-data tal-forma b'mod dinamiċi fil-flussi ta' xogħol tiegħek u toħloq azzjonijiet immexxija mill-loġika.

---

📝 Dettalji tal-Trigger

Isem: SmartForm
Kategorija: Triggers

---

🔧 Parametri

1. Form ID

• Tip: string
• Deskrizzjoni: L-identifikatur uniku tal-SmartForm.
• Meħtieġ: Iva
• Eżempju:

  form12345

2. Risposti tal-Forma

• Tip: object
• Deskrizzjoni: Fiha l-mistoqsijiet kollha u r-risposti rispettivi tagħhom, li jistgħu jintużaw bħala varjabbli fl-azzjonijiet ta' SmartFlow.
• Meħtieġ: Iva
• Eżempju:

  {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "age": 30,
    "feedback": "Great service!"
  }

3. Osservazzjoni

• Tip: string
• Deskrizzjoni: Tissettja l-osservazzjoni għall-AI wara li l-forma tiġi kompluta. B'definizzjoni, din hija r-riżultat kalkulat mill-AI jew ir-risposti tal-forma. Madankollu, tista' tippersonalizzahha b'mod manwali.
• Meħtieġ: Opcjonali
• Valur Predefinit: Ir-riżultat jew ir-risposta tal-forma.

---

🚀 Kif Jaħdem

1. Kompletament tal-Forma:

   • L-utenti jinteraġixxu mal-SmartForm u jipprovdu risposti għall-mistoqsijiet.

2. Ħidma tar-Riżultat:

   • Ladarba l-forma tiġi sottomessa, SmartFlow jirċievi:
     • Id-data kollha tal-forma: Kull mistoqsija u risposta bħala varjabbli.
     • Riżultat (jekk attivat): Riżultati kalkulati mill-AI bbażati fuq l-inputs tal-utent.
   • L'osservazzjoni tiġi settjata jew għar-riżultat kalkulat jew għad-data predefinita tal-forma.

3. Varjabbli fil-Fluss ta' Xogħol:

   • Kull mistoqsija u risposta hija disponibbli għall-użu fl-azzjonijiet ta' SmartFlow.
   • Eżempju: Uża {name} jew {feedback} f'azzjoni ta' email.

---

💡 Każijiet ta' Użu

1. Onboarding Personalizzat

• Is-sena: Uża SmartForms biex tiġbor id-dettalji tal-utent waqt l-onboarding.
• Fluss ta' Xogħol:
  • Il-variabbli mill-formola (eż. isem, età) jintużaw biex personalizzaw il-passi li jmiss.
  • Eżempju: Assegna l-utenti għal maniġer ta' suċċess tal-klijent speċifiku ibbażat fuq ir-risposti tagħhom.

2. Analiżi ta' Sondaggi

• Is-sena: Ġib feedback u analizza dan dinamiċament.
• Fluss ta' Xogħol:
  • Uża r-riżultati kalkulati mill-AI biex tikkalkula s-sentiment.
  • Il-variabbli bħal {rating} u {feedback} jintużaw biex jieħdu azzjonijiet xierqa.

3. Deċiżjoni Dinamiċi

• Is-sena: Ħalli SmartFlow jieħu deċiżjonijiet ibbażati fuq ir-risposti tal-utent.
• Fluss ta' Xogħol:
  • Il-mistoqsijiet fil-formola (eż. {role}) jiggwidaw il-passi li jmiss tal-fluss ta' xogħol.

---

🔍 Eżempju ta' Konfigurazzjoni

Form ID:

customerFeedbackForm01

Mistoqsijiet tal-Formola:

{
  "name": "string",
  "email": "string",
  "feedback": "string",
  "rating": "number"
}

Osservazzjoni:

"Feedback analysis complete. Sentiment: Positive."

---

🛠️ Pariri

1. Kontroll tal-Osservazzjoni:

   • Isettja manwalment l-osservazzjoni biex t'influwenza l-azzjoni li jmiss tal-AI. Per eżempju:

     "Start a new workflow based on the form data."

2. Debugging:

   • Ittestja s-sottomissjonijiet tal-formola biex tiżgura li l-variabbli kollha jiġu trasferiti b'mod korrett lil SmartFlow.

3. Eżattezza tar-Riżultati:

   • Jekk il-kalkolu tar-riżultati huwa attivat, żgura li l-loġika tal-AI fil-formola tkun konfigurat b'mod korrett għall-iskopijiet ta' riżultati eżatti.