Telegram | ElevenLabs Documentation

Un bot Telegram consente al tuo receptionist di inviare messaggi a te o al gruppo del tuo team durante una chiamata, ad esempio quando un chiamante chiede di essere richiamato o segnala qualcosa di urgente. Lo strumento webhook chiama il metodo sendMessage dell’API Bot di Telegram.

Crea un bot e trova l’ID chat

Crea il bot

In Telegram, apri una chat con @BotFather, invia /newbot e segui le istruzioni per assegnargli un nome. BotFather risponde con un token bot, ad esempio 123456789:AA.... Trattalo come un segreto: chiunque lo possieda controlla il bot.

Avvia una chat con il bot

I bot possono inviare messaggi solo alle chat di cui fanno parte.

Per inviare messaggi a te stesso: apri una chat con il tuo nuovo bot e seleziona Start.
Per inviare messaggi a un gruppo: aggiungi il bot al gruppo, quindi invia un messaggio che lo menzioni, ad esempio /start@YOUR_BOT_NAME.

Trova l’ID chat

In un browser, apri https://api.telegram.org/botBOT_TOKEN/getUpdates, sostituendo BOT_TOKEN con il token del tuo bot. Trova il tuo messaggio nella risposta e copia il numero dopo "chat":{"id":. L’ID di un gruppo è negativo, ad esempio -1001234567890; mantieni il segno meno.

Se la risposta è vuota, invia un altro messaggio al bot e ricarica la pagina.

Crea lo strumento webhook

Vai a Integrazioni, seleziona Aggiungi integrazione e scegli Webhook Tool.

Campo	Valore
Nome	`notify_team_in_telegram`
Descrizione	”Invia un messaggio al team su Telegram. Usalo quando un chiamante chiede di essere richiamato, vuole parlare con una persona o segnala un problema urgente.”
Metodo	POST
URL	`https://api.telegram.org/botBOT_TOKEN/sendMessage`, sostituendo `BOT_TOKEN` con il token del tuo bot
Parametri body	`chat_id` (stringa, obbligatorio): “Sempre l’esatto valore `CHAT_ID`.” `text` (stringa, obbligatorio): “Il messaggio: nome e numero di telefono del chiamante, e di cosa ha bisogno.”
Assegna agli agenti	Receptionist

Sostituisci CHAT_ID nella descrizione con l’ID della tua chat. L’URL contiene il token del bot, quindi trattalo anch’esso come un segreto.

Seleziona Abilita, quindi testa il tuo receptionist chiedendo di essere richiamato. Il bot pubblica il messaggio nella chat.

Per inviare messaggi a più chat, crea uno strumento per ogni ID chat. Lo stesso bot può pubblicare messaggi in tutte.

Risoluzione dei problemi

Problema	Cosa verificare
Telegram restituisce 401	Il token del bot nell’URL è errato o è stato revocato in BotFather. L’URL deve contenere `bot` subito prima del token.
`Bad Request: chat not found`	Verifica l’ID chat, incluso il segno meno per i gruppi, e di aver avviato una chat con il bot o di averlo aggiunto al gruppo.
`Forbidden: bot was kicked`	Il bot è stato rimosso dal gruppo. Aggiungilo di nuovo.
`getUpdates` non mostra nulla	Nei gruppi, i bot vedono solo i messaggi che li menzionano. Invia `/start@YOUR_BOT_NAME` e ricarica.
Il receptionist non pubblica mai	Assicurati che la descrizione dello strumento indichi le situazioni in cui deve pubblicare un messaggio.