Sohbet entegrasyonları (kanallar)
Multica agent'larını Feishu, Lark, Slack, DingTalk, WeCom veya Telegram'a bağlayın ve ekibinizin zaten kullandığı sohbet araçlarından onlarla çalışın.
Sohbet entegrasyonları, ekibin bir agent'a soru sormasını, bir grup sohbetinde ondan @ ile bahsetmesini veya sohbet penceresinden iş oluşturmasını sağlar — Multica'yı açmadan.
Feishu/Lark, Slack, DingTalk, WeCom ve Telegram bugün destekleniyor. Hepsi aynı oturum, kimlik ve çalıştırma mekaniğini paylaşır, ama kurulumları farklıdır.
Platform seçin
| Feishu / Lark | Slack | DingTalk | WeCom | Telegram | |
|---|---|---|---|---|---|
| Kurulum | Multica'da bir QR kodu üretin ve Feishu ile tarayarak yetkilendirin | Slack'te bir uygulama oluşturun, sonra iki token'ı Multica'ya yapıştırın | Bir kurum içi uygulama ve Stream modunda bir robot oluşturun, sonra AppKey ve AppSecret'ini Multica'ya yapıştırın | WeCom yönetim konsolunda uzun bağlantısı etkin bir akıllı bot oluşturun, sonra Bot ID ve Secret'ini Multica'ya yapıştırın | @BotFather ile bir Bot oluşturun, sonra token'ını Multica'ya yapıştırın |
| Agent'a DM gönderme | Destekleniyor | Destekleniyor | Destekleniyor | Destekleniyor | Destekleniyor |
| Gruplar veya kanallar | Bot'tan @ ile bahsedilerek tetiklenir | Bot'tan @ ile bahsedilerek tetiklenir | Bot'tan @ ile bahsedilerek tetiklenir | Bot'tan @ ile bahsedilerek tetiklenir | Bot'tan @ ile bahsederek veya ona yanıt vererek tetiklenir |
| İş oluşturma | /issue mesaj komutu; işi girdiğiniz haliyle oluşturur | /issue slash komutu; agent oluşturmadan önce açıklamayı yazar | /issue mesaj komutu; işi girdiğiniz haliyle oluşturur | /issue mesaj komutu; işi girdiğiniz haliyle oluşturur | /issue mesaj komutu; işi girdiğiniz haliyle oluşturur |
| Yeni bir Sohbet başlatma | /new [mesaj] | DM: /new [mesaj]; kanal/thread: @Multica /new [mesaj] | /new [mesaj] | /new [mesaj] | /new [mesaj] |
| Mevcut Sohbet bağlamını temizleme | /clear [mesaj] | DM: /clear [mesaj]; kanal/thread: @Multica /clear [mesaj] | /clear [mesaj] | /clear [mesaj] | /clear [mesaj] |
| Bağlantı | Platform uzun bağlantısı | Socket Mode | Stream mode | Platform uzun bağlantısı | getUpdates long polling |
Yeni bağlantılar şu anda yalnızca anakara Çin Feishu için açık; mevcut uluslararası Lark bağlantıları çalışmaya devam eder ve hâlâ yönetilebilir.
Her Bot bir Multica agent'ına bağlıdır. Aynı sohbet platformunda birden fazla agent kullanmak için her biri için ayrı bir Bot bağlayın.
DingTalk, WeCom ve Telegram topluluk tarafından sürdürülür: her sürümde gönderilirler, ama resmi bir destek SLA'sı taşımazlar. Sorunları GitHub issues'da bildirin.
WeCom bugün metin mesajlarını işler. Sesli, resim ve dosya mesajları bunu açıklayan kısa bir yanıt alır ve agent'a iletilmez.
Telegram bugün metin mesajlarını işler. Desteklenmeyen medya bunu açıklayan kısa bir yanıt alır ve agent'a iletilmez.
Adım adım rehberler:
- Feishu / Lark Bot entegrasyonu
- Slack Bot entegrasyonu
- DingTalk Bot entegrasyonu
- Telegram Bot entegrasyonu
Bir mesaj nasıl işlenir
- Multica, Bot'u çalışma alanına ve agent'ına çözümler.
- Bir grup veya kanalda, yalnızca Bot'tan açıkça @ ile bahseden mesajlar devam eder; DM'lerde bahsetmeye gerek yoktur.
- Multica, gönderenin hesap bağlamasını ve çalışma alanı üyeliğini doğrular.
- Mesaj bir agent sohbetine katılır ve bir çalıştırma oluşturulur.
- Agent'ın yanıtı, orijinal DM'ye veya thread'e geri gönderilir.
Bot'tan @ ile bahsetmeyen kanal mesajları agent'ı hiç tetiklemez ve onun konuşma bağlamına eklenmez.
Sıradan mesajlar bu akışı izler. /issue bir sohbet turu değil, bir komuttur: Multica sonucu kaynak platforma geri gönderir, ama komutu Multica Sohbeti'ne eklemez. Slack'in yerel slash komutu, kendi ayrı asenkron iş oluşturma akışından geçmeye devam eder.
Konuşma kontrolleri
/new yeni bir Multica Sohbeti oluşturur ve o dış konuşmadaki sonraki mesajları ona yönlendirir. /new <mesaj> Sohbeti oluşturur ve mesajı onun ilk turu olarak kullanır. Önceki Sohbet Multica'da saklı ve kullanılabilir kalır.
/clear mevcut Multica Sohbetinde kalır, ama agent'a görünür yeni bir bağlam başlatır. Sohbetin tam geçmişi Multica'da erişilebilir kalır, agent ise sınırdan önceki mesajları alamaz. /clear <mesaj> mesajı yeni bağlamdaki ilk tur olarak kullanır; yalın bir /clear bir sonraki gerçek mesaja uygulanır.
Slack'te /new ve /clear, bir DM'de yerel slash komutlarıdır. Yerel bir slash komut yükü bir kanal thread'ini tanımlamaz, bu yüzden hedef thread içinde @Multica /new [mesaj] veya @Multica /clear [mesaj] kullanın.
Oturum izolasyonu
- Feishu/Lark oturumları sohbete göre ayırır; aynı sohbetteki sonraki mesajlar aynı oturumu sürdürür.
- Slack, DM'leri kanala göre ayırır; bir kanalda her thread kendi oturumuna sahiptir.
- DingTalk oturumları konuşmaya göre ayırır; her DM veya grup kendi oturumunu sürdürür.
- WeCom oturumları sohbete göre ayırır; her DM veya grup sohbeti kendi oturumunu sürdürür.
- Telegram oturumları sohbete göre ayırır; forum konuları konuya göre izole edilir.
Bir kanaldaki takip mesajları hâlâ taze bir @ bahsetmeye ihtiyaç duyar. Agent yalnızca kendisine hitap eden mesajları alır — kanalın tüm geçmişini otomatik olarak asla okumaz.
Hesap bağlama
Bir üye Bot'a ilk kez mesaj attığında, bir hesap bağlama bağlantısı alır. Multica'da oturum açtıktan sonra, platform hesabı geçerli çalışma alanındaki üyeliğine bağlanır.
Multica, agent'ı yalnızca bağlama tamamlandıktan sonra çalıştırır. Her mesaj hesap bağlamasını ve çalışma alanı üyeliğini yeniden kontrol eder; bir çalışma alanından ayrıldıktan sonra, Bot artık ona ulaşmak için kullanılamaz.
Hesap bağlama yalnızca gönderenin kim olduğunu doğrular. Sohbet platformundaki diğer üyeler Multica çalışma alanına otomatik olarak eklenmez.
Bağlantıları yönetme
Çalışma alanı sahipleri ve yöneticileri Bot'ları bağlayabilir veya bağlantısını kesebilir; Feishu/Lark Bot'ları için bağlama ve bağlantı kesme, agent'ın sahibine de açıktır. Sıradan üyeler bağlı entegrasyonları görüntüleyebilir ve erişimi olan agent'ları kullanabilir.
Bağlantı kesildikten sonra, Bot yeni mesaj almayı durdurur. Mevcut Multica konuşmaları ve çalıştırma kayıtları saklanır.
Kendi sunucunuzda barındırma
Kendi sunucunuzda barındırılan bir kurulum, Multica bağlantı giriş noktasını açmadan önce her platform için 32 baytlık bir şifreleme anahtarı yapılandırmalıdır:
MULTICA_LARK_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>
MULTICA_SLACK_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>
MULTICA_DINGTALK_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>
MULTICA_WECOM_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>
MULTICA_TELEGRAM_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>Bu anahtarlar saklanan Bot kimlik bilgilerini şifreler. Nasıl üretileceği, saklanacağı ve döndürüleceği için bkz. Ortam değişkenleri. Multica Cloud'da bu zaten yapılandırılmıştır.
WeCom'un tek giden yolu tek bir sürecin tuttuğu WebSocket'tir, bu yüzden farklı bir replikada üretilen bir yanıta ne olacağı gerçek zamanlı röle moduna bağlıdır:
- Parçalı veya çift röle modu (
REDIS_URLayarlı — Redis ile varsayılan): yanıt, bağlantıyı tutan replikaya iletilir ve teslim edilir. Çok replikalı WeCom desteklenir. - Eski röle modu veya Redis yok: yanıt düşürülür. Bu yapılandırmada WeCom etkin arka ucu tek bir replika olarak çalıştırın.
Her modda, hiçbir replikanın canlı bağlantı tutmadığı sırada (hepsi yeniden bağlanma ortasında) üretilen bir yanıt teslim edilmez. Bu, yönlendiren replika tarafından multica_wecom_outbound_dropped_total{reason="no_live_connection"} olarak sayılır, böylece bu pencerenin boyutu ölçülebilir; kayıp kabul edilemezse, tek bir replika en tutucu dağıtım biçimi olarak kalır.
Sırada
- Feishu / Lark Bot entegrasyonu — bir QR kodu tarayarak bir agent'ı bağlayın.
- Slack Bot entegrasyonu — bir Slack uygulaması oluşturun ve token'larını Multica'ya yapıştırın.
- DingTalk Bot entegrasyonu — bir Stream modu robotu oluşturun ve kimlik bilgilerini Multica'ya yapıştırın.
- Telegram Bot entegrasyonu — @BotFather ile bir Bot oluşturun ve token'ını Multica'ya yapıştırın.
- Sohbet — her Bot'un arkasındaki konuşma ve çalıştırma modeli.