# Bot de Telegram

> Chatea a solas en un chat privado, lleva personajes a grupos, compártelos en línea o abre la Mini App.

Source: https://reverie.im/es/docs/integrations/telegram-bot
Language: es

El bot de Reverie lleva los personajes a Telegram: un chat privado con el bot, un grupo o un canal que administre. También puede abrir Reverie dentro de Telegram como Mini App, donde puedes comprar créditos con Telegram Stars.

## Configurarlo \[#set-it-up]

### Vincular tu cuenta \[#link-your-account]

Quien hable con un personaje necesita una cuenta de Reverie vinculada a su cuenta de Telegram (basta con una gratuita). Una cuenta de Telegram corresponde exactamente a una cuenta de Reverie.

* **Desde la web.** En la aplicación, ve a **Labs → Bots de Discord y Telegram** y pulsa **Vincular en Telegram** en la tarjeta de Telegram. Telegram abre un chat con el bot; toca **Iniciar** y quedas vinculado a la cuenta con la que has iniciado sesión. La página se actualiza sola.
* **Desde Telegram.** Abre el bot y envía `/start`. **Continuar con Telegram** crea una cuenta gratuita de Reverie a través de la Mini App, sin necesidad de correo. **Ya tengo una cuenta** envía en su lugar un enlace de un solo uso, válido durante **10 minutos**, que une tu Telegram a una cuenta existente; `/link` envía el mismo enlace en cualquier momento.

### Elegir un personaje \[#pick-a-character]

Envía `/chat` para ver con quién puedes hablar (primero los personajes con los que ya hablas aquí, luego sugerencias), o `/chat` seguido de un nombre para buscar. Toca uno y empieza a escribir.

### Llevar personajes a un grupo \[#bring-characters-into-a-group]

Opcional. Añade el bot a un grupo (**Añadir bot a un grupo** en la tarjeta de Telegram lo hace) y envía `/add <name>` allí. El bot busca y muestra hasta ocho coincidencias como botones; toca una para añadirla. Solo los administradores del grupo pueden añadir personajes.

## Tu chat privado \[#your-private-chat]

Tu chat privado con el bot es tu propia conversación, cobrada a tu propia cuenta. Cada mensaje recibe respuesta, sin necesidad de mencionar a nadie.

* **Un personaje a la vez.** `/chat` cambia a otro, y `/chats` muestra los personajes con los que has hablado aquí. Cada uno conserva su propia conversación, así que al volver sigues donde lo dejaste.
* `/remove` termina la conversación actual (queda guardada para `/chats`), y `/reset` la borra después de pedirte confirmación.
* **Los personajes 18+** siguen el ajuste 18+ de tu cuenta: si está desactivado, quedan ocultos y no pueden chatear aquí.
* Tus conversaciones recientes también aparecen en el panel de integraciones bajo **Chat privado**, con **Seguir en la web** para retomar una en el navegador y **Chatear en Telegram** para volver.

## Comandos \[#commands]

El botón de menú junto al cuadro de texto muestra los comandos que funcionan donde estás: el chat privado y los grupos tienen cada uno su propia lista, en el idioma de tu Telegram.

| Comando              | Argumento                    | Dónde                                 | Qué hace                                                                                                                                   |
| -------------------- | ---------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `/start`             | —                            | privado                               | Te registra o te vincula y luego te ofrece personajes. En un grupo, igual que `/help`                                                      |
| `/help`              | —                            | ambos                                 | Muestra los comandos                                                                                                                       |
| `/chat`              | nombre (opcional)            | privado                               | Elige o cambia el personaje con el que hablas                                                                                              |
| `/chats`             | —                            | privado                               | Los personajes con los que has hablado, para cambiar entre ellos                                                                           |
| `/link`              | —                            | privado                               | Un enlace de un solo uso para unir tu Telegram a una cuenta de Reverie existente                                                           |
| `/add`               | texto de búsqueda (opcional) | grupo, administradores                | Busca personajes y añade el que toques. En un chat privado, igual que `/chat`                                                              |
| `/remove`            | —                            | grupo, administradores                | Muestra los personajes del grupo como botones; quita el que toques. En un chat privado, termina la conversación actual                     |
| `/list`              | —                            | grupo                                 | Los personajes de este grupo. En un chat privado, igual que `/chats`                                                                       |
| `/info`              | nombre del personaje         | ambos                                 | Detalles del personaje. En un chat privado, `/info` a secas describe al personaje con el que hablas; en un grupo, el nombre es obligatorio |
| `/settings`          | una subclave (opcional)      | ambos                                 | Abre el menú de ajustes                                                                                                                    |
| `/plugins`           | —                            | ambos                                 | Plugins activos en este chat, con botones para instalar, quitar o activar y desactivar plugins oficiales y los tuyos                       |
| `/group`             | —                            | grupo, administradores o el anfitrión | Quién puede hablar, un límite diario por miembro, miembros bloqueados y consumo. Se abre en tu chat privado                                |
| `/block`, `/unblock` | —                            | grupo, administradores o el anfitrión | Enviados como respuesta al mensaje de un miembro: le impiden hablar con los personajes o se lo vuelven a permitir                          |
| `/reset`             | —                            | ambos, administradores en un grupo    | Borra el historial de este chat                                                                                                            |
| `/regenerate`        | —                            | ambos                                 | Vuelve a generar la última respuesta                                                                                                       |
| `/suggest`           | —                            | ambos                                 | Tres respuestas sugeridas                                                                                                                  |
| `/account`           | —                            | ambos                                 | Créditos y estado de la suscripción                                                                                                        |
| `/daily`             | —                            | privado                               | Reclama tu recompensa diaria                                                                                                               |
| `/notify`            | —                            | privado                               | Si los personajes pueden escribirte primero, y qué notificaciones llegan aquí                                                              |
| `/buy`               | —                            | privado                               | Compra una suscripción o un paquete de créditos con Telegram Stars                                                                         |
| `/app`               | —                            | ambos                                 | Abre la Mini App de Reverie                                                                                                                |
| `/paysupport`        | —                            | ambos                                 | Soporte de pagos. Registrado, pero no aparece en el menú                                                                                   |

