Telegram | ElevenLabs Documentation

Connetti i tuoi agenti ElevenLabs a Telegram

Panoramica

Collega i tuoi agenti IA di ElevenLabs a Telegram per rispondere ai messaggi inviati al tuo bot. Questa integrazione consente ai tuoi agenti di ricevere messaggi in arrivo in chat private e gruppi, cercare informazioni sulle chat, inviare risposte e reagire ai messaggi tramite l’API Bot di Telegram.

Funzionalità

Funzionalità	Supporto
Modalità senza conservazione (ZRM)	Non supportata
Allegati nei trigger	Non supportati — foto, file e altri contenuti multimediali nei messaggi in arrivo non vengono inoltrati all’agente
Allegati negli strumenti	Non supportati — gli strumenti operano solo sul testo

Configurazione

Crea un bot Telegram

Apri Telegram e avvia una conversazione con @BotFather. Invia /newbot e segui le istruzioni per scegliere un nome e un username per il tuo bot. BotFather ti risponderà con un token del bot.

Connetti in ElevenLabs

Nella configurazione dell’integrazione di ElevenLabs, fai clic su Connetti e incolla il token del bot fornito da BotFather.

Abilita il trigger

Dopo la connessione, abilita il trigger Messaggio Telegram e seleziona l’agente che deve gestire i messaggi in arrivo. ElevenLabs registrerà automaticamente un webhook con Telegram, così il tuo bot inizierà a ricevere messaggi.

Usare il bot nei gruppi

Il bot non deve essere un amministratore del gruppo e non devi disabilitare la modalità privacy di Telegram. Con la modalità privacy attiva (impostazione predefinita), Telegram invia i messaggi che si rivolgono esplicitamente al bot, ovvero esattamente quelli ascoltati da questa integrazione:

Menzioni con @ dello username del bot, ad esempio @my_bot qual è lo stato?.
Risposte ai messaggi del bot, inclusi i turni successivi della stessa conversazione.

I messaggi che non si rivolgono al bot vengono ignorati per progettazione. Il bot ignora anche i messaggi di altri bot e non agisce su messaggi modificati o eliminati.

Telegram applica le modifiche alla modalità privacy e al ruolo di amministratore solo ai gruppi a cui il bot si unisce dopo la modifica. Se in precedenza hai attivato o disattivato la modalità privacy in @BotFather, oppure hai reso il bot amministratore di un gruppo per “risolvere” le menzioni, rimuovi il bot dal gruppo e aggiungilo di nuovo affinché la nuova impostazione abbia effetto: di solito è questo che fa iniziare a funzionare le menzioni, non il ruolo di amministratore in sé.

Nelle chat di gruppo e supergruppo, la risposta dell’agente viene inviata come risposta citata al messaggio che ha attivato il trigger, così resta visivamente collegata alla domanda anche quando la chat è molto attiva. Nelle chat private 1:1, la risposta citata viene soppressa perché sarebbe ridondante.

Strumenti dell’agente

Quando aggiungi strumenti Telegram a un agente, sono disponibili i seguenti strumenti integrati:

Strumento	Descrizione
`telegram_get_chat`	Recupera i metadati della chat corrente, come tipo, titolo, username e descrizione. Il valore `chat_id` è associato alla conversazione corrente e non può essere reindirizzato.
`telegram_send_message`	Invia un messaggio di testo alla chat corrente. `chat_id` è associato; il modello controlla `text` e l’opzionale `parse_mode` (`HTML`, `Markdown` o `MarkdownV2`).
`telegram_react_to_message`	Reagisce al messaggio che ha attivato il trigger con una singola emoji dell’insieme di reazioni consentite ai bot di Telegram — utile quando un breve riconoscimento (`👍`, `🎉`, `❤`) è più naturale di una risposta testuale. Sia `chat_id` sia `message_id` sono associati al turno di origine. L’impostazione di una nuova reazione sostituisce qualsiasi reazione precedentemente impostata dal bot sullo stesso messaggio.

Alcune chat limitano le emoji consentite tramite l’impostazione Reazioni disponibili di Telegram. Se una chiamata di reazione viene rifiutata, indica all’agente di ripiegare su una risposta testuale.

Variabili dinamiche

Quando un agente viene eseguito da Telegram, le seguenti variabili dinamiche sono disponibili nei prompt e negli strumenti:

Variabile	Descrizione
`integration__telegram_chat_id`	ID della chat Telegram in cui si svolge la conversazione.
`integration__telegram_message_id`	`message_id` Telegram del messaggio dell’utente che ha attivato il turno corrente dell’agente.
`integration__telegram_connection_id`	ID della connessione dell’integrazione ElevenLabs.

Consulta le variabili dinamiche per scoprire come farvi riferimento nei prompt e nelle chiamate degli strumenti.