# Bot do Telegram

> Converse a sós num chat privado, leve personagens para grupos, compartilhe-os inline ou abra o Mini App.

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

O bot da Reverie leva os personagens para o Telegram — uma conversa privada com o bot, um grupo ou um canal que ele administre. Ele também consegue abrir a própria Reverie dentro do Telegram como Mini App, onde dá para comprar créditos com Telegram Stars.

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

### Vincular sua conta \[#link-your-account]

Quem fala com um personagem precisa de uma conta Reverie vinculada à sua conta do Telegram — uma gratuita basta. Uma conta do Telegram corresponde a exatamente uma conta Reverie.

* **Pelo site.** No app, vá em **Labs → Bots do Discord e Telegram** e toque em **Vincular no Telegram** no cartão do Telegram. O Telegram abre um chat com o bot; toque em **Começar** e você fica vinculado à conta em que está conectado. A página se atualiza sozinha.
* **Pelo Telegram.** Abra o bot e mande `/start`. **Continuar com o Telegram** cria uma conta Reverie gratuita pelo Mini App, sem precisar de e-mail. **Já tenho uma conta** manda em vez disso um link de uso único, válido por **10 minutos**, que une seu Telegram a uma conta existente; `/link` manda o mesmo link a qualquer momento.

### Escolher um personagem \[#pick-a-character]

Mande `/chat` para ver com quem você pode falar — primeiro os personagens com quem você já fala aqui, depois sugestões —, ou `/chat` seguido de um nome para buscar. Toque em um e comece a escrever.

### Levar personagens para um grupo \[#bring-characters-into-a-group]

Opcional. Adicione o bot a um grupo — **Adicionar Bot a um Grupo** no cartão do Telegram faz isso — e mande `/add <name>` lá. O bot busca e mostra até oito resultados como botões; toque em um para adicioná-lo. Só administradores do grupo podem adicionar personagens.

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

Seu chat privado com o bot é a sua própria conversa, cobrada da sua própria conta. Toda mensagem recebe resposta — sem precisar mencionar ninguém.

* **Um personagem por vez.** `/chat` troca para outro, e `/chats` lista os personagens com quem você já falou aqui. Cada um guarda a própria conversa, então ao voltar você continua de onde parou.
* `/remove` encerra a conversa atual — ela fica salva para `/chats` —, e `/reset` a apaga depois de pedir sua confirmação.
* **Personagens 18+** seguem a configuração 18+ da sua conta: com ela desligada, eles ficam ocultos e não podem conversar aqui.
* Suas conversas recentes também aparecem no painel de integrações em **Chat privado**, com **Continuar na web** para retomar uma no navegador e **Conversar no Telegram** para voltar.

## Comandos \[#commands]

O botão de menu ao lado da caixa de texto lista os comandos que funcionam onde você está — o chat privado e os grupos têm cada um a sua lista, no idioma do seu Telegram.

| Comando              | Argumento                 | Onde                                  | O que faz                                                                                                                                  |
| -------------------- | ------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `/start`             | —                         | privado                               | Cria sua conta ou te vincula e depois oferece personagens. Num grupo, igual a `/help`                                                      |
| `/help`              | —                         | ambos                                 | Lista os comandos                                                                                                                          |
| `/chat`              | nome (opcional)           | privado                               | Escolhe ou troca o personagem com quem você está falando                                                                                   |
| `/chats`             | —                         | privado                               | Os personagens com quem você falou, para alternar entre eles                                                                               |
| `/link`              | —                         | privado                               | Um link de uso único para unir seu Telegram a uma conta Reverie existente                                                                  |
| `/add`               | texto de busca (opcional) | grupo, administradores                | Busca personagens e adiciona o que você tocar. No chat privado, igual a `/chat`                                                            |
| `/remove`            | —                         | grupo, administradores                | Lista os personagens do grupo como botões; remove o que você tocar. No chat privado, encerra a conversa atual                              |
| `/list`              | —                         | grupo                                 | Os personagens deste grupo. No chat privado, igual a `/chats`                                                                              |
| `/info`              | nome do personagem        | ambos                                 | Detalhes do personagem. No chat privado, `/info` sozinho descreve o personagem com quem você está falando; num grupo, o nome é obrigatório |
| `/settings`          | uma subchave (opcional)   | ambos                                 | Abre o menu de configurações                                                                                                               |
| `/plugins`           | —                         | ambos                                 | Plugins em uso neste chat, com botões para instalar, remover ou ligar e desligar plugins oficiais e os seus                                |
| `/group`             | —                         | grupo, administradores ou o anfitrião | Quem pode conversar, um limite diário por membro, membros bloqueados e o uso. Abre no seu chat privado                                     |
| `/block`, `/unblock` | —                         | grupo, administradores ou o anfitrião | Enviados como resposta à mensagem de um membro: impedem que ele fale com os personagens, ou permitem de novo                               |
| `/reset`             | —                         | ambos, administradores num grupo      | Apaga o histórico deste chat                                                                                                               |
| `/regenerate`        | —                         | ambos                                 | Gera de novo a última resposta                                                                                                             |
| `/suggest`           | —                         | ambos                                 | Três respostas sugeridas                                                                                                                   |
| `/account`           | —                         | ambos                                 | Créditos e status da assinatura                                                                                                            |
| `/daily`             | —                         | privado                               | Resgata sua recompensa diária                                                                                                              |
| `/notify`            | —                         | privado                               | Se os personagens podem te escrever primeiro, e quais notificações chegam aqui                                                             |
| `/buy`               | —                         | privado                               | Comprar uma assinatura ou um pacote de créditos com Telegram Stars                                                                         |
| `/app`               | —                         | ambos                                 | Abre o Mini App da Reverie                                                                                                                 |
| `/paysupport`        | —                         | ambos                                 | Suporte de pagamento. Registrado, mas fora do menu                                                                                         |

