> 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

Met een Telegram-bot kan je receptionist jou of de groep van je team tijdens een gesprek een bericht sturen, bijvoorbeeld wanneer een beller om een terugbelverzoek vraagt of iets urgents meldt. De [webhooktool](/docs/nl/reception-ai/integrations/webhooks) roept de methode `sendMessage` van de Bot API van Telegram aan.

## Maak een bot en vind de chat-ID

### Maak de bot

Open in Telegram een chat met [@BotFather](https://t.me/BotFather), stuur `/newbot` en volg de aanwijzingen om de bot een naam te geven. BotFather antwoordt met een bottoken, zoals `123456789:AA...`. Behandel dit als een geheim: iedereen die het heeft, beheert de bot.

### Start een chat met de bot

Bots kunnen alleen berichten sturen naar chats waarin ze zitten.

* **Om jezelf een bericht te sturen:** open een chat met je nieuwe bot en selecteer **Start**.
* **Om een groep een bericht te sturen:** voeg de bot toe aan de groep en stuur vervolgens een bericht waarin je de bot noemt, zoals `/start@YOUR_BOT_NAME`.

### Vind de chat-ID

Open in een browser `https://api.telegram.org/botBOT_TOKEN/getUpdates`, waarbij je je bottoken invult in plaats van `BOT_TOKEN`. Zoek je bericht in het antwoord en kopieer het nummer na `"chat":{"id":`. De ID van een groep is negatief, bijvoorbeeld `-1001234567890`; behoud het minteken.

Als het antwoord leeg is, stuur de bot dan nog een bericht en laad de pagina opnieuw.

## Maak de webhooktool

Ga naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**.

| Veld                 | Waarde                                                                                                                                                                          |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `notify_team_in_telegram`                                                                                                                                                       |
| **Description**      | "Stuur het team een bericht op Telegram. Gebruik dit wanneer een beller om een terugbelverzoek vraagt, met iemand wil spreken of een urgent probleem meldt."                    |
| **Method**           | POST                                                                                                                                                                            |
| **URL**              | `https://api.telegram.org/botBOT_TOKEN/sendMessage`, waarbij je je bottoken invult in plaats van `BOT_TOKEN`                                                                    |
| **Body Parameters**  | `chat_id` (string, vereist): "Altijd exact de waarde `CHAT_ID`."  `text` (string, vereist): "Het bericht: de naam en het telefoonnummer van de beller en wat deze nodig heeft." |
| **Assign to agents** | **Receptionist**                                                                                                                                                                |

Vervang `CHAT_ID` in de beschrijving door je chat-ID. De URL bevat je bottoken, dus behandel die ook als een geheim.

Selecteer **Enable** en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) door om een terugbelverzoek te vragen. De bot plaatst het bericht in de chat.

> **Tip**
>
> Om meerdere chats berichten te sturen, maak je één tool per chat-ID. Dezelfde bot kan in alle chats berichten plaatsen.

## Problemen oplossen

| Probleem                                | Wat je moet controleren                                                                                                                     |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Telegram geeft 401 terug                | Het bottoken in de URL is onjuist of is ingetrokken in BotFather. Vlak vóór het token moet `bot` in de URL staan.                           |
| `Bad Request: chat not found`           | Controleer de chat-ID, inclusief het minteken voor groepen, en of je een chat met de bot hebt gestart of deze aan de groep hebt toegevoegd. |
| `Forbidden: bot was kicked`             | De bot is uit de groep verwijderd. Voeg deze opnieuw toe.                                                                                   |
| `getUpdates` toont niets                | In groepen zien bots alleen berichten waarin ze worden genoemd. Stuur `/start@YOUR_BOT_NAME` en laad opnieuw.                               |
| De receptionist plaatst nooit berichten | Zorg dat de beschrijving van de tool vermeldt in welke situaties deze berichten moet plaatsen.                                              |