> 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

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](/docs/it/reception-ai/integrations/webhooks) 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](https://t.me/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](/docs/it/reception-ai/receptionist/testing) chiedendo di essere richiamato. Il bot pubblica il messaggio nella chat.

> **Tip**
>
> 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.                      |