Skip to content

Commit 4854212

Browse files
Thales-Chagasclaude
andcommitted
Conexao self-service do Telegram + aba Minha Conta
- App gera codigo de 6 digitos; usuario manda /conectar no bot e o vinculo telegram_links e criado sozinho (antes era SQL manual). - Migration telegram_codigos (codigo->user_id, expira 15min, RLS). - Bot: trata /conectar antes da allowlist; /start responde mesmo sem conexao guiando o onboarding; rate-limit nos comandos. - src/telegramLink.js: gerar/consultar/desconectar codigo. - App.jsx: ModalConectarTelegram (gerar codigo, copiar, abrir bot) + botao na sidebar e header (so logado na nuvem). - Aba "Minha Conta": mostra conta, onde os dados ficam (nuvem x aparelho), status do Telegram e explica saldo diferente entre aparelhos. - TUTORIAL-CONECTAR-TELEGRAM.md: passo a passo para o usuario final. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent f52965a commit 4854212

5 files changed

Lines changed: 594 additions & 28 deletions

File tree

TUTORIAL-CONECTAR-TELEGRAM.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# 📲 Como lançar seus gastos pelo Telegram
2+
3+
O ThayFinance tem um **assistente no Telegram**: você manda um **áudio**, uma **foto do comprovante** ou só **escreve** o gasto, e ele lança sozinho na sua conta. 💚
4+
5+
Antes de usar, você precisa **conectar o Telegram à sua conta** uma única vez. É rapidinho — leva menos de 1 minuto.
6+
7+
---
8+
9+
## ✅ Passo a passo para conectar
10+
11+
### 1. Abra o app e entre na sua conta
12+
Entre normalmente no ThayFinance (e-mail e senha).
13+
14+
### 2. Toque em "Conectar Telegram"
15+
- No **celular**: toque no ícone de aviãozinho ✈️ lá em cima, no canto direito.
16+
- No **computador**: o botão **Conectar Telegram** fica na barra da esquerda, embaixo.
17+
18+
### 3. Toque em "Gerar código de conexão"
19+
O app vai mostrar um **código de 6 números**, assim:
20+
21+
> `/conectar 123456`
22+
23+
### 4. Abra o bot no Telegram
24+
Toque no botão **"Abrir o bot no Telegram"** (ou procure por **@ThayFinance_bot** no Telegram).
25+
26+
### 5. Envie o código pra ele
27+
No Telegram, mande a mensagem que apareceu no app — por exemplo:
28+
29+
> `/conectar 123456`
30+
31+
> 💡 **Dica:** no app tem um botão **Copiar**. Toque nele, vá no Telegram e cole a mensagem. Mais fácil!
32+
33+
### 6. Pronto! 🎉
34+
O bot responde **"Tudo certo! Você está conectado."** — e é só começar a usar.
35+
36+
---
37+
38+
## 🎙️ Como usar depois de conectar
39+
40+
No Telegram, mande pro bot:
41+
42+
| Você manda... | Exemplo |
43+
|---|---|
44+
| 🎙️ **Um áudio** falando o gasto | *"Gastei 50 reais no mercado hoje"* |
45+
| 📷 **Uma foto do comprovante** | (é só tirar a foto da notinha e enviar) |
46+
| ✍️ **Uma mensagem escrita** | `gastei 30 de uber ontem` |
47+
48+
O bot lê, entende o valor, a data e a categoria, e **responde confirmando** o lançamento.
49+
50+
---
51+
52+
## 👤 Conta Pessoal x 🏢 Conta Empresarial
53+
54+
- Por padrão, tudo entra na sua conta **Pessoal**.
55+
- Para lançar na **Empresarial**, é só **citar a empresa** na mensagem. Exemplos:
56+
- *"paguei 200 de energia **da empresa**"*
57+
- *"recebi 500, faturamento **empresarial**"*
58+
- numa **foto**, escreva **empresa** na legenda ao enviar.
59+
60+
Palavras que mandam pra Empresarial: *empresa, empresarial, firma, CNPJ, negócio, comercial*.
61+
62+
---
63+
64+
## ❓ Dúvidas comuns
65+
66+
**O código não funcionou / diz que expirou.**
67+
O código vale por **15 minutos**. Se passou disso, é só voltar no app e **gerar outro**.
68+
69+
**Mandei mensagem e o bot não respondeu nada.**
70+
Provavelmente esse Telegram ainda **não está conectado**. Faça o passo a passo acima. (Por segurança, o bot só atende quem está conectado.)
71+
72+
**Quero trocar de celular / desconectar.**
73+
No app, em **Conectar Telegram**, toque em **Desconectar**. Depois é só conectar de novo quando quiser.
74+
75+
**Os lançamentos do Telegram aparecem no app?**
76+
Sim — eles vão direto pra sua conta na nuvem. Se o app já estiver aberto, atualize a tela para vê-los.
77+
78+
---
79+
80+
💚 *ThayFinance · Controle Financeiro*

0 commit comments

Comments
 (0)