# Instant Messaging (/de/docs/verdent-manager/core-features/instant-messaging)

> Weisen Sie Manager Aufgaben über Telegram, Slack oder Feishu zu



Sie müssen nicht an Ihrem Computer sitzen, um Manager Aufgaben zuzuweisen. Indem Sie Telegram, Slack oder Feishu verbinden, können Sie Manager jederzeit und von überall aus mit den gewohnten Chat-Tools Nachrichten senden. Manager wandelt Ihre Nachrichten in strukturierte Aufgaben um und beginnt mit deren Ausführung – halten Sie eine Idee fest, während Sie auf dem Handy scrollen, und schauen Sie später vorbei, um das Ergebnis zu sehen.

## Unterstützte Instant-Messaging-Plattformen [#unterstützte-instant-messaging-plattformen]

| Plattform | Typ                 |
| --------- | ------------------- |
| Telegram  | Persönlicher Bot    |
| Slack     | Arbeitsbereichs-Bot |
| Feishu    | Unternehmens-Bot    |

Für jede Plattform müssen Sie in deren Entwicklerkonsole einen Bot erstellen und anschließend die Kopplung in Verdent abschließen. Nach der Verbindung wird jede Nachricht, die Sie an den Bot senden, direkt an Manager weitergeleitet.

***

## Verbindungsablauf [#verbindungsablauf]

Der Verbindungsprozess umfasst zwei Phasen:

1. **Token eingeben** – Einrichtung der Zugangsdaten
2. **Nachricht zur Kopplung senden** – Verknüpfung des Bots mit Manager

Alles wird auf der Kanaleinstellungsseite in der Seitenleiste von Manager konfiguriert.

### So gelangen Sie zur Einrichtung [#so-gelangen-sie-zur-einrichtung]

<Steps>
  <Step title="Add Channel öffnen">
    Klicken Sie in der linken Seitenleiste von Manager oben auf die Schaltfläche &#x2A;*+** (Add Channel).
  </Step>

  <Step title="Plattform auswählen">
    Wählen Sie die Plattform aus, die Sie verbinden möchten (Telegram, Slack oder Feishu).
  </Step>

  <Step title="Geführten Schritten folgen">
    Schließen Sie die zweistufige Einrichtung im Seitenpanel ab.
  </Step>
</Steps>

***

## Telegram-Einrichtung [#telegram-einrichtung]

### Phase 1: Bot erstellen und Token abrufen [#phase-1-bot-erstellen-und-token-abrufen]

