İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Form tetikleyicisi

Yerleşik doğrulama ve herkese açık erişim seçenekleriyle özel form gönderimlerinden iş akışları başlatın.

Genel bakış

Form tetikleyicisi, gönderildiğinde iş akışınızı başlatan özel bir web formu oluşturur. Kullanıcılardan—iç ekip üyeleri veya harici müşteriler—bilgi toplamak ve bu veriyi otomatik işlemek için idealdir.

En uygun olduğu durum: Alım formları, veri toplama, müşteri talepleri, geri bildirim toplama ve başvuru gönderimleri.

Form tetikleyicisini ne zaman kullanmalı?

İdeal olduğu durumlar:

  • Müşteri geri bildirimi veya destek talebi formları
  • İç talep formları (BT talepleri, erişim istekleri)
  • Başvuru veya kayıt formları
  • İşleme gerektiren anket yanıtları
  • Teknik olmayan kullanıcılardan veri toplama

İdeal olmadığı durumlar:

  • Sistemler arası entegrasyonlar (Webhook tetikleyicisi kullanın)
  • Zamanlanmış yinelenen görevler (Zamanlanmış tetikleyici kullanın)
  • Mevcut veriyi işleme (Manuel tetikleyici kullanın)

Yapılandırma

Temel kurulum

  1. Form başlığı: Formunuza açıklayıcı bir ad verin
  2. Açıklama: İsteğe bağlı alt başlık veya talimatlar
  3. Teşekkür mesajı: Başarılı gönderimden sonra gösterilen mesaj

Alan türleri

Belirli veri toplamak için alanlar ekleyin:

Alan türüAçıklamaKullanım senaryosu
MetinTek satırlık metin girdisiAd, başlık
Uzun metinÇok satırlı metin alanıGeri bildirim, açıklamalar, yorumlar
SayıSayısal girdiMiktar, tutar, puan
E-postaDoğrulamalı e-posta adresi girdisiİletişim e-postası, iş e-postası
TarihTarih seçiciSon tarihler, etkinlik tarihleri
Açılır listeÖnceden tanımlı seçeneklerden seçimKategori, öncelik, departman
Onay kutusuTrue/false seçimiSözleşmeler, tercihler
Dosya yüklemeEk yüklemeBelgeler, görüntüler, PDF’ler

Alan yapılandırması

Her alan için yapılandırın:

  • Alan adı: İç tanımlayıcı (snake\_case kullanın: customer_name)
  • Etiket: Kullanıcılara gösterilen metin
  • Açıklama: İsteğe bağlı yardım metni
  • Zorunlu: Alanın doldurulması gerekip gerekmediği
  • İzin verilen e-posta alanları: E-posta alanları için gönderimleri bir veya daha fazla e-posta alanıyla sınırlayın (virgülle ayrılmış)

Nasıl çalışır?

  1. Form URL’si otomatik üretilir
  2. Kullanıcı form alanlarını doldurur
  3. Form tüm zorunlu alanları ve biçimleri doğrular
  4. Gönderimde iş akışı form verisiyle başlar
  5. Kullanıcı teşekkür mesajını görür
  6. Form verisi iş akışında {{trigger.output.field_name}} ile kullanılabilir

Örnek kullanım senaryoları

Müşteri geri bildirim formu

text
Form Trigger
  - name (text, required)
  - email (email, required)
  - feedback (long text, required)
  - product (dropdown: App, Web, API)

→ Agent: Analyze sentiment and categorize
→ Condition: Check priority
  → High: Notify product team
  → Low: Store in database
→ Action: Create ticket in support system

BT destek talebi

text
Form Trigger
  - requester_name (text, required)
  - department (dropdown)
  - issue_type (dropdown: Hardware, Software, Access)
  - description (long text, required)
  - urgency (dropdown: Low, Medium, High)

→ Agent: Classify issue and suggest solution
→ Action: Create JIRA ticket
→ Notification: Alert IT team

İş başvurusu

text
Form Trigger
  - applicant_name (text, required)
  - email (email, required)
  - position (dropdown)
  - resume (file upload, required)
  - cover_letter (long text)

→ Agent: Extract candidate info from resume
→ Agent: Screen against job requirements
→ Condition: Check fit score
  → Strong: Schedule interview
  → Moderate: Add to review queue
  → Weak: Send polite rejection

Form verisine erişme

Gönderilen verilere erişmek için trigger değişkenini kullanın:

handlebars
Customer Name: {{trigger.output.name}}
Email: {{trigger.output.email}}
Feedback: {{trigger.output.feedback}}
Selected Product: {{trigger.output.product}}

Dosya yüklemeleri

Dosya yükleme alanları dosya nesnelerinden oluşan bir liste içerir. Dosya meta verisine erişin:

handlebars
File name: {{trigger.output.resume[0]._metadata.name}}
Mime type: {{trigger.output.resume[0]._metadata.mimeType}}
File size (KB): {{trigger.output.resume[0]._metadata.sizeInKb}}

resume yerine kendi dosya alan adınızı koyun.

Yüklenen dosyaların içeriğini okumak için bir Python Kod düğümü kullanın. Bkz. Önceki düğümlerden dosya okuma.

Formunuzu paylaşma

Form URL’sini kopyalama

  1. Form tetikleyicisi düğümüne tıklayın
  2. Düğüm araç çubuğunda "URL’yi kopyala"ya tıklayın
  3. URL’yi e-posta, sohbet veya web sitenize yerleştirerek paylaşın
  4. Böyle yapılandırıldıysa URL herkese açıktır

Yerleştirme seçenekleri

Doğrudan bağlantı

html
Submit Feedback

iFrame yerleştirme

html

[Video](https://app.ajan.com/workflows/forms/abc123)

En iyi uygulamalar

Yalnızca temel bilgileri isteyin. Uzun formların terk edilme oranı daha yüksektir. Ek ayrıntıları her zaman daha sonra iş akışında toplayabilirsiniz.

Alan etiketleri hangi bilginin gerektiğini net belirtmelidir. Kafa karıştırabilecek alanlar için açıklama metni ekleyin.

Kullanıcı çabasını azaltmak için mümkün olduğunda alanları makul varsayılanlarla önceden doldurun.

Deneyimin sorunsuz ve talimatların net olduğundan emin olmak için test formlarını kendiniz gönderin.

Sonraki adımlar