Verdent Docs
Temel özellikler

Anlık mesajlaşma

Telegram, Slack veya Feishu üzerinden Manager'a iş atayın

Manager'a iş atamak için bilgisayarınızın başında olmanıza gerek yok. Telegram, Slack veya Feishu'yu bağlayarak, tanıdık sohbet araçlarını kullanarak istediğiniz zaman, istediğiniz yerden Manager'a mesaj gönderebilirsiniz. Manager mesajlarınızı yapılandırılmış görevlere dönüştürür ve çalıştırmaya başlar; telefonunuzda gezinirken bir fikir yakalayın ve sonucu görmek için daha sonra geri dönün.

Desteklenen anlık mesajlaşma platformları

PlatformTür
TelegramKişisel bot
SlackÇalışma alanı botu
FeishuKurumsal bot

Her platform, kendi geliştirici konsolunda bir bot oluşturmayı ve ardından Verdent'te eşleştirmeyi tamamlamayı gerektirir. Bağlantı kurulduktan sonra, bota gönderdiğiniz her mesaj doğrudan Manager'a iletilir.


Bağlantı akışı

Bağlantı sürecinin iki aşaması vardır:

  1. Token girin — kimlik bilgilerinin kurulumu
  2. Eşleştirme için mesaj gönderin — botu Manager'a bağlayın

Her şey Manager'ın kenar çubuğundaki kanal ayarları sayfasında yapılandırılır.

Kuruluma nasıl erişilir

Kanal ekle'yi açın

Manager'ın sol kenar çubuğunda, üstteki + düğmesine tıklayın (Kanal ekle).

Bir platform seçin

Bağlamak istediğiniz platformu seçin (Telegram, Slack veya Feishu).

Yönlendirilen adımları izleyin

Yan panelde iki aşamalı kurulumu tamamlayın.


Telegram kurulumu

1. aşama: Bot oluşturun ve token alın

BotFather'a mesaj gönderin

Telegram'da @BotFather'ı bulun ve /newbot gönderin.

Botunuza ad verin

Bir görünen ad ve kullanıcı adı sağlamak için yönergeleri izleyin.

Token'ı kopyalayın

Oluşturduktan sonra BotFather, 123456:ABC-DEF1234... biçiminde bir token döndürür.

Verdent'e yapıştırın

Token'ı Verdent kurulum panelindeki Bot Token alanına yapıştırın ve onaylayın.

2. aşama: Mesajla eşleştirme

Bir mesaj gönderin

Yeni botunuzu Telegram'da açın ve herhangi bir mesaj gönderin (örneğin, hello).

Eşleştirme kodunu alın

Bot otomatik olarak bir eşleştirme koduyla yanıt verir.

Verdent'te onaylayın

Kodu Verdent panelinde girin ve onaylayın. Bağlantı artık tamamlanmıştır.


Slack kurulumu

1. aşama: Slack uygulaması oluşturun ve token alın

Yeni bir uygulama oluşturun

api.slack.com/apps adresine gidin ve Create New App'e tıklayın.

Sağlanan manifest'i kullanın

From an app manifest seçeneğini seçin ve Verdent tarafından sağlanan JSON manifest'i yapıştırın (arayüzde bir kopyalama düğmesi mevcuttur).

Bir çalışma alanı seçin

Slack çalışma alanını seçin ve uygulamayı oluşturun.

Her iki token'ı kopyalayın

Uygulama ayarlarında Bot Token (xoxb-) ve App Token'ı (xapp-) bulun, ardından her ikisini de Verdent kurulum paneline yapıştırın.

Uygulama adı gereksinimi: Ad 80 karakterden kısa olmalı ve Çince, Japonca veya Korece karakter içermemelidir.

2. aşama: Mesajla eşleştirme

Telegram ile aynı: bota bir mesaj gönderin, eşleştirme kodunu alın, ardından bağlantıyı tamamlamak için Verdent'te girin.


Feishu kurulumu

Feishu, Telegram veya Slack'ten biraz daha fazla adım gerektirir; izinler ayrı olarak yapılandırılır ve olaylara manuel olarak abone olunması gerekir. Karmaşık değildir ama her adımın doğru yapılması gerekir, aksi takdirde bağlantı takılır. Bunları sırayla izleyin.

1. adım: Özel bir uygulama oluşturun

Geliştirici konsolunu açın

Feishu Open Platform adresine gidin ve Feishu hesabınızla oturum açın.

Özel bir uygulama oluşturun

Sağ üst köşedeki Create Custom App'e tıklayın.

Temel bilgileri doldurun

Uygulama adını ve açıklamasını girin, ardından oluşturmayı tamamlayın.

