> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Telegram

Ein Telegram-Bot ermöglicht es Ihrem Rezeptionisten, Ihnen oder der Gruppe Ihres Teams während eines Anrufs Nachrichten zu senden, etwa wenn ein Anrufer um einen Rückruf bittet oder etwas Dringendes meldet. Das [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) ruft die Methode `sendMessage` der Bot API von Telegram auf.

## Bot erstellen und Chat-ID finden

### Bot erstellen

Öffnen Sie in Telegram einen Chat mit [@BotFather](https://t.me/BotFather), senden Sie `/newbot` und folgen Sie den Anweisungen zum Benennen des Bots. BotFather antwortet mit einem Bot-Token wie `123456789:AA...`. Behandeln Sie ihn vertraulich: Jeder, der ihn besitzt, kontrolliert den Bot.

### Chat mit dem Bot starten

Bots können nur Nachrichten an Chats senden, in denen sie Mitglied sind.

* **Um sich selbst eine Nachricht zu senden:** Öffnen Sie einen Chat mit Ihrem neuen Bot und wählen Sie **Starten**.
* **Um einer Gruppe eine Nachricht zu senden:** Fügen Sie den Bot zur Gruppe hinzu und senden Sie dann eine Nachricht, in der Sie ihn erwähnen, etwa `/start@YOUR_BOT_NAME`.

### Chat-ID finden

Öffnen Sie in einem Browser `https://api.telegram.org/botBOT_TOKEN/getUpdates` und ersetzen Sie `BOT_TOKEN` durch Ihr Bot-Token. Suchen Sie Ihre Nachricht in der Antwort und kopieren Sie die Zahl nach `"chat":{"id":`. Die ID einer Gruppe ist negativ, zum Beispiel `-1001234567890`; behalten Sie das Minuszeichen bei.

Wenn die Antwort leer ist, senden Sie dem Bot eine weitere Nachricht und laden Sie die Seite neu.

## Webhook-Tool erstellen

Gehen Sie zu **Integrationen**, wählen Sie **Integration hinzufügen** und dann **Webhook-Tool**.

| Feld                 | Wert                                                                                                                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `notify_team_in_telegram`                                                                                                                                                     |
| **Beschreibung**     | "Dem Team auf Telegram eine Nachricht senden. Verwenden, wenn ein Anrufer um einen Rückruf bittet, mit einer Person sprechen möchte oder ein dringendes Problem meldet."      |
| **Methode**          | POST                                                                                                                                                                          |
| **URL**              | `https://api.telegram.org/botBOT_TOKEN/sendMessage`, wobei Sie `BOT_TOKEN` durch Ihr Bot-Token ersetzen                                                                       |
| **Body-Parameter**   | `chat_id` (String, erforderlich): "Immer genau der Wert `CHAT_ID`."  `text` (String, erforderlich): "Die Nachricht: Name und Telefonnummer des Anrufers sowie sein Anliegen." |
| **Agenten zuweisen** | **Rezeptionist**                                                                                                                                                              |

Ersetzen Sie `CHAT_ID` in der Beschreibung durch Ihre Chat-ID. Die URL enthält Ihr Bot-Token. Behandeln Sie sie daher ebenfalls vertraulich.

Wählen Sie **Aktivieren** und [testen Sie Ihren Rezeptionisten](/docs/de/reception-ai/receptionist/testing), indem Sie um einen Rückruf bitten. Der Bot veröffentlicht die Nachricht im Chat.

> **Tip**
>
> Um mehreren Chats Nachrichten zu senden, erstellen Sie ein Tool pro Chat-ID. Derselbe Bot kann in allen posten.

## Fehlerbehebung

| Problem                       | Prüfen Sie Folgendes                                                                                                                                     |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Telegram gibt 401 zurück      | Das Bot-Token in der URL ist falsch oder wurde in BotFather widerrufen. Direkt vor dem Token muss in der URL `bot` stehen.                               |
| `Bad Request: chat not found` | Prüfen Sie die Chat-ID, einschließlich des Minuszeichens bei Gruppen, und ob Sie einen Chat mit dem Bot gestartet oder ihn zur Gruppe hinzugefügt haben. |
| `Forbidden: bot was kicked`   | Der Bot wurde aus der Gruppe entfernt. Fügen Sie ihn wieder hinzu.                                                                                       |
| `getUpdates` zeigt nichts an  | In Gruppen sehen Bots nur Nachrichten, in denen sie erwähnt werden. Senden Sie `/start@YOUR_BOT_NAME` und laden Sie neu.                                 |
| Der Rezeptionist postet nie   | Nennen Sie in der Beschreibung des Tools die Situationen, in denen es posten soll.                                                                       |