İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Entegrasyon tetikleyicisi

Bağlı uygulamalarınızda olaylar gerçekleştiğinde iş akışlarını otomatik başlatın.

Genel bakış

Entegrasyon tetikleyicisi, iş akışlarınızı bağlı uygulamalarınızdaki gerçek zamanlı olaylara bağlar. Slack’te, CRM’inizde, gelen kutunuzda veya başka herhangi bir entegre hizmette bir şey olduğunda iş akışınız otomatik harekete geçer.

En uygun olduğu durum: Bağlı uygulamalardaki olaylara yanıt verme, gerçek zamanlı otomasyon, platformlar arası iş akışları ve olay odaklı süreçler.

Entegrasyon tetikleyicisini ne zaman kullanmalı?

İdeal olduğu durumlar:

  • Belirli kanallarda yeni Slack veya Microsoft Teams mesajları
  • Gmail veya Outlook’ta alınan e-postalar
  • Oluşturulan veya yakında başlayan takvim etkinlikleri
  • Google Drive’da eklenen yeni dosya veya klasörler
  • CRM kayıt değişiklikleri (yeni lead’ler, fırsatlar, kişiler)
  • Proje yönetimi güncellemeleri (yeni Jira sorunları, Planner görevleri)

İdeal olmadığı durumlar:

  • Özel API entegrasyonları (Webhook tetikleyicisi kullanın)
  • Zamanlanmış yinelenen görevler (Zamanlanmış tetikleyici kullanın)
  • Kullanıcı gönderimli formlar (Form tetikleyicisi kullanın)

Yapılandırma

Adım 1: Entegrasyon seçin

Çalışma alanınızın bağlı entegrasyonlarından seçin. Aşağıdaki entegrasyonlar olay tabanlı tetikleyicileri destekler:

  • İletişim: Slack, Microsoft Teams, Gmail, Outlook Email
  • Verimlilik: Notion, Jira, Confluence, Microsoft Planner
  • Depolama: Google Drive
  • CRM: Salesforce, HubSpot
  • Takvim: Google Calendar, Outlook Calendar, Calendly
  • Geliştirici: GitHub
  • Diğer: Stripe, Ashby, Microsoft Power BI

Diğer entegrasyonlar (Google Sheets, Asana, Airtable, Linear, Monday.com gibi) bir iş akışı içinde aksiyon olarak kullanılabilir ancak tetikleyici olarak kullanılamaz. Bunları yinelenen biçimde yoklamak için bunun yerine Zamanlanmış tetikleyici kullanın.

Adım 2: Olay türünü seçin

Her entegrasyon belirli tetikleyici olayları sunar:

Slack

  • Kanalda yeni mesaj
  • Konuşmalarda yeni mesaj (DM’ler ve grup sohbetleri)
  • Bir aramayla eşleşen yeni mesaj
  • Kanalda yeni tepki

Microsoft Teams

  • Yeni kanal mesajı
  • Yeni sohbet mesajı
  • Yeni kanal bahsi
  • Yeni toplantı dökümü

Gmail

  • Yeni e-posta
  • Aramayla eşleşen yeni e-posta
  • E-postada etiket değişti

Outlook Email

  • Yeni e-posta
  • Aramayla eşleşen yeni e-posta
  • Belirli klasörde yeni e-posta
  • Paylaşılan gelen kutusunda yeni e-posta
  • Paylaşılan posta kutusu klasöründe yeni e-posta

Google Calendar / Outlook Calendar

  • Yeni etkinlik
  • Aramayla eşleşen yeni etkinlik
  • Etkinlik başlangıcı (yalnızca Google Calendar)

Google Drive

  • Yeni dosya
  • Güncellenen dosya
  • Yeni klasör

Salesforce

  • Yeni lead
  • Yeni kişi
  • Yeni hesap
  • Yeni fırsat

HubSpot

  • Yeni fırsat
  • Yeni form gönderimi
  • Yeni not
  • Listeye kişi eklendi

Jira

  • Yeni sorun
  • Güncellenen sorun

GitHub

  • Yeni pull request
  • Pull request birleştirildi
  • Yeni issue
  • Yeni commit
  • Yeni release
  • Yolda değişiklikler

Stripe

  • Ödeme başarılı
  • Ödeme başarısız
  • Yeni abonelik
  • Abonelik iptal edildi
  • Yeni fatura

Adım 3: Olay filtrelerini yapılandırın

Hangi olayların iş akışınızı tetikleyeceğini daraltın:

Slack için:

  • Belirli kanallar veya konuşmalar
  • Bir arama sorgusuyla eşleşen mesajlar
  • Belirli tepki emojisi

E-posta için (Gmail / Outlook):

  • Arama ölçütleri (gönderen, konu, içerik)
  • Belirli etiketler (Gmail) veya klasörler (Outlook)

Takvim için:

  • Belirli takvim
  • Aramayla eşleşen etkinlikler

Drive için:

  • Belirli üst klasör
  • Dosya türü filtreleri

