DingTalk Bot entegrasyonu

Bir agent'ı DingTalk'a bağladıktan sonra, agent'ın çalışma alanının üyeleri Bot'a DM gönderebilir, bir grupta ondan @ ile bahsedebilir veya doğrudan bir Multica işi oluşturmak için /issue komutunu kullanabilir. Konuşmalar ve çalıştırma kayıtları Multica çalışma alanına kaydedilir.

Bot'u bağlama

Agent'ın oluşturucusu veya bir çalışma alanı sahibi/yöneticisi agent'ı DingTalk'a bağlayabilir. Agent'lar ve DingTalk Bot'ları birebir bağlanır.

1. Stream modunda bir robot oluşturun

1. DingTalk Open Platform'da bir kurum içi uygulama oluşturun.
2. Robot yeteneğini etkinleştirin ve Mesaj Alma Modu'nu Stream Mode olarak ayarlayın.

2. Robota izin verin

Robot Mesaj Gönderme izni (qyapi_robot_sendmsg) varsayılan olarak eklenir. Bot'un adını Multica'da göstermek için, DingTalk Grup Temel Bilgi Yönetimi iznini (qyapi_chat_manage) elle ekleyin.

3. Uygulama kimlik bilgilerini alın

Credentials & Basic Information sayfasını açın ve Client ID (AppKey) ile Client Secret (AppSecret)'i kopyalayın.

4. Agent'ı DingTalk'a bağlayın

1. Multica'ya dönün ve Agent'lar → agent'ınız → Capabilities → Entegrasyonlar'ı açın.
2. DingTalk'a Bağlan'a tıklayın.
3. AppKey ve AppSecret'i girin, sonra gönderin.

5. DingTalk ve Multica hesaplarınızı bağlayın

DingTalk'ta Bot'a DM gönderin veya bir grupta ondan @ ile bahsedin, bir bağlama isteği tetiklenir. Bot'la DM'inizde bir bağlantı alırsınız; yaklaşık 15 dakika geçerlidir. Bağlantıyı açın. Başarı mesajı göründüğünde, hesap bağlama tamamlanır.

DingTalk'ta agent'a iş verme

Doğrudan mesajlar

Bot'a bir mesaj gönderin. Agent işi bitirdiğinde, sonucu DM'de yanıtlar.

Grup sohbetleri

Bot'u bir DingTalk grubuna ekleyin, sonra @your-bot <mesajınız> gönderin. Her takip mesajında Bot'tan yeniden @ ile bahsetmelisiniz. Bot yalnızca kendisinden @ ile bahseden mesajları işler.

Resim gönderme

Doğrudan mesajlar ve grup sohbetleri, metin ve resim içeren mesajları destekler. Desteklenen resim biçimleri PNG, JPEG, GIF, WebP ve BMP'dir. Her mesaj en fazla 4 resim içerebilir, resim başına en fazla 10 MB boyutunda. Dosyalar ve sesli mesajlar şu anda desteklenmiyor.

/issue ile iş oluşturma

Yeni bir Multica işi oluşturmak ve onu Bot'a bağlı agent'a otomatik olarak atamak için /issue <başlık> veya /issue <başlık>{yeni satır}<detaylı açıklama> gönderin. Aynı mesajdaki resimler de işe ek olarak eklenir. Normal sohbet mesajlarının aksine, /issue komutu Multica Sohbet'inde iz bırakmaz.

/new ile yeni bir Sohbet başlatma

Yeni, boş bir Multica Sohbeti oluşturmak ve sonraki DingTalk mesajlarını ona yönlendirmek için /new gönderin. Sohbeti oluşturmak ve o mesajı ilk tur olarak kullanmak için /new <mesaj> gönderin. Önceki Sohbet Multica'da saklı ve kullanılabilir kalır.

/clear ile mevcut bağlamı temizleme

Mevcut Multica Sohbetini korurken sonraki mesaja taze, agent'a görünür bir bağlam uygulamak için /clear gönderin. Sınırdan sonraki ilk tur olarak o mesajı kullanmak için /clear <mesaj> gönderin. Sohbetin tam geçmişi Multica'da görünür kalır.

Bağlantıları yönetme

• Agent'lar → agent'ınız → Capabilities → Entegrasyonlar'da, agent'ın oluşturucusu ve çalışma alanı sahipleri/yöneticileri agent'ı DingTalk'a bağlayabilir veya bağlantısını kesebilir. Bağlandıktan sonra, bu sayfa Bot'un adını, başarıyla mesaj işlediği DingTalk gruplarını ve bu gruplardaki etkinlik durumu verisini gösterir. Agent'a okuma erişimi olan herhangi bir çalışma alanı üyesi bu bilgiyi görebilir. Son 90 günde başarıyla işlenmiş mesajı olmayan gruplar Uzun süredir etkin değil altına yerleştirilir ve genişletildiğinde yüklenir.
• Ayarlar → Entegrasyonlar, görüntüleyenin okuyabileceği, mevcut çalışma alanındaki her DingTalk'a bağlı agent'ı, Bot'un DingTalk gruplarındaki etkinlik durumu verisiyle birlikte listeler. Çalışma alanı sahipleri/yöneticileri, listelenen herhangi bir agent'ın DingTalk bağlantısını da kesebilir. Bağlantı kesildikten sonra, Bot mesaj almayı durdurur, kurulum kaydı ise denetim için saklanır. Çalışma alanı sahipleri/yöneticileri bir grubu da unutabilir. Bu, konuşmaları veya mesajları silmeden grubu listeden kaldırır. Bağlı bir DingTalk hesabına sahip bir çalışma alanı üyesi daha sonra orada Bot'tan @ ile bahsederse ve Multica mesajı kabul ederse, grup yeniden görünür.

Kendi sunucunuzda barındırma kurulumu

Multica Cloud kullanıcıları bu bölümü atlayabilir. Kendi sunucunuzda barındırma için önce DingTalk AppSecret'ini şifrelemek üzere bir anahtar ayarlamalısınız:

MULTICA_DINGTALK_SECRET_KEY=<base64 kodlu 32 baytlık anahtar>

Şununla bir tane üretin:

openssl rand -base64 32

API servisini yeniden başlatın, sonra DingTalk'ı bağlayın. Bu anahtarı kalıcı olarak saklayın: değiştirilir veya kaybedilirse, mevcut token'lar çözülemez ve bağlantının yeniden kurulması gerekir.

Hesap bağlama URL'leri MULTICA_APP_URL'i kullanır, ayarlanmamışsa FRONTEND_ORIGIN'e döner. URL, üyelerin erişebileceği bir Multica adresine işaret etmelidir.

Sırada

• Sohbet entegrasyonları — Kanal motorunun, oturumların ve yetkilendirmenin nasıl çalıştığı
• Agent'lar · Sohbet · İşler
• Ortam değişkenleri — tam kendi sunucunuzda barındırma yapılandırma referansı