Kanallar
Kanallar Nedir?
Kanallar, Neotask ajanlarınızın mesaj göndermek ve almak için kullandığı iletişim platformlarıdır. Bir kanalı bağlayarak, bir ajana o platformdaki gelen mesajları dinleme ve gerçek zamanlı yanıt verme yeteneği kazandırırsınız.
Temel kavramlar:
- Ajan başına yapılandırma -- Her kanal bağlantısı ajan düzeyinde yapılandırılır. Bir ajan Slack'e bağlanırken diğeri Discord'u yönetebilir ya da tek bir ajan birden fazla kanala aynı anda bağlanabilir.
- Çift yönlü -- Kanallar hem mesaj göndermeyi hem de almayı destekler. Ajanlar gelen mesajlara yanıt verebilir, giden mesajlar başlatabilir ya da her ikisini de yapabilir.
- Çoklu hesap -- Aynı kanal türü için birden fazla hesap bağlayabilirsiniz (ör. iki farklı Slack çalışma alanı veya birkaç e-posta adresi).
Desteklenen Kanallar
| Kanal | Kimlik Doğrulama Yöntemi | Özellikler |
|---|---|---|
| Slack | OAuth | Tam mesajlaşma, kanallar, diziler, tepkiler, dosya yüklemeleri |
| Discord | Bot token'ı | Sunucu mesajlaşması, kanallar, DM'ler, gömmeler, tepkiler |
| QR kodu | Metin mesajları, medya mesajları, grup sohbetleri | |
| Telegram | Bot token'ı | Metin mesajları, gruplar, kanallar, satır içi klavyeler, dosya paylaşımı |
| Signal | Yerel uygulama | Uçtan uca şifrelenmiş mesajlaşma, grup sohbetleri |
| Microsoft Teams | OAuth | Ekipler, kanallar, sohbetler, uyarlanabilir kartlar, dosya paylaşımı |
| Google Chat | OAuth | Alanlar, doğrudan mesajlar, kartlar, dizili konuşmalar |
| SMS | API anahtarı | Desteklenen sağlayıcılar aracılığıyla giden ve gelen metin mesajlaşması |
| E-posta / Gmail | OAuth | Gönder, al, taslak oluştur, yanıtla, ekler, etiket yönetimi |
| Matrix | Token | Federasyon mesajlaşması, odalar, uçtan uca şifreleme |
| Line | Token | Metin mesajları, çıkartmalar, grup sohbetleri, zengin menüler |
| Zalo | Token | Metin mesajları, medya paylaşımı |
| IRC | Yapılandırma | Sunucu bağlantıları, kanallar, özel mesajlar |
| iMessage | Yerel | macOS yerel mesajlaşma (macOS ana bilgisayarı gerektirir) |
Kanal Bağlama
Bağlantı süreci kanalın kimlik doğrulama yöntemine bağlı olarak değişir.
OAuth Akışı
Kullananlar: Slack, Microsoft Teams, Google Chat, E-posta / Gmail
- Ajanın Kanallar sekmesini açın.
- Eklemek istediğiniz kanalın yanındaki Bağlan düğmesine tıklayın.
- Hizmetin yetkilendirme sayfasına yönlendirileceksiniz.
- Hesabınızla giriş yapın ve Neotask'a istenen izinleri verin.
- Yetkilendirme sonrasında gösterge paneline yönlendirilirsiniz ve kanal bağlı olarak görünür.
Mobil platformlar için bir QR kodu seçeneği mevcuttur. Masaüstü tarayıcınızda oturum açmaya gerek kalmadan yetkilendirmeyi tamamlamak için QR kodunu telefonunuzdan tarayın.
Bot Token'ı
Kullananlar: Discord, Telegram
- İlgili platformda bir bot oluşturun:
- Discord -- Discord Geliştirici Portalı'nda bir uygulama oluşturun ve bot token'ı oluşturun.
- Telegram -- Telegram'da @BotFather ile iletişime geçerek bir bot oluşturun ve token alın.
- Ajanın Kanallar sekmesini açın ve kanalın yanındaki Bağlan düğmesine tıklayın.
- Bot token'ını token alanına yapıştırın.
- Bağlantıyı kurmak için Kaydet'e tıklayın.
QR Kodu
Kullananlar: WhatsApp
- Ajanın Kanallar sekmesini açın ve WhatsApp'ın yanındaki Bağlan düğmesine tıklayın.
- Ekranda bir QR kodu görünecektir.
- Telefonunuzda WhatsApp'ı açın, Bağlı Cihazlar'a gidin ve QR kodunu tarayın.
- Telefonunuz bağlantıyı onayladığında bağlantı kurulur.
API Anahtarı
Kullananlar: SMS
- SMS sağlayıcınızdan bir API anahtarı alın (ör. Twilio, Vonage).
- Ajanın Kanallar sekmesini açın ve SMS'in yanındaki Bağlan düğmesine tıklayın.
- API anahtarınızı ve gerekli ek alanları girin (ör. telefon numarası, hesap SID'i).
- Kanalı etkinleştirmek için Kaydet'e tıklayın.
Token
Kullananlar: Matrix, Line, Zalo
- İlgili platformun geliştirici ayarlarından veya yönetici panelinden bir erişim token'ı oluşturun.
- Ajanın Kanallar sekmesini açın ve kanalın yanındaki Bağlan düğmesine tıklayın.
- Token'ı token alanına yapıştırın.
- Bağlantıyı kurmak için Kaydet'e tıklayın.
Sunucu Yapılandırması
Kullananlar: IRC
- Ajanın Kanallar sekmesini açın ve IRC'nin yanındaki Bağlan düğmesine tıklayın.
- Sunucu adresini, bağlantı noktasını, takma adı ve isteğe bağlı olarak bir şifre girin.
- Bağlantı kurulduğunda katılacağınız kanalları belirtin.
- Bağlanmak için Kaydet'e tıklayın.
Yerel Uygulama
Kullananlar: Signal, iMessage
- Gerekli uygulamanın ana makinede yüklü ve çalışır durumda olduğundan emin olun:
- Signal -- Signal Desktop yüklü olmalı ve Signal hesabınıza bağlı olmalıdır.
- iMessage -- Messages.app yapılandırılmış macOS ana bilgisayarı gerektirir.
- Ajanın Kanallar sekmesini açın ve kanalın yanındaki Bağlan düğmesine tıklayın.
- Neotask yerel uygulamayı algılayacak ve bağlantı kuracaktır.
- Uygulama algılanmazsa yüklemeniz veya yapılandırmanız istenecektir.
Bağlantı Testi
Herhangi bir kanalı bağladıktan sonra Neotask bağlantıyı doğrulamak için otomatik olarak bir gecikme testi çalıştırır:
- Kanal API'si aracılığıyla bir test mesajı gönderilip alınır.
- Gidiş-dönüş gecikmesi ölçülür ve görüntülenir.
- Test başarısız olursa bir hata mesajı sorunu açıklar (ör. geçersiz token, süresi dolmuş OAuth izni, erişilemeyen sunucu).
Kanal ayarlarından istediğiniz zaman bağlantı testini yeniden çalıştırabilirsiniz.
Kanal İşlemleri
Bir kanal bağlandıktan sonra ajanın Kanallar sekmesinden yönetebilirsiniz.
Etkinleştir / Devre Dışı Bırak
Bağlantıyı kesmeden bir kanalı açıp kapatın. Devre dışı bırakıldığında:
- Ajan o kanalda mesaj dinlemeyi durdurur.
- O kanal üzerinden giden mesaj gönderilmez.
- Bağlantı kimlik bilgileri korunur; böylece yeniden yapılandırma gerektirmeden istediğiniz zaman yeniden etkinleştirebilirsiniz.
Bağlantıyı Test Et
Kanalın erişilebilir ve duyarlı olduğunu doğrulamak için isteğe bağlı bağlantı testi çalıştırın. Test şunları yapar:
- Kanal hizmetine hafif bir API isteği gönderir.
- Gidiş-dönüş gecikmesini milisaniye cinsinden ölçer.
- Sonucu Bağlandı (gecikme ile) veya Başarısız (hata ayrıntılarıyla) olarak raporlar.
Gecikmeyi Görüntüle
Her bağlı kanal, Kanallar sekmesinde en son gecikme okumasını görüntüler. Bu, bir bakışta yavaş veya bozulmuş bağlantıları belirlemenize yardımcı olur. Gecikme şu durumlarda güncellenir:
- Her bağlantı testinden sonra otomatik olarak.
- Kanal etkinken arka planda periyodik olarak.
Bağlantıyı Kes / Çıkış Yap
Bir kanal bağlantısını tamamen kaldırmak için:
- Kanalın yanındaki Bağlantıyı Kes düğmesine tıklayın.
- İletişim kutusundaki eylemi onaylayın.
- Neotask depolanmış kimlik bilgilerini iptal eder veya atar (OAuth token'ları, desteklendiği durumlarda sağlayıcı tarafında iptal edilir).
- Kanal, ajanın etkin kanal listesinden kaldırılır.
Bağlantıyı kestikten sonra yeniden bağlanmak için orijinal bağlantı adımlarını tekrarlayın.