Bot de Telegram

Liga o @osociopt_bot à tua conta uma única vez e passa a tratar das faturas de fornecedores pelo telemóvel: fotografas, envias, e os preços atualizam-se sozinhos.

O @osociopt_bot é O Sócio no teu bolso. Sem abrir o computador: envias-lhe uma foto (ou PDF) de uma fatura de fornecedor e ele lê os artigos, preços e quantidades com IA, atualiza os preços dos teus ingredientes e diz-te o que mudou — e que pratos deves rever.

Ligar o bot à tua conta (só uma vez)

1 Gera o teu código no simulador

Entra em app.osocio.pt, vai ao passo 4 · Menu & Cozinha e, no cartão da IA, toca em “📱 Ligar o Telegram”. Aparece um código de 6 caracteres só teu.

app.osocio.pt · passo 4 · cartão da IA

2 Abre o @osociopt_bot no Telegram

No Telegram, procura @osociopt_bot e abre a conversa.

3 Envia /ligar CÓDIGO

Substitui CÓDIGO pelos 6 caracteres do simulador — por exemplo /ligar A1B2C3. Recebes “✅ Ligado!” e está feito: este chat fica associado ao teu restaurante.

💡 O código vale 15 minutos e só pode ser usado uma vez. Se expirar, volta ao simulador e gera outro. Se errares o código 5 vezes numa hora, o bot pede-te para esperar um pouco e gerar um novo — é uma proteção contra tentativas de adivinhar códigos. Depois de ligado, fixa o bot no ecrã do telemóvel (⋮ → Adicionar ao ecrã principal): fica ao lado da câmara.

📸

O gesto de ouro:

cada papel que um fornecedor te entrega — talho, peixaria, bebidas, Makro — fotografa antes de o meteres na gaveta e envia ao bot. É isso que mantém os teus preços, o teu menu e o teu desperdício sob controlo, sem esforço.

O dia a dia: fatura → bot → preços atualizados

1 Fotografa a fatura e envia

Uma fotografia direta ou um ficheiro PDF ou imagem (.pdf, .png, .jpg, .jpeg, .webp) — como preferires. O bot confirma: “🤖 A ler a fatura… (uns 10 segundos)”.

2 A IA lê e atualiza os teus preços

O bot casa os artigos da fatura com o teu catálogo de ingredientes e aplica os preços novos na tua conta. Se houver artigos que ainda não existem, cria-os no catálogo por ti.

3 Recebes o resumo no chat

Fornecedor e data da fatura, quantas linhas foram lidas, os preços atualizados e os ingredientes novos. Se algum preço subiu mais de 3%, o bot avisa-te para abrires o simulador (passo 4) e veres que pratos devem mudar de preço e quanto isso vale por ano.

Símbolo	O que significa no resumo
🔺	O preço subiu mais de 3% face ao que tinhas
🔻	O preço desceu mais de 3%
▪️	Preço praticamente estável (mudou menos de 3%)
🆕	Ingrediente novo criado no teu catálogo — confere o preço no passo 4 e junta-o às receitas dos pratos
👀	Artigos fora do catálogo (não são ingredientes de cozinha) — ficam de fora

“Veio sem peso na fatura” — as perguntas do bot

Se um artigo de comida vier sem peso na fatura, o bot pergunta: “Quanto pesa ao todo?”. Responde por exemplo 500 g, 1,2 kg ou 0,7 L — ou ignorar para deixar esse artigo de fora. A tua resposta é o que permite atualizar o preço (€/kg ou €/L) e somar a quantidade ao controlo de desperdício. Se houver vários artigos nesta situação, o bot pergunta um de cada vez.

Comandos do bot

Comando	O que faz
`/ligar CÓDIGO`	Liga este chat à tua conta (só na 1.ª vez; o código aparece no simulador, passo 4)
📸 foto ou PDF	Lê uma fatura de fornecedor e atualiza os teus preços
`/saldo`	Mostra o estado da tua conta
`/ajuda`	Relembra o que o bot faz (o `/start` mostra a mesma mensagem)

Coisas úteis de saber

Ler faturas está incluído no serviço — sem contadores nem limites. Se a leitura falhar, não perdes nada: o bot pede outra foto ou um PDF mais nítido.
Várias faturas seguidas? O bot trata de uma de cada vez. Se enviares outra enquanto ele lê, recebes “📥 Recebi, estou a acabar outra fatura. Trato já da tua a seguir.”
Dois telemóveis (tu e o sócio/gerente)? Cada um faz /ligar com um código gerado no simulador. Um código só serve uma vez — para o segundo telemóvel, gera outro código no passo 4.
O bot também fala primeiro. Com o Telegram ligado, sempre que carregas um SAF-T recebes no chat as 3 decisões do mês (modalidade Extra): as três coisas com mais euros em jogo, com a etiqueta REAL ou ESTIMADO, e a provisão semanal do IVA.

O que o bot NÃO faz

⚠️ O bot foi concebido para faturas de fornecedores (as tuas compras ao kg/litro) — não lhe envies talões de venda aos teus clientes: as vendas entram pelo SAF-T, e um talão enviado por engano pode ser lido como compras. Também não mexe nos preços da carta por ele: mostra-te o que subiu e recomenda, mas o preço final és sempre tu que decides no simulador. E não é uma conversa: texto solto recebe sempre a mesma resposta — “envia uma foto de fatura 📸 ou /ajuda”.

Se algo correr mal

O bot diz “❌ Código inválido, expirado ou já usado”

O código expira 15 minutos depois de ser gerado e só pode ser usado uma vez. Volta ao simulador (passo 4, cartão da IA), toca em “📱 Ligar o Telegram” para gerar um novo e envia /ligar com o código novo.

O bot diz “🔒 Primeiro liga este chat à tua conta”

Esse chat ainda não está associado a nenhuma conta. Faz /ligar CÓDIGO com o código do simulador (passo 4) e volta a enviar a fatura.

Enviei a fatura e não aconteceu nada

Dá-lhe um momento — a leitura normalmente demora alguns segundos, mas pode demorar mais consoante o ficheiro e o serviço de IA; e se houver outra fatura à frente o bot avisa que a tua fica em espera. Se mesmo assim não responder, envia /ajuda para testar a ligação; não respondendo, fala com o teu gestor O Sócio.

O bot não conseguiu ler a fatura

Recebeste “❌ Não consegui ler esta fatura”? Não perdeste nada. Tenta outra foto mais nítida (papel esticado, sem sombras) ou envia o PDF original do fornecedor.