> 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 de Telegram permite a tu recepcionista enviarte mensajes a ti o al grupo de tu equipo durante una llamada, por ejemplo cuando alguien pide que le devuelvan la llamada o informa de algo urgente. La [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks) llama al método `sendMessage` de la API de bots de Telegram.

## Crea un bot y busca el ID del chat

### Crea el bot

En Telegram, abre un chat con [@BotFather](https://t.me/BotFather), envía `/newbot` y sigue las indicaciones para darle un nombre. BotFather responderá con un token de bot, como `123456789:AA...`. Trátalo como un secreto: cualquiera que lo tenga controla el bot.

### Inicia un chat con el bot

Los bots solo pueden enviar mensajes a chats en los que están.

* **Para enviarte mensajes a ti:** abre un chat con tu bot nuevo y selecciona **Iniciar**.
* **Para enviar mensajes a un grupo:** añade el bot al grupo y, después, envía un mensaje que lo mencione, como `/start@YOUR_BOT_NAME`.

### Busca el ID del chat

En un navegador, abre `https://api.telegram.org/botBOT_TOKEN/getUpdates`, sustituyendo `BOT_TOKEN` por el token de tu bot. Busca tu mensaje en la respuesta y copia el número que aparece después de `"chat":{"id":`. El ID de un grupo es negativo, por ejemplo `-1001234567890`; conserva el signo menos.

Si la respuesta está vacía, envía otro mensaje al bot y vuelve a cargar la página.

## Crea la herramienta de webhook

Ve a **Integraciones**, selecciona **Añadir integración** y elige **Webhook Tool**.

| Campo                     | Valor                                                                                                                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                | `notify_team_in_telegram`                                                                                                                                                             |
| **Descripción**           | "Envía un mensaje al equipo en Telegram. Úsala cuando alguien pida que le devuelvan la llamada, quiera hablar con una persona o informe de un problema urgente."                      |
| **Método**                | POST                                                                                                                                                                                  |
| **URL**                   | `https://api.telegram.org/botBOT_TOKEN/sendMessage`, sustituyendo `BOT_TOKEN` por el token de tu bot                                                                                  |
| **Parámetros del cuerpo** | `chat_id` (cadena, obligatorio): "Siempre el valor exacto `CHAT_ID`."  `text` (cadena, obligatorio): "El mensaje: el nombre de quien llama, su número de teléfono y lo que necesita." |
| **Asignar a agentes**     | **Recepcionista**                                                                                                                                                                     |

Sustituye `CHAT_ID` en la descripción por el ID de tu chat. La URL contiene el token de tu bot, así que trátalo también como un secreto.

Selecciona **Activar** y después [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) pidiendo que te devuelvan la llamada. El bot publica el mensaje en el chat.

> **Tip**
>
> Para enviar mensajes a varios chats, crea una herramienta por cada ID de chat. El mismo bot puede publicar en todos ellos.

## Solución de problemas

| Problema                       | Qué comprobar                                                                                                                       |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Telegram devuelve 401          | El token de bot de la URL es incorrecto o se ha revocado en BotFather. La URL debe incluir `bot` justo antes del token.             |
| `Bad Request: chat not found`  | Comprueba el ID del chat, incluido el signo menos para grupos, y que hayas iniciado un chat con el bot o lo hayas añadido al grupo. |
| `Forbidden: bot was kicked`    | El bot se ha eliminado del grupo. Vuelve a añadirlo.                                                                                |
| `getUpdates` no muestra nada   | En grupos, los bots solo ven mensajes que los mencionan. Envía `/start@YOUR_BOT_NAME` y vuelve a cargar.                            |
| La recepcionista nunca publica | Haz que la descripción de la herramienta indique las situaciones en las que debe publicar.                                          |