<Steps>
  <Step title="Nachricht an BotFather senden">
    Suchen Sie [@BotFather](https://t.me/BotFather) auf Telegram und senden Sie `/newbot`.
  </Step>

  <Step title="Bot benennen">
    Folgen Sie den Anweisungen, um einen Anzeigenamen und einen Benutzernamen anzugeben.
  </Step>

  <Step title="Token kopieren">
    Nach der Erstellung gibt BotFather einen Token in der Form `123456:ABC-DEF1234...` zurück.
  </Step>

  <Step title="In Verdent einfügen">
    Fügen Sie den Token in das Feld **Bot Token** im Einrichtungspanel von Verdent ein und bestätigen Sie.
  </Step>
</Steps>

### Phase 2: Kopplung per Nachricht [#phase-2-kopplung-per-nachricht]

<Steps>
  <Step title="Nachricht senden">
    Öffnen Sie Ihren neuen Bot in Telegram und senden Sie eine beliebige Nachricht (zum Beispiel `hello`).
  </Step>

  <Step title="Kopplungscode empfangen">
    Der Bot antwortet automatisch mit einem Kopplungscode.
  </Step>

  <Step title="In Verdent bestätigen">
    Geben Sie den Code im Panel von Verdent ein und bestätigen Sie. Die Verbindung ist jetzt abgeschlossen.
  </Step>
</Steps>

***

## Slack-Einrichtung [#slack-einrichtung]

### Phase 1: Slack-App erstellen und Tokens abrufen [#phase-1-slack-app-erstellen-und-tokens-abrufen]

<Steps>
  <Step title="Neue App erstellen">
    Gehen Sie zu [api.slack.com/apps](https://api.slack.com/apps) und klicken Sie auf **Create New App**.
  </Step>

  <Step title="Bereitgestelltes Manifest verwenden">
    Wählen Sie **From an app manifest** und fügen Sie das von Verdent bereitgestellte JSON-Manifest ein (in der Benutzeroberfläche steht eine Schaltfläche zum Kopieren zur Verfügung).
  </Step>

  <Step title="Arbeitsbereich auswählen">
    Wählen Sie den Slack-Arbeitsbereich aus und erstellen Sie die App.
  </Step>

  <Step title="Beide Tokens kopieren">
    Suchen Sie in den App-Einstellungen nach dem **Bot Token** (`xoxb-`) und dem **App Token** (`xapp-`) und fügen Sie beide in das Einrichtungspanel von Verdent ein.
  </Step>
</Steps>

<Note>
  **Anforderung an den App-Namen:** Der Name muss weniger als 80 Zeichen umfassen und darf keine chinesischen, japanischen oder koreanischen Zeichen enthalten.
</Note>

### Phase 2: Kopplung per Nachricht [#phase-2-kopplung-per-nachricht-1]

Wie bei Telegram: Senden Sie eine Nachricht an den Bot, empfangen Sie den Kopplungscode und geben Sie ihn dann in Verdent ein, um die Verbindung abzuschließen.

***

## Feishu-Einrichtung [#feishu-einrichtung]

Feishu erfordert etwas mehr Schritte als Telegram oder Slack – Berechtigungen werden separat konfiguriert, und Ereignisse müssen manuell abonniert werden. Das ist nicht kompliziert, aber jeder Schritt muss korrekt ausgeführt werden, sonst stockt die Verbindung. Führen Sie sie in der angegebenen Reihenfolge aus.

### Schritt 1: Eine benutzerdefinierte App erstellen [#schritt-1-eine-benutzerdefinierte-app-erstellen]

<Steps>
  <Step title="Entwicklerkonsole öffnen">
    Gehen Sie zur [Feishu Open Platform](https://open.feishu.cn/app) und melden Sie sich mit Ihrem Feishu-Konto an.
  </Step>

  <Step title="Benutzerdefinierte App erstellen">
    Klicken Sie oben rechts auf **Create Custom App**.
  </Step>

  <Step title="Grunddaten ausfüllen">
    Geben Sie den App-Namen und die Beschreibung ein und schließen Sie die Erstellung ab.
  </Step>
</Steps>

### Schritt 2: Berechtigungen konfigurieren [#schritt-2-berechtigungen-konfigurieren]

Öffnen Sie die neue App und rufen Sie im linken Menü **Permissions & Scopes** auf.

Feishu unterstützt den Massenimport von Scopes, sodass Sie diese nicht einzeln anhaken müssen. Suchen Sie auf der Seite den Ein-/Ausgabepunkt für den Massenimport und fügen Sie das folgende JSON vollständig ein:

```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": []
  }
}
```

Nachdem Sie den Import bestätigt haben, sollten alle oben genannten Scopes in der Berechtigungsliste als ausgewählt angezeigt werden.

### Schritt 3: Zugangsdaten abrufen und Verdent verbinden [#schritt-3-zugangsdaten-abrufen-und-verdent-verbinden]

Öffnen Sie im linken Menü **Credentials & Basic Info**:

<Steps>
  <Step title="App ID und App Secret kopieren">
    Kopieren Sie die **App ID** (in der Form `cli_xxx...`) und das **App Secret**.
  </Step>

  <Step title="In Verdent einfügen">
    Fügen Sie beide Werte in die entsprechenden Felder im Einrichtungspanel von Verdent ein.
  </Step>

  <Step title="Verbinden">
    Klicken Sie auf **Connect**, um die erste Phase abzuschließen.
  </Step>
</Steps>

### Schritt 4: Dauerverbindung aktivieren [#schritt-4-dauerverbindung-aktivieren]

Kehren Sie nach dem Verbinden zur Feishu Open Platform zurück und öffnen Sie **Events & Callbacks**.

Aktivieren Sie **Use Long Connection to Receive Events**. Dieser Schalter steuert, wie Feishu Nachrichten an den Bot zustellt – bei einer Dauerverbindung müssen Sie keine öffentliche URL freigeben; stattdessen wird eine dauerhafte Verbindung aufrechterhalten, was zuverlässiger ist.

### Schritt 5: Nachrichtenereignisse abonnieren und veröffentlichen [#schritt-5-nachrichtenereignisse-abonnieren-und-veröffentlichen]

Weiterhin auf der Seite **Events & Callbacks**:

<Steps>
  <Step title="Nachrichtenereignis hinzufügen">
    Klicken Sie auf **Add Event** und suchen Sie dann nach `im.message.receive_v1` (Ereignis „Nachricht empfangen"), um es hinzuzufügen.
  </Step>

  <Step title="Version erstellen und veröffentlichen">
    Klicken Sie oben rechts auf **Create and Publish Version**, tragen Sie die Versionshinweise ein und bestätigen Sie.
  </Step>

  <Step title="Mit Verdent koppeln">
    Gehen Sie nach der Veröffentlichung zurück zu Verdent und senden Sie eine Nachricht an Ihren Feishu-Bot, um die Kopplung abzuschließen.
  </Step>
</Steps>

### Wozu jede Berechtigung dient [#wozu-jede-berechtigung-dient]

| Berechtigung                                        | Zweck                                                                                                                 |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `im:message:*`-Familie                              | Ermöglicht dem Bot, Nachrichten zu lesen und zu senden, einschließlich Direktnachrichten und @-Erwähnungen in Gruppen |
| `im:chat:*`                                         | Liest die Liste der Unterhaltungen, denen der Bot angehört                                                            |
| `im:resource`                                       | Liest Bilder, Dateien und andere an Nachrichten angehängte Ressourcen                                                 |
| `contact:*`                                         | Liest grundlegende Kontaktinformationen, um zu erkennen, wer eine Nachricht gesendet hat                              |
| `docs:document.content:read` / `wiki:wiki:readonly` | Liest Feishu-Docs- und Wiki-Inhalte, sodass Dokumentlinks als Kontext an Manager übergeben werden können              |
| `application:application:self_manage`               | Verwaltet die eigene Konfiguration der App; erforderlich für die Dauerverbindungsfunktion                             |

***

## Nach erfolgreicher Verbindung [#nach-erfolgreicher-verbindung]

Nach der Kopplung erscheint der Kanal in der Kanalliste der linken Seitenleiste von Manager und zeigt Folgendes an:

* Plattformsymbol und Kanalname
* Verbindungsstatus (**Connected** / **Disconnected** / **Needs attention**)
* Vorschau und Zeitstempel der letzten Nachricht
* Anzeige für ungelesene Nachrichten (grüner Punkt)

Von diesem Zeitpunkt an wird jede an den Bot gesendete Nachricht direkt von Manager als ausführbare Aufgabe bearbeitet.

***

## Verbundene Kanäle verwalten [#verbundene-kanäle-verwalten]

* **Alle Kanäle anzeigen** – alle verbundenen IM-Kanäle werden in der Seitenleiste aufgeführt.
* **Kanal löschen** – bewegen Sie den Mauszeiger über einen Kanal, klicken Sie auf Löschen und bestätigen Sie. Wenn es sich um den letzten Kanal dieses Typs handelt, wird auch die Bot-Konfiguration gelöscht.
* **Erneut verbinden** – wenn ein Kanal **Disconnected** oder **Needs attention** anzeigt, erscheint oben ein Hinweis zur Reparatur für die Neukonfiguration.

***

## Anwendungsfälle [#anwendungsfälle]

<CardGroup cols="3">
  <Card title="Mobile Kommandozentrale" icon="mobile">
    Sagen Sie dem Bot unterwegs in Telegram: „Deploy die neuesten Änderungen im main-Branch auf Staging." Wenn Sie zurück sind, liegt das Ergebnis bereits vor.
  </Card>

  <Card title="Teamzusammenarbeit" icon="users">
    Erwähnen Sie Ihren Manager-Bot in einem Slack-Kanal, um die heutigen PR-Status zusammenzufassen – die Antworten erscheinen direkt im Kanal, sodass das gesamte Team sie sehen kann.
  </Card>

  <Card title="Schnelle Ideenerfassung" icon="lightbulb">
    Senden Sie dem Bot vor dem Schlafengehen eine Idee und bitten Sie Manager, sie in eine Aufgabe für die Ausführung am nächsten Tag umzuwandeln.
  </Card>
</CardGroup>