Telegram | ElevenLabs Documentation

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 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, 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 door om een terugbelverzoek te vragen. De bot plaatst het bericht in de chat.

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.