2. adım: İzinleri yapılandırın

Yeni uygulamayı açın ve sol menüde Permissions & Scopes'a gidin.

Feishu, kapsamları toplu içe aktarmayı destekler, bu nedenle tek tek işaretlemeniz gerekmez. Sayfadaki toplu içe/dışa aktarma girişini bulun ve aşağıdaki JSON'u eksiksiz yapıştırın:

{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}

İçe aktarmayı onayladıktan sonra, yukarıdaki tüm kapsamlar izin listesinde seçili olarak görünmelidir.

3. adım: Kimlik bilgilerini alın ve Verdent'i bağlayın

Sol menüde Credentials & Basic Info'yu açın:

App ID ve App Secret'ı kopyalayın

App ID'yi (cli_xxx... biçiminde) ve App Secret'ı kopyalayın.

Verdent'e yapıştırın

Her iki değeri de Verdent kurulum panelindeki eşleşen alanlara yapıştırın.

Bağlanın

İlk aşamayı tamamlamak için Connect'e tıklayın.

4. adım: Uzun bağlantıyı etkinleştirin

Bağlandıktan sonra, Feishu Open Platform'a geri dönün ve Events & Callbacks'i açın.

Use Long Connection to Receive Events'i açın. Bu anahtar, Feishu'nun mesajları bota nasıl ilettiğini kontrol eder; uzun bağlantı, herkese açık bir URL göstermenizi gerektirmez, bunun yerine kalıcı bir bağlantı tutar, bu da daha güvenilirdir.

5. adım: Mesaj olaylarına abone olun ve yayınlayın

Hâlâ Events & Callbacks sayfasındayken:

Mesaj olayını ekleyin

Add Event'e tıklayın, ardından im.message.receive_v1'i (Mesaj Alma olayı) arayın ve ekleyin.

Bir sürüm oluşturun ve yayınlayın

Sağ üst köşedeki Create and Publish Version'a tıklayın, sürüm notlarını doldurun ve onaylayın.

Verdent ile eşleştirin

Yayınladıktan sonra Verdent'e geri dönün ve eşleştirmeyi tamamlamak için Feishu botunuza bir mesaj gönderin.

Her izin ne işe yarar

İzinAmaç
im:message:* ailesiBotun, doğrudan mesajlar ve grup @ bahsetmeleri dahil olmak üzere mesajları okumasını ve göndermesini sağlar
im:chat:*Botun ait olduğu konuşmaların listesini okur
im:resourceMesajlara eklenen görselleri, dosyaları ve diğer kaynakları okur
contact:*Bir mesajı kimin gönderdiğini tanımlamak için temel kişi bilgilerini okur
docs:document.content:read / wiki:wiki:readonlyFeishu Docs ve Wiki içeriğini okur, böylece belge bağlantıları bağlam olarak Manager'a aktarılabilir
application:application:self_manageUygulamanın kendi yapılandırmasını yönetir; uzun bağlantı yeteneği için gereklidir

Başarılı bağlantının ardından

Eşleştirildikten sonra, kanal Manager'ın sol kenar çubuğundaki kanal listesinde görünür ve şunları gösterir:

  • Platform simgesi ve kanal adı
  • Bağlantı durumu (Connected / Disconnected / Needs attention)
  • En son mesajın önizlemesi ve zaman damgası
  • Okunmamış mesaj göstergesi (yeşil nokta)

Bu noktadan itibaren, bota gönderilen her mesaj doğrudan Manager tarafından çalıştırılabilir bir görev olarak işlenir.


Bağlı kanalları yönetme

  • Tüm kanalları görüntüleyin — bağlı tüm IM kanalları kenar çubuğunda listelenir.
  • Bir kanalı silin — bir kanalın üzerine gelin ve sil'e tıklayın, ardından onaylayın. Bu, o türün son kanalıysa, bot yapılandırması da temizlenir.
  • Yeniden bağlanın — bir kanal Disconnected veya Needs attention gösteriyorsa, yeniden yapılandırma için üstte bir onarım istemi görünür.

Kullanım senaryoları

Mobil komuta merkezi

Yoldayken, botunuza Telegram'da şunu söyleyin: "Main dalındaki en son değişiklikleri staging'e dağıt." Geri döndüğünüzde sonuç hazır olur.

Ekip iş birliği

Bugünün PR durumlarını özetlemek için bir Slack kanalında Manager botunuzdan bahsedin; yanıtlar doğrudan kanalda görünür, böylece tüm ekip görebilir.

Hızlı fikir yakalama

Yatmadan önce bota bir fikir gönderin ve Manager'dan bunu yarın çalıştırılacak bir göreve dönüştürmesini isteyin.