> ## Documentation Index
> Fetch the complete documentation index at: https://help.finerd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o bot do Telegram

> Vincule o bot do Telegram do finerd a um espaço, escolha somente leitura ou leitura e escrita, registre despesas e pergunte sobre o seu dinheiro no chat.

O bot do Telegram do finerd, [@finerds\_bot](https://t.me/finerds_bot), permite manter os seus registros a partir de um chat do Telegram: escreva “café 85”, mande uma mensagem de voz ou uma foto do recibo, pergunte quanto você gastou com táxi no mês passado e receba uma mensagem quando uma transação precisar de revisão. Você vincula o bot a um espaço do finerd e escolhe se ele pode só ler esse espaço ou também alterá-lo.

O bot funciona no plano Free: tudo o que é gratuito no finerd é gratuito no bot, e os recursos do Pro exigem o **Pro** no espaço que você conecta. A vinculação acontece no Telegram e em uma página do finerd no navegador, e a desconexão, no próprio chat, com `/logout`: os apps do finerd para web, Android e iOS não têm configurações do Telegram. Assistentes de AI como o Claude ou o ChatGPT se conectam de outro jeito, pelo finerd MCP: veja [Gerenciar suas finanças com AI](https://help.finerd.ai/pt/ai.md).

## Conectar o bot

1. Abra o bot no Telegram.

   > [tab] Web
   >
   > Abra [t.me/finerds\_bot](https://t.me/finerds_bot) no navegador e, de lá, abra o bot no Telegram, ou pesquise **finerds\_bot** no Telegram. O nome do bot é **OnlyFinerds Bot**.

   > [tab] Android
   >
   > Abra **Mais** e, em **Conexões**, toque em **Bot do Telegram**. A página do bot abre; abra o bot no Telegram.

   > [tab] iOS
   >
   > Abra **Mais** e, em **Conexões**, toque em **Bot do Telegram**. Se o Telegram estiver instalado, o bot abre nele. Se não estiver, o Safari mostra a página do bot com **START BOT** e um link para baixar o Telegram.
   >
   > ![A aba More do finerd no iOS, seção Connections: Institutions, Family access, Telegram Bot, Emails e Apple Wallet](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/ios-more-telegram-bot.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=6ccf20dc6c2a765beecea54dca0dafb9)
   >
   > Bot do Telegram fica em Conexões, na aba Mais.
   >
   > ![A página web do Telegram do OnlyFinerds Bot, @finerds\_bot, com o botão START BOT](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/ios-bot-page.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=8e8c2ba1de3cf208f11a806509454b56)
   >
   > Sem o Telegram instalado, o Safari mostra a página do bot.

2. Inicie o bot. A primeira mensagem dele tem botões de cumprimento em nove idiomas: selecione o seu ou cumprimente o bot com as suas próprias palavras. A partir daí, o bot escreve nesse idioma.

3. Quando o bot perguntar qual banco você usa, selecione **I have an account**. Os botões e as respostas fixas do bot existem só em inglês e ucraniano, por isso aparecem aqui em inglês.

4. Selecione **Sign in to Finerd**. Uma página do finerd abre no navegador; entre se o finerd pedir. O bot fica vinculado à conta do finerd que está conectada nessa página, então, se o navegador estiver com a conta de outra pessoa, saia dela antes.

5. Em **Espaço do Finerd**, escolha o espaço em que o bot vai trabalhar. Em **Escolha o nível de acesso**, escolha **Somente leitura** ou **Leitura e escrita** (veja [Escolher o espaço e o acesso](#space-access)). Depois, selecione **Permitir e continuar**.

   ![A página Connect Telegram do finerd: Finerd space com Personal, Choose access level com Read only selecionado e Read & Write, um aviso sobre criptografia e fornecedores de AI, e Allow and continue](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/web-connect-telegram.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=29479572f5fdd3dea7804b0b25fa45b9)

   Escolha o espaço e o acesso e selecione Permitir e continuar.

6. A página mostra **Consentimento registrado**. Selecione **Voltar ao Telegram**. O bot só recebe acesso depois que você volta: ele confirma com “Done ✅” e alguns exemplos do que escrever.

O botão **Sign in to Finerd** funciona por 10 minutos e uma vez só. Se ele não abrir a página, ou se a página disser que o link expirou, escreva “new link” no chat e use o botão novo.

**Ainda não tem conta no finerd?** Pule **I have an account** e responda às perguntas do bot. Ele pede o seu e-mail, envia um código de acesso para esse endereço, pergunta qual é a sua moeda e a sua cidade e cria a sua conta do finerd. O bot fica então conectado ao seu novo espaço Pessoal com **Leitura e escrita**, sem nenhuma página do finerd para abrir.

## Escolher o espaço e o acesso

O bot trabalha em um único espaço: o que você escolhe na página do finerd. **Espaço do Finerd** lista o seu espaço Pessoal e os seus espaços empresariais, com o espaço aberto no momento no finerd já selecionado; o espaço demo não aparece. Tudo o que você registra no chat, cada resposta e cada notificação pertencem a esse espaço.

![A lista Finerd space na página Connect Telegram: Personal (selecionado), Help test Migration e Help test Studio, ambos Business](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/web-choose-space.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=9148a23f316813ceb7fe9dfef4a94223)

Espaço do Finerd lista o seu espaço Pessoal e os seus espaços empresariais.

| Acesso | O que o bot pode fazer |
| - | - |
| **Somente leitura** (opção inicial) | Ver os dados financeiros do espaço e responder a perguntas sobre saldos, transações, relatórios, orçamentos, dívidas e recibos. |
| **Leitura e escrita** | Também registrar despesas e transferências; alterar a categoria, as etiquetas, o estabelecimento, o comentário ou a data de uma transação; dividir transações; marcá-las como revisadas ou como família; criar categorias, etiquetas, estabelecimentos, orçamentos e contas; arquivar contas. |

Com qualquer um dos dois acessos, o bot não pode excluir uma transação nem alterar o valor pago: faça isso no app do finerd. As alterações feitas pelo bot são salvas no finerd na hora.

Antes de você permitir o acesso, a página avisa que o Telegram não usa criptografia de ponta a ponta nas conversas com bots e que o bot envia os seus pedidos e os resultados deles a fornecedores de AI para preparar as respostas. O finerd usa só fornecedores que não treinam modelos com os seus dados.

Para levar o bot a outro espaço ou mudar o acesso dele, envie `/logout`, depois `/start`, selecione **I have an account** e entre de novo, escolhendo o espaço e o acesso que quiser.

Assistentes de AI conectados pelo finerd MCP funcionam de outro jeito: uma única conexão vale para todos os espaços de que você participa. Veja [Quais espaços o assistente vê](https://help.finerd.ai/pt/ai/manage-access.md#spaces).

## O que você pode fazer no chat

Escreva para o bot como mandaria mensagem para um amigo. Ele responde no idioma da sua última mensagem.

* **Registrar uma despesa** (**Leitura e escrita**): escreva, por exemplo, “café 85”, ou mande uma mensagem de voz ou uma foto do recibo.
* **Perguntar sobre o seu dinheiro**: “quanto gastei com táxi em setembro?”, os seus saldos, um relatório, um orçamento ou uma dívida.
* **Adicionar um banco ou uma conta**: escreva “connect mono”, “connect privat” ou “add a manual account”. Os outros bancos abrem uma página do finerd no navegador; veja [Conectar um banco](https://help.finerd.ai/pt/institutions/connect-institution.md).
* **Revisar transações novas**: quando uma transação do espaço precisa de revisão ou de uma categoria, o bot envia uma mensagem sobre ela com **Open in Finerd**. Com **Leitura e escrita**, a mensagem também tem **✅ Mark as reviewed**.

Se você usa a [contabilidade familiar](https://help.finerd.ai/pt/family-accounting.md) e o bot tem **Leitura e escrita**, essas mensagens também têm **👨‍👩‍👦 Mark as family**. O botão marca a transação como Família, o que adiciona uma cópia ao espaço do seu parceiro, e a marca como revisada. Depois, o botão vira **↩ Remove from family**: remover a marcação exclui a cópia do seu parceiro, junto com as alterações feitas nela pelo parceiro. O bot não pode marcar uma transação dividida, uma transferência entre contas nem uma transação de uma conta conjunta; altere essas transações no finerd.

O bot também entende estes comandos:

| Comando | O que faz |
| - | - |
| `/start` | Conecta a sua conta do finerd ou continua de onde você parou |
| `/help` | Lista os comandos |
| `/accounts` | Mostra as suas contas |
| `/banks` | Mostra os seus bancos conectados |
| `/mode` | Escolhe o que o bot envia para você: **Everything**, **Only family questions** ou **Only review questions** |
| `/cancel` | Pausa a etapa atual |
| `/logout` | Desconecta o bot da sua conta do finerd |

Nunca envie senhas ou códigos do banco no chat. O bot só precisa do seu e-mail para você entrar.

## Desconectar o bot

Envie `/logout` no chat com o bot. Ele responde “You are logged out of Finerd in this chat” e para de trabalhar com o seu espaço. Não é possível desconectar o bot pelos apps do finerd.

O bot também é desconectado quando alguém desfaz uma alteração de e-mail na sua conta do finerd com **Desfazer a alteração**: veja [Se você não alterou o seu e-mail](https://help.finerd.ai/pt/account/profile-and-sign-in-methods.md#undo). Para usá-lo de novo, envie `/start` e entre.

Entrar no finerd com o Telegram é algo separado do bot: `/logout` não remove esse login, e o bot não é removido quando você desconecta o login com Telegram. Veja [Gerenciar seu perfil e os métodos de login](https://help.finerd.ai/pt/account/profile-and-sign-in-methods.md#disconnect).

As alterações que o bot já fez continuam no finerd, e o histórico do chat continua no Telegram. Uma conta do Telegram fica vinculada a uma conta do finerd por vez: para trocar de conta, envie `/logout`, depois `/start` e entre com a outra conta.

Se o Pro terminar no espaço conectado, o bot continua vinculado e continua funcionando e enviando notificações em tudo o que é gratuito. Um pedido que precisa de um recurso do Pro recebe uma resposta de que o recurso exige um plano pago, com um link para assinar o Pro. Veja [Gerenciar sua assinatura do finerd](https://help.finerd.ai/pt/account/manage-subscription.md).

## Resolver problemas de conexão

| O que aparece | O que fazer |
| - | - |
| **Link de conexão inválido** na página do finerd, ou “Este link de conexão é inválido” | Volte ao chat e escreva “new link”, depois use o novo botão **Sign in to Finerd**. |
| “Este link de conexão expirou” ou “já foi usado” | O link funciona por 10 minutos e uma vez só. Escreva “new link” no chat. |
| “Telegram connections are not available for this account or space” | O finerd não consegue vincular esta conta ao espaço escolhido. Escolha outro espaço do qual você é membro; se continuar acontecendo, [fale com o suporte](https://help.finerd.ai/pt/contact-us.md). |
| “Muitas tentativas de conexão” | Espere um pouco e escreva “new link” no chat. |
| Você voltou ao Telegram, mas o bot não respondeu | Envie `/start` e, se o bot pedir, entre de novo. |
| “Your finerd connection is no longer available. Please reconnect it.” | O bot foi desconectado da sua conta, por exemplo porque uma alteração de e-mail foi desfeita. Envie `/start` e entre de novo. |
| “That action needs write access” ou “Changes need edit permission” | O bot tem **Somente leitura**. Envie `/logout`, depois `/start`, e escolha **Leitura e escrita** ao entrar. |
| Uma resposta de que um recurso exige um plano pago | O pedido usa um recurso do Pro, e o espaço conectado não tem Pro (em um espaço empresarial, a sua vaga não está paga). [Assine o Pro](https://help.finerd.ai/pt/account/manage-subscription.md) ou conecte o bot a um espaço com Pro. |

Se um problema se repetir, [fale com o suporte](https://help.finerd.ai/pt/contact-us.md) e informe o horário e o que o bot respondeu.

## Artigos relacionados

* [Gerenciar suas finanças com AI](https://help.finerd.ai/pt/ai.md)
* [Gerenciar o acesso da AI](https://help.finerd.ai/pt/ai/manage-access.md)
* [Gerenciar seu perfil e os métodos de login](https://help.finerd.ai/pt/account/profile-and-sign-in-methods.md)
* [Configurar a contabilidade familiar](https://help.finerd.ai/pt/family-accounting.md)
* [Revisar transações importadas](https://help.finerd.ai/pt/transactions/review-imported-transactions.md)
* [Gerenciar sua assinatura do finerd](https://help.finerd.ai/pt/account/manage-subscription.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.