`/plugins` lista os plugins de prompt e de ferramenta ativos nesta conversa e, para administradores ou quem adicionou um personagem, oferece botões para instalar plugins oficiais e os seus, removê-los ou ativá-los e desativá-los. Um plugin que precisa de configurações preenchidas não pode ser instalado pelo bot. O resultado de um plugin de ferramenta é publicado na conversa como um cartão curto.

### Configurações \[#settings]

`/settings` abre um menu em linha, ou você pula direto para uma página com `/settings model`, `language`, `mode`, `style`, `payment` ou `limit`.

| Item do menu           | Alcance                                                         | Só admins em grupos |
| ---------------------- | --------------------------------------------------------------- | ------------------- |
| **Model (personal)**   | O seu próprio modelo para o personagem principal desta conversa | não                 |
| **Language (chat)**    | Idioma de resposta da conversa                                  | sim                 |
| **Chat mode**          | Responder a tudo, ou só quando chamado                          | sim                 |
| **Chat style**         | Prosa de interpretação, ou só diálogo                           | sim                 |
| **Payment mode**       | Paga o dono ou paga quem escreve                                | sim                 |
| **Daily credit limit** | Teto de créditos por dia UTC                                    | sim                 |

No chat privado o menu oferece \*\*Model (personal)\*\*, **Reply language** e **Chat style**: um chat privado sempre responde, e você paga as suas próprias mensagens. Num grupo, menus e respostas de erro se apagam sozinhos depois de um tempo para manter o chat limpo.

## Grupos e canais \[#groups-and-channels]

Num grupo, os personagens respondem quando são **@mencionados** ou quando você **responde** a uma mensagem deles — a resposta automática vem desligada por padrão, então colocar um personagem num grupo movimentado não o faz falar por cima de todo mundo. `/settings mode` a liga. Se, ao entrar, o bot disse que só vê mensagens que o mencionam ou respondem a ele, torne-o administrador do grupo: a resposta automática precisa ver todas as mensagens.

Num grupo com tópicos, cada resposta cai no tópico que ela responde. O grupo mantém um só elenco e um só histórico em todos os tópicos.

O bot também pode publicar num **canal** do Telegram quando é feito administrador lá.

## Regras do grupo \[#group-rules]

Mande `/group` no grupo. O painel abre no seu chat privado com o bot, para o grupo não ficar vendo você ajustar — se você nunca começou um chat privado com o bot, ele pede primeiro que você abra um. Podem usá-lo os administradores do grupo e quem paga pelos personagens dele. Ele mostra o uso de hoje e dos últimos sete dias, os membros que mais gastaram hoje e as regras:

| Regra                        | Opções                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Quem pode conversar**      | **Todos** (padrão) ou **Só administradores**                                                                                                |
| **Limite diário por membro** | Quantos créditos do anfitrião um membro pode gastar por dia UTC, ou **Sem limite** (padrão). Só vale onde o anfitrião paga                  |
| **Membros bloqueados**       | Responda `/block` à mensagem de um membro no grupo para impedir que ele fale com os personagens; `/unblock`, enviado do mesmo jeito, desfaz |

