# Anlık mesajlaşma (/tr/docs/verdent-manager/core-features/instant-messaging)

> 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ı [#desteklenen-anlık-mesajlaşma-platformları]

| Platform | Tür                |
| -------- | ------------------ |
| Telegram | Kişisel bot        |
| Slack    | Çalışma alanı botu |
| Feishu   | Kurumsal 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ı-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 [#kuruluma-nasıl-erişilir]

<Steps>
  <Step title="Kanal ekle'yi açın">
    Manager'ın sol kenar çubuğunda, üstteki &#x2A;*+** düğmesine tıklayın (Kanal ekle).
  </Step>

  <Step title="Bir platform seçin">
    Bağlamak istediğiniz platformu seçin (Telegram, Slack veya Feishu).
  </Step>

  <Step title="Yönlendirilen adımları izleyin">
    Yan panelde iki aşamalı kurulumu tamamlayın.
  </Step>
</Steps>

***

## Telegram kurulumu [#telegram-kurulumu]

### 1. aşama: Bot oluşturun ve token alın [#1-aşama-bot-oluşturun-ve-token-alın]

<Steps>
  <Step title="BotFather'a mesaj gönderin">
    Telegram'da [@BotFather](https://t.me/BotFather)'ı bulun ve `/newbot` gönderin.
  </Step>

  <Step title="Botunuza ad verin">
    Bir görünen ad ve kullanıcı adı sağlamak için yönergeleri izleyin.
  </Step>

  <Step title="Token'ı kopyalayın">
    Oluşturduktan sonra BotFather, `123456:ABC-DEF1234...` biçiminde bir token döndürür.
  </Step>

  <Step title="Verdent'e yapıştırın">
    Token'ı Verdent kurulum panelindeki **Bot Token** alanına yapıştırın ve onaylayın.
  </Step>
</Steps>

### 2. aşama: Mesajla eşleştirme [#2-aşama-mesajla-eşleştirme]

<Steps>
  <Step title="Bir mesaj gönderin">
    Yeni botunuzu Telegram'da açın ve herhangi bir mesaj gönderin (örneğin, `hello`).
  </Step>

  <Step title="Eşleştirme kodunu alın">
    Bot otomatik olarak bir eşleştirme koduyla yanıt verir.
  </Step>

  <Step title="Verdent'te onaylayın">
    Kodu Verdent panelinde girin ve onaylayın. Bağlantı artık tamamlanmıştır.
  </Step>
</Steps>

***

## Slack kurulumu [#slack-kurulumu]

### 1. aşama: Slack uygulaması oluşturun ve token alın [#1-aşama-slack-uygulaması-oluşturun-ve-token-alın]

<Steps>
  <Step title="Yeni bir uygulama oluşturun">
    [api.slack.com/apps](https://api.slack.com/apps) adresine gidin ve **Create New App**'e tıklayın.
  </Step>

  <Step title="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).
  </Step>

  <Step title="Bir çalışma alanı seçin">
    Slack çalışma alanını seçin ve uygulamayı oluşturun.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

### 2. aşama: Mesajla eşleştirme [#2-aşama-mesajla-eşleştirme-1]

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-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 [#1-adım-özel-bir-uygulama-oluşturun]

<Steps>
  <Step title="Geliştirici konsolunu açın">
    [Feishu Open Platform](https://open.feishu.cn/app) adresine gidin ve Feishu hesabınızla oturum açın.
  </Step>

  <Step title="Özel bir uygulama oluşturun">
    Sağ üst köşedeki **Create Custom App**'e tıklayın.
  </Step>

  <Step title="Temel bilgileri doldurun">
    Uygulama adını ve açıklamasını girin, ardından oluşturmayı tamamlayın.
  </Step>
</Steps>

### 2. adım: İzinleri yapılandırın [#2-adım-i̇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:

```json
{
  "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 [#3-adım-kimlik-bilgilerini-alın-ve-verdenti-bağlayın]

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

<Steps>
  <Step title="App ID ve App Secret'ı kopyalayın">
    **App ID**'yi (`cli_xxx...` biçiminde) ve **App Secret**'ı kopyalayın.
  </Step>

  <Step title="Verdent'e yapıştırın">
    Her iki değeri de Verdent kurulum panelindeki eşleşen alanlara yapıştırın.
  </Step>

  <Step title="Bağlanın">
    İlk aşamayı tamamlamak için **Connect**'e tıklayın.
  </Step>
</Steps>

### 4. adım: Uzun bağlantıyı etkinleştirin [#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 [#5-adım-mesaj-olaylarına-abone-olun-ve-yayınlayın]

Hâlâ **Events & Callbacks** sayfasındayken:

<Steps>
  <Step title="Mesaj olayını ekleyin">
    **Add Event**'e tıklayın, ardından `im.message.receive_v1`'i (Mesaj Alma olayı) arayın ve ekleyin.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

### Her izin ne işe yarar [#her-izin-ne-işe-yarar]

| İzin                                                | Amaç                                                                                                         |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `im:message:*` ailesi                               | Botun, 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:resource`                                       | Mesajlara 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:readonly` | Feishu Docs ve Wiki içeriğini okur, böylece belge bağlantıları bağlam olarak Manager'a aktarılabilir         |
| `application:application:self_manage`               | Uygulamanı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 [#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 [#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ı [#kullanım-senaryoları]

<CardGroup cols="3">
  <Card title="Mobil komuta merkezi" icon="mobile">
    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.
  </Card>

  <Card title="Ekip iş birliği" icon="users">
    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.
  </Card>

  <Card title="Hızlı fikir yakalama" icon="lightbulb">
    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.
  </Card>
</CardGroup>