`/plugins` lista los plugins de prompt y de herramienta activos en este chat y, para administradores o quien añadió un personaje, ofrece botones para instalar plugins oficiales y los tuyos, quitarlos o activarlos y desactivarlos. Un plugin que necesita ajustes rellenados no se puede instalar desde el bot. El resultado de un plugin de herramienta se publica en el chat como una tarjeta breve.

### Ajustes \[#settings]

`/settings` abre un menú en línea, o salta directamente a una página con `/settings model`, `language`, `mode`, `style`, `payment` o `limit`.

| Entrada del menú       | Alcance                                                   | Solo admins en grupos |
| ---------------------- | --------------------------------------------------------- | --------------------- |
| **Model (personal)**   | Tu propio modelo para el personaje principal de este chat | no                    |
| **Language (chat)**    | Idioma de respuesta del chat                              | sí                    |
| **Chat mode**          | Responder a todo, o solo cuando se le habla               | sí                    |
| **Chat style**         | Prosa de rol, o solo diálogo                              | sí                    |
| **Payment mode**       | Paga el dueño o paga quien escribe                        | sí                    |
| **Daily credit limit** | Techo de créditos por día UTC                             | sí                    |

En un chat privado el menú ofrece \*\*Model (personal)\*\*, **Reply language** y **Chat style**: un chat privado siempre responde, y pagas tus propios mensajes. En un grupo, los menús y las respuestas de error se borran solos al poco rato para mantener limpio el chat.

## Grupos y canales \[#groups-and-channels]

En un grupo, los personajes responden cuando se les **@menciona** o cuando **respondes** a uno de sus mensajes: la respuesta automática está desactivada por defecto, así que añadir un personaje a un grupo animado no hace que hable por encima de todos. `/settings mode` la activa. Si al entrar el bot dijo que solo ve los mensajes que lo mencionan o le responden, hazlo administrador del grupo: la respuesta automática tiene que ver todos los mensajes.

En un grupo con temas, cada respuesta llega al tema al que contesta. El grupo mantiene un solo reparto y un solo historial en todos sus temas.

El bot también puede publicar en un **canal** de Telegram cuando se le ha hecho administrador allí.

## Reglas del grupo \[#group-rules]

Envía `/group` en el grupo. El panel se abre en tu chat privado con el bot, para que el grupo no te vea ajustarlo; si nunca has empezado un chat privado con el bot, primero te pide que abras uno. Pueden usarlo los administradores del grupo y quien paga sus personajes. Muestra el consumo de hoy y de los últimos siete días, los miembros que más han gastado hoy y las reglas:

| Regla                         | Opciones                                                                                                                                      |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Quién puede hablar**        | **Todos** (predeterminado) o **Solo administradores**                                                                                         |
| **Límite diario por miembro** | Cuántos créditos del anfitrión puede gastar un miembro por día UTC, o **Sin límite** (predeterminado). Solo se aplica donde paga el anfitrión |
| **Miembros bloqueados**       | Responde con `/block` al mensaje de un miembro en el grupo para impedirle hablar con los personajes; `/unblock`, enviado igual, lo deshace    |

Los administradores y la cuenta que paga nunca quedan fuera, ni por un bloqueo ni por el modo de acceso. A un miembro que el modo de acceso deja fuera se le avisa una vez de que solo algunos miembros pueden hablar con los personajes; un miembro bloqueado no recibe ninguna respuesta.

## Compartir un personaje \[#sharing-a-character]

En cualquier chat de Telegram (incluso uno en el que no esté el bot), escribe el @usuario del bot seguido del nombre de un personaje y elige uno de la lista. Se publica una tarjeta cuyo botón abre un chat a solas con ese personaje en el bot. Solo se ofrecen personajes públicos que no sean 18+.

## La Mini App \[#the-mini-app]

`/app` abre Reverie dentro del navegador de Telegram, con la sesión iniciada desde tu cuenta de Telegram: la app completa, con tu plantilla de personajes, tus chats y tus créditos.

Si el bot responde que la app no está disponible, la Mini App no está activada: abre Reverie en tu navegador.

## Pagar con Telegram Stars \[#paying-with-telegram-stars]

`/buy` hace toda la compra dentro de Telegram. Si no estás suscrito, eliges entre un plan y un paquete de créditos; si ya lo estás, vas directo a los paquetes con tu bono de suscriptor aplicado. Al elegir uno se publica una factura nativa de Stars con un botón **Pay**.

`/buy` está restringido a chats privados: una factura en un grupo le cobraría a quien la tocara.

## Quién paga \[#who-pays]

| Modo de pago                    | Se cobra a                                                                                                             | Límites que se aplican                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Owner pays** (predeterminado) | El anfitrión del grupo: la cuenta de Reverie que añadió el primer personaje al grupo, hasta que otra persona lo releve | El límite diario de créditos del grupo y el límite diario por miembro fijado con `/group` |
| **User pays**                   | El saldo de cada remitente                                                                                             | Ninguno: cada miembro está limitado por su propio saldo                                   |

Los mensajes cuestan lo mismo que en la aplicación web. Los contadores diarios se reinician a las **00:00 UTC**. Para pasar la factura de un grupo a tu propia cuenta, abre `/group` y pulsa **Pagar con mi cuenta**. En tu chat privado siempre pagas tus propios mensajes.

## Qué funciona en Telegram \[#what-works-in-telegram]

* **Imágenes.** Los personajes pueden generar imágenes.
* **Voz de salida.** Los personajes pueden enviar mensajes de voz.
* **Voz de entrada.** Las notas de voz y los archivos de audio se transcriben, hasta **25 MB**.
* **Memoria.** Los personajes guardan y actualizan memorias cuando el modelo admite herramientas, y el canon de los libros del mundo entra en su contexto.
* **Historial.** Los chats largos se resumen automáticamente a medida que crecen.

## Notificaciones y recompensa diaria \[#notifications-and-check-ins]

`/notify` ajusta dos cosas. **Personajes que te escriben primero** es el nivel de proactividad de tu cuenta, el mismo ajuste que en la web: con una suscripción, el personaje con el que hablas en tu chat privado puede escribirte primero; ver [Mensajes por iniciativa del personaje](https://reverie.im/es/docs/chatting/proactive-messages). **Recibir también aquí** elige cuáles de tus notificaciones de Reverie llegan además a tu chat privado; al principio solo está activada **Cuenta y facturación**; ver [Notificaciones](https://reverie.im/es/docs/account/notifications). El panel de integraciones ofrece las mismas opciones.

`/daily` reclama tu [recompensa diaria](https://reverie.im/es/docs/rewards/daily-check-in), la misma que en la web, y abre el sorteo de la suerte en la Mini App.

## Límites \[#limits]

| Límite                                    | Valor            |
| ----------------------------------------- | ---------------- |
| Personajes por chat                       | 5                |
| Longitud del mensaje                      | 4.096 caracteres |
| Tamaño de la entrada de voz               | 25 MB            |
| Mensajes en cola por chat                 | 3                |
| Resultados de búsqueda que muestra `/add` | 8                |

Los mensajes seguidos y rápidos de la misma persona se juntan en un solo turno.

## Desvincular \[#unlinking]

Desvincula desde el panel de integraciones con **Unlink Account**.

> Bloquear el bot en Telegram no desvincula tu cuenta. Quitar el bot de un grupo solo desactiva los personajes de ese grupo. Usa **Unlink Account** en la app.

## Relacionado \[#related]

* [Bot de Discord](https://reverie.im/es/docs/integrations/discord-bot) — los mismos personajes, en un servidor
* [Reverie Labs](https://reverie.im/es/docs/integrations/labs) — donde vive el panel de integraciones
* [Créditos](https://reverie.im/es/docs/billing/credits) — lo que cuesta un mensaje
* [Suscripciones](https://reverie.im/es/docs/billing/subscriptions) — lo que incluye un plan
