Mensagens
Integração Telegram
Um bot de Telegram para criar e enviar faturas a partir do telemóvel, e para receber alertas internos de pagamentos, encomendas e erros.
Visão geral
Telegram
O Telegram tem uma vantagem prática para uso interno: a Bot API é gratuita, não exige aprovação de modelos e permite bots com botões, menus e envio de ficheiros. Para equipas pequenas que passam o dia fora do escritório, é uma forma direta de fazer trabalho administrativo sem abrir um computador.
A Tejobit cria um bot privado ligado ao software de faturação da empresa. O responsável escreve algo como "fatura para a Padaria Sol, 120 euros, serviço de manutenção", o bot procura o cliente, mostra o resumo com botões para confirmar ou corrigir, e depois de confirmado cria o documento no programa de faturação, que o emite. O PDF volta pelo chat e pode seguir por e-mail para o cliente.
O mesmo bot serve de canal de alertas: um pagamento recebido, uma encomenda nova, um stock abaixo do mínimo ou uma sincronização que falhou chegam como mensagem ao grupo da equipa.
Casos de uso
Para que serve
- Técnico de manutenção ou instalador que fatura no local logo a seguir ao serviço.
- Dono de restaurante que recebe no telemóvel o fecho de caixa do dia.
- Loja online que avisa o grupo de armazém sempre que entra uma encomenda paga.
- Contabilista ou gestor que pede ao bot a lista de faturas por cobrar de um cliente.
- Alerta imediato quando uma integração falha, em vez de descobrir dias depois.
O que a ligação escuta
- Mensagens e comandos enviados ao bot por utilizadores autorizados, recebidos por webhook.
- Toques em botões de confirmação (callback queries) nas mensagens do bot.
- Eventos de outros sistemas: pagamento recebido, encomenda nova, erro de sincronização.
O que a ligação faz
- Interpretar o pedido, procurar o cliente e o artigo no software de faturação e mostrar um resumo para confirmação.
- Criar o documento no programa de faturação e devolver o PDF no chat.
- Enviar o documento ao cliente por e-mail a partir do próprio software de faturação.
- Publicar alertas e resumos num grupo ou canal da equipa.
Como funciona
Do pedido à ligação em funcionamento
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 02
Análise e proposta
A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 04
Manutenção e monitorização
A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.
A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.
O que é preciso preparar
- Uma conta de Telegram para cada pessoa que vai usar o bot.
- Acesso à API do software de faturação, com uma série de documentos definida para o bot.
- A lista de pessoas autorizadas e o que cada uma pode fazer (criar documentos, só consultar, só receber alertas).
Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.
Limites
- Um bot de Telegram não pode iniciar conversa com alguém que nunca falou com ele; serve sobretudo para uso interno, não para contactar clientes.
- A Bot API limita o ritmo de envio, cerca de uma mensagem por segundo por conversa e menos em grupos, o que chega para alertas mas não para envios em massa.
- Ficheiros enviados pelo bot têm limite de tamanho (50 MB), mais do que suficiente para faturas.
- O bot não decide sozinho: pedidos ambíguos pedem esclarecimento e nada é emitido sem confirmação.
Perguntas frequentes
Antes de começar
Porquê Telegram e não WhatsApp?
Para uso interno, o Telegram é mais simples: não há custo por mensagem, nem aprovação de modelos, nem verificação de empresa. Para falar com clientes, o WhatsApp costuma ser melhor escolha porque é onde eles estão.
Qualquer pessoa pode usar o bot se o encontrar?
Não. O bot só responde a contas de Telegram autorizadas e ignora as restantes. Os pedidos ficam registados com o autor e a hora.
Que software de faturação é compatível?
Os que têm API para criar documentos, como o Moloni ou o InvoiceXpress. É o software certificado que emite a fatura e a comunica à AT; o bot apenas lhe entrega os dados confirmados.
Integrações relacionadas
Ver todas as integrações- Faturação
Moloni
Cada venda paga noutro sistema passa a fatura no Moloni, na série certa e com o cliente identificado pelo NIF.
Desde 5 € /mês + IVA
Ver integração - Faturação
InvoiceXpress
Faturas, recibos e notas de crédito criados no InvoiceXpress a partir de pagamentos, subscrições ou encomendas, na sequência certa.
Desde 5 € /mês + IVA
Ver integração - Mensagens
Slack
Notificações de vendas, pagamentos e erros no canal certo do Slack, com botões para aprovar e comandos para consultar dados.
Desde 5 € /mês + IVA
Ver integração
Ativar a integração Telegram?
Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.