Entegrasyonlar Kılavuzu
ajan entegrasyonları için en iyi uygulamalar, yaygın kullanım durumları ve sorun giderme
Genel Bakış
ajan entegrasyonları çalışma alanınızı dış araçlara ve servislere bağlar; böylece verileri doğrudan görüşmelerinizden erişip yönetebilirsiniz. Bu kılavuz, tüm entegrasyonlarda geçerli ortak kalıpları, en iyi uygulamaları ve sorun giderme ipuçlarını kapsar.
Belirli bir entegrasyon mu arıyorsunuz? Her servis için kurulum talimatları ve kullanılabilir eylemleri görmek üzere Entegrasyon Dizini sayfasına bakın.
Yaygın Kullanım Durumları
- Veri Yönetimi — Görüşmenizden ayrılmadan bağlı servislerdeki verilere erişin, düzenleyin ve güncelleyin
- Otomasyon — Bağlı araçlarınızda iş akışlarını tetikleyin ve tekrarlayan görevleri otomatikleştirin
- Raporlama — Birden fazla kaynaktan veri çekerek tek bir görünümde içgörü üretin
- Entegrasyon — Teknoloji yığınınızda sorunsuz iş akışları oluşturmak için servisleri birbirine bağlayın
Başlarken
Entegrasyonu bulun
ajan çalışma alanınızda Integrations bölümüne gidin. Bağlamak istediğiniz servisi gezin veya arayın.
Hesabınızı bağlayın
Connect düğmesine tıklayın ve kimlik doğrulama akışını izleyin. Çoğu entegrasyon OAuth kullanır — hesabınızla oturum açmak ve ajan'a erişim vermek için yönlendirilirsiniz.
Bağlantıyı test edin
Yeni bir sohbette @ ardından entegrasyon adını yazın (ör. @Slack) ve kanalları listeleme veya son verileri okuma gibi basit bir eylem deneyin.
Kullanılabilir eylemleri keşfedin
Bağlı servisiniz için tüm eylemleri ve tetikleyicileri görmek üzere Entegrasyon Dizini sayfasını kontrol edin.
En İyi Uygulamalar
Performans ipuçları: * Sonuç boyutlarını kontrol etmek için sayfalama parametrelerini (
limit,maxRecords) kullanın * Kaynaklara başvururken daha yüksek güvenilirlik için adlar yerine kimlikleri tercih edin * Aramada veri aktarımını azaltmak için filtre kullanın * API çağrılarını en aza indirmek için mümkün olduğunda işlemleri toplu yapın
Önemli hususlar: * Kimlik doğrulama bilgilerinizin gerekli izinlere sahip olduğundan emin olun * Her servisin hız sınırlarına ve API kotalarına saygı gösterin * Entegrasyon erişimini paylaşmadan önce veri gizliliği ayarlarını gözden geçirin * Yazma işlemlerini önce güvenli bir ortamda test edin
Entegrasyonları Kullanma
Sohbette
Eylemlerini kullanmak için herhangi bir görüşmede bir entegrasyonu @ ile etiketleyin. Örneğin:
@Slack send a message to #general saying "Meeting in 5 minutes"@HubSpot find contacts at Acme Corp@Google Calendar create a meeting tomorrow at 2pm
Temsilcilerde
Temsilcilerinize dış araçlara erişim vermek için entegrasyon eylemleri ekleyin:
- Temsilcinizi açın ve Actions bölümüne gidin
- Add Action düğmesine tıklayın ve entegrasyonu arayın (ör. "Slack", "HubSpot")
- Temsilcinin kullanmasını istediğiniz belirli eylemleri seçin (ör. "Send message", "Create contact")
Temsilci ardından kullanıcılara yanıt verirken bu eylemleri otomatik kullanabilir.
İş akışlarında
Entegrasyonlar hem iş akışlarını tetikleyebilir hem de iş akışı adımları olarak kullanılabilir:
- Tetikleyiciler: Dış bir araçta bir şey olduğunda iş akışını başlatın (ör. yeni Slack mesajı, yeni HubSpot anlaşması)
- Eylemler: İş akışınıza bir Action Node ekleyin ve gerçekleştirilecek bir entegrasyon eylemi seçin (ör. e-posta gönder, kayıt güncelle)
Sorun Giderme
| Sorun | Olası neden | Çözüm |
|---|---|---|
| Kimlik doğrulama başarısız | Süresi dolmuş veya geçersiz kimlik bilgileri | Entegrasyonu açın ve bağlantıyı yeniden yetkilendirin |
| Hız sınırı aşıldı | Kısa sürede çok fazla istek | İstek sıklığını azaltın veya işlemler arasına gecikme ekleyin |
| Veri bulunamadı | Yetersiz izin veya yanlış kimlik | İzinleri doğrulayın ve kaynak kimliğinin doğru olduğunu kontrol edin |
| Bağlantı zaman aşımı | Ağ sorunları veya servis kullanılamıyor | Ağ bağlantısını doğrulayın ve servisin durum sayfasını kontrol edin |
| Eylem kullanılamıyor | Entegrasyon tam etkin değil | Entegrasyonun bağlı olduğundan ve gerekli tüm kapsamların verildiğinden emin olun |
Entegrasyon İzinleri
Entegrasyonlar yalnızca işlevleri için gereken izinleri ister. Çalışma alanı yöneticisiyseniz, kapsamların ve eylem kullanılabilirliğinin nasıl çalıştığını Eylem Düzeyi Kapsamları Yönetme ve kullanıcı/grup erişiminin nasıl çalıştığını Eylem Erişimini Yönetme sayfalarından öğrenebilirsiniz.
Çalışma alanı yöneticileri: Çalışma alanınızda hangi entegrasyonların kullanılabileceğini kontrol edebilir ve ekibiniz için paylaşılan bağlantılar kurabilirsiniz.
Destek
Entegrasyonlar için ek yardım:
- Ayrıntılı eylem referansları için ilgili entegrasyonun belge sayfasını kontrol edin
- Teknik yardım için support@ajan.com adresine yazın
- Eğitimler ve kılavuzlar için Yardım Merkezi sayfasını ziyaret edin