Administradores e a conta que paga nunca ficam de fora, nem por bloqueio nem pelo modo de acesso. Um membro que o modo de acesso deixa de fora é avisado uma vez de que só alguns membros podem falar com os personagens; um membro bloqueado não recebe resposta nenhuma.

## Compartilhar um personagem \[#sharing-a-character]

Em qualquer chat do Telegram — mesmo um em que o bot não está —, digite o @usuário do bot seguido do nome de um personagem e escolha um da lista. Isso publica um cartão cujo botão abre um chat a sós com esse personagem no bot. Só aparecem personagens públicos que não são 18+.

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

`/app` abre a Reverie dentro do navegador do Telegram, já com a sessão iniciada pela sua conta do Telegram — o app inteiro, com o seu elenco, as suas conversas e os seus créditos.

Se o bot responder que o app não está disponível, o Mini App não está ligado — abra a Reverie no seu navegador.

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

`/buy` faz a compra inteira dentro do Telegram. Sem assinatura, você escolhe entre um plano e um pacote de créditos; já assinante, vai direto aos pacotes com o seu bônus de assinante aplicado. Escolher um publica uma cobrança nativa em Stars com um botão **Pay**.

`/buy` é restrito a conversas privadas — uma cobrança num grupo cobraria de quem tocasse nela.

## Quem paga \[#who-pays]

| Modo de pagamento       | Cobrado de                                                                                             | Limites que valem                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| **Owner pays** (padrão) | O anfitrião do grupo: a conta Reverie que adicionou o primeiro personagem ao grupo, até alguém assumir | O limite diário de créditos do grupo e o limite diário por membro definido com `/group` |
| **User pays**           | O saldo de quem envia                                                                                  | Nenhum — cada membro fica limitado pelo próprio saldo                                   |

As mensagens custam o mesmo que no app web. Os contadores diários zeram às **00:00 UTC**. Para passar a conta de um grupo para a sua própria conta, abra `/group` e toque em **Pagar com minha conta**. No seu chat privado, você sempre paga as suas próprias mensagens.

## O que funciona no Telegram \[#what-works-in-telegram]

* **Imagens.** Os personagens podem gerar imagens.
* **Voz na saída.** Os personagens podem mandar mensagens de voz.
* **Voz na entrada.** Notas de voz e arquivos de áudio são transcritos, até **25 MB**.
* **Memória.** Os personagens salvam e atualizam memórias quando o modelo aceita ferramentas, e o cânone dos world books entra no contexto deles.
* **Histórico.** Conversas longas são resumidas automaticamente conforme crescem.

## Notificações e recompensa diária \[#notifications-and-check-ins]

`/notify` ajusta duas coisas. **Personagens que te escrevem primeiro** é o nível de proatividade da sua conta, a mesma configuração do site: com uma assinatura, o personagem com quem você está falando no chat privado pode te escrever primeiro — veja [Mensagens por iniciativa do personagem](https://reverie.im/pt/docs/chatting/proactive-messages). **Também me envie aqui** escolhe quais das suas notificações da Reverie chegam também ao seu chat privado; no início só **Conta e cobrança** está ativada — veja [Notificações](https://reverie.im/pt/docs/account/notifications). O painel de integrações oferece as mesmas opções.

`/daily` resgata sua [recompensa diária](https://reverie.im/pt/docs/rewards/daily-check-in), a mesma do site, e abre o sorteio da sorte no Mini App.

## Limites \[#limits]

| Limite                                | Valor            |
| ------------------------------------- | ---------------- |
| Personagens por conversa              | 5                |
| Tamanho da mensagem                   | 4.096 caracteres |
| Tamanho da entrada de voz             | 25 MB            |
| Mensagens na fila por conversa        | 3                |
| Resultados de busca que `/add` mostra | 8                |

Mensagens rápidas e seguidas da mesma pessoa são juntadas num único turno.

## Desvincular \[#unlinking]

Desvincule no painel de integrações com **Unlink Account**.

> Bloquear o bot no Telegram não desvincula a sua conta. Tirar o bot de um grupo só desativa os personagens daquele grupo. Use **Unlink Account** no app.

## Relacionado \[#related]

* [Bot do Discord](https://reverie.im/pt/docs/integrations/discord-bot) — os mesmos personagens, num servidor
* [Reverie Labs](https://reverie.im/pt/docs/integrations/labs) — onde mora o painel de integrações
* [Créditos](https://reverie.im/pt/docs/billing/credits) — quanto custa uma mensagem
* [Assinaturas](https://reverie.im/pt/docs/billing/subscriptions) — o que um plano inclui