Adım 4: Tetikleyici parametrelerini yapılandırın

Bazı tetikleyicilerin doğru çalışması için ek parametreler gerekir. Bu parametreler seçtiğiniz spesifik tetikleyiciye göre değişir.

Yaygın parametre türleri:

  • Kanal/klasör seçimi: İzlenecek kanal, klasör veya kapsayıcıyı belirtin
  • Filtre ölçütleri: Olayları filtrelemek için anahtar kelimeler, etiketler veya kategoriler
  • Yoklama aralıkları: Yeni olaylar için ne sıklıkla kontrol edileceği (yoklama tabanlı tetikleyiciler için)

Zorunlu parametreler, bir olay türü seçtikten sonra tetikleyici yapılandırma panelinde görüntülenir.

Adım 5: Hesap bağlayın

Bazı entegrasyonlar verinize erişmek için kimlik doğrulamalı bir bağlantı gerektirir. Bir entegrasyon bağlantı istediğinde:

  1. "Hesap bağla"ya tıklayın
  2. ajan’ın entegrasyona erişmesine yetki verin
  3. Belirli hesabı seçin (birden fazlaysa)
  4. Gerekli izinleri verin

Örnek kullanım senaryoları

Slack → Talep oluşturma

text
Integration Trigger (New message in #support channel)
→ Agent: Extract issue details from message
→ Action: Create JIRA ticket
→ Action: Reply in Slack thread with ticket number

CRM → Lead işleme

text
Integration Trigger (New lead in Salesforce)
→ HTTP Request: Enrich lead data from external API
→ Agent: Score lead quality
→ Condition: Check score
  → High: Notify sales team
  → Low: Add to nurture campaign
→ Action: Update lead with score and status

Gmail → Belge işleme

text
Integration Trigger (New email with attachment)
→ Agent: Extract and summarize document content
→ Action: Save summary to Google Drive
→ Action: Create task in project management tool
→ Action: Reply to email confirming receipt

Takvim → Toplantı hazırlığı

text
Integration Trigger (Event starting in 1 hour)
→ HTTP Request: Fetch meeting context from CRM
→ Agent: Generate meeting brief
→ Action: Send Slack message to attendees
→ Action: Create Google Doc with meeting notes template

Drive → İçerik onayı

text
Integration Trigger (New file in "Pending Approval" folder)
→ Agent: Review content against guidelines
→ Condition: Check approval recommendation
  → Approved: Move to "Published" folder
  → Needs Changes: Send feedback to creator
→ Notification: Alert stakeholders of decision

Entegrasyon verisine erişme

Olay verisine erişmek için trigger değişkenini kullanın:

Örnek: Gmail olay verisi

handlebars
Subject: {{trigger.output.subject}}
From: {{trigger.output.from}}
Body: {{trigger.output.body}}
Has Attachments: {{trigger.output.has_attachments}}
Labels: {{trigger.output.labels}}

Entegrasyon tetikleyicilerini test etme

Test paneli

  1. Entegrasyon tetikleyicisi düğümüne tıklayın
  2. Araç çubuğunda "Test"e tıklayın
  3. Entegrasyondan son olayları görüntüleyin
  4. Test etmek için bir olay seçin
  5. İş akışını o olayın verisiyle çalıştırın

Gerçek olaylar tetikleyin

Test etmenin en iyi yolu:

  1. Entegrasyonda olayı elle oluşturun
    • Bir Slack mesajı gönderin
    • Kendinize bir e-posta gönderin
    • Bir takvim etkinliği oluşturun
  2. Olayın tetiklenmesini bekleyin (genellikle saniyeler içinde)
  3. Yürütme için Çalıştırmalar sekmesini kontrol edin
  4. İş akışı sonuçlarını inceleyin

Yaygın entegrasyon kalıpları

Çift yönlü senkron

text
Integration Trigger (HubSpot deal updated)
→ Code: Transform data
→ HTTP Request: Update external system
→ Condition: Check if update successful
  → Success: Update note on the deal
  → Failure: Notify admin

En iyi uygulamalar

Yalnızca ilgili olaylarda tetiklemek için entegrasyon filtrelerini kullanın. Her Slack mesajını işlemek pahalı ve yavaştır.

Bazı entegrasyonlar yinelenen olaylar gönderebilir. Benzersiz kimliklerle yinelenenleri tespit edip atlamak için mantık ekleyin.

Entegrasyon izinlerinin süresi dolabilir. Kimlik doğrulama hataları için uyarılar kurun.

Yalnızca test verisi kullanmayın—entegrasyonda gerçek olaylar tetikleyin ve iş akışınızın bunları doğru işlediğini doğrulayın.

Bir entegrasyon olayı sık oluyorsa (ör. birçok Slack mesajı), iş akışınızı bunaltmamak için koşullar eklemeyi düşünün.

Daha sonra başvurmanız gerekebileceği için orijinal olay verisini iş akışının erken aşamasında saklayın.

Sonraki adımlar