Desenvolvimento de bots e Mini Apps no Telegram

O que um bot no Telegram pode fazer

O bot pode ficar no chat, num Mini App ou nos dois. As demos públicas deste site — loja digital, comunidade paga, avisos de contato e exportação de registros — são fluxos nossos, não cases de clientes, e não limitam um projeto novo. Esta página é a visão de Telegram. O desenvolvimento sem prender a uma plataforma está em bots e assistentes de IA sob medida.

O primeiro passo é uma ação clara, não uma lista de funções de todos os setores. Quando essa ação é aceita, os passos seguintes entram à parte.

• Atendimento e pedidos: responde com a sua tabela, registra um contato e passa o que não está claro para uma pessoa.
• Loja e pagamentos: catálogo, pagamento de um bem digital e entrega do arquivo ou do aviso.
• Assinaturas: acesso pago, lembrete antes do fim e uma tela para quem administra o grupo.
• Relatórios internos: resumo do dia, alerta de limite ou botão de aprovação num chat que a equipe já abre.
• Monitoramento: aviso quando um preço, estoque ou status público muda, dentro das regras do site.
• Assumir um bot existente: o desenvolvedor sumiu, o bot falha e o processo ainda precisa rodar.

Demos que dá para abrir

Abaixo estão demos próprias e um projeto interno. Dados de exemplo estão marcados como exemplo. Não há logo de cliente, contagem de usuários nem depoimento.

A loja de produtos digitais é uma demo que funciona no Telegram. A pessoa vê os produtos, paga com Telegram Stars e recebe um arquivo digital. Quem administra usa uma área separada para pedidos e suporte. Olhar a prévia é grátis. Um teste de compra no Telegram custa 1 Star: é uma cobrança do Telegram, não o preço do desenvolvimento.

A comunidade paga também é uma demo em funcionamento. Um pagamento único em Stars compra um número de dias e não se repete sozinho. A prévia somente leitura não altera assinatura nem recebe pagamento.

O aviso de contatos do site é o fluxo que o formulário do botfromzero usa. Um contato salvo pode ir para o Telegram. A figura na página inicial é uma ilustração com dados de exemplo e não envia mensagem.

A exportação de registros é uma demo web pequena, com API real de salvar e buscar e download em CSV. Não está ligada a Google Sheets, Drive ou CRM. Essa ligação é avaliada pelo API e pelos acessos que você puder fornecer.

Telegram Stars para bens digitais

A documentação de pagamentos do Telegram para bens e serviços digitais diz que essas vendas dentro do Telegram usam Telegram Stars, código de moeda XTR. A pessoa compra Stars do Telegram. O bot envia a cobrança, precisa responder à pré-checagem em 10 segundos e só entrega depois de receber a atualização de pagamento concluído. Responder à pré-checagem não prova que o pagamento terminou.

Quem é dono do bot guarda o identificador do pagamento, porque um reembolso usa o método do Telegram. Também oferece os termos e o suporte de pagamento e trata disputas. O documento diz que Stars podem ser usados em anúncios do Telegram ou aceitos como a recompensa que o Telegram atribui a cada Star. Transformar esse saldo num pagamento é entre o dono do bot e o Telegram, pelos termos de desenvolvedor. Nós não recebemos, guardamos nem repassamos dinheiro de clientes. Registramos que o evento de pagamento aconteceu e entregamos o bem digital combinado.

O mesmo documento aponta um fluxo separado para bens físicos. Se você envia um produto físico, diga isso no início para o pagamento ser avaliado pelas regras de bens físicos, e não por Stars.

Mini Apps, grupos e mudanças da API

Um Mini App é uma tela web aberta dentro do Telegram. Serve quando as pessoas precisam ver um catálogo, uma área de membro ou um formulário que fica ruim partido em mensagens curtas. Muitos bots não precisam disso. Botões bastam para um aviso, um pedido simples ou uma aprovação. A loja e a comunidade usam Mini App. O aviso de contato não usa. Isso entra no escopo, não é o padrão.

Num grupo ou canal o bot só faz o que o chat permite. Remover um membro, publicar num canal ou ler certas atualizações em geral exige adicionar o bot e dar os direitos de administrador correspondentes. Esses direitos vão para a lista de aceitação. Uma captura do botão desejado não é a permissão.

A Bot API muda. Um bot em produção precisa de alguém que note as mudanças, mantenha o processo no ar e faça ajustes pequenos. Isso cabe na hospedagem mensal quando você a contrata. O token fica na sua conta do BotFather. Não entra no repositório, no site nem num chat.

Assumir um bot que já existe

Se você ainda controla o bot no BotFather, o nome de usuário e as conversas podem continuar nesse bot enquanto o código vai para um servidor e contas seus. Se o bot antigo não puder ser recuperado, um bot novo é uma conversa nova e as pessoas precisam começar de novo. Pedidos ou assinaturas podem ser importados quando existe uma exportação. Sem código, os fluxos importantes podem ser refeitos com os dados e APIs que restarem. Capturas de tela não bastam para prometer uma edição linha a linha.

A avaliação está na página de assumir e corrigir. A hospedagem depois da correção é opcional. Assumir e corrigir começa com um check gratuito e um orçamento do problema. A hospedagem é mensal, com preço conforme a complexidade. O orçamento vem depois da avaliação.

Preço, código-fonte e lançamento

O trabalho sob medida no Telegram começa em US$500. O orçamento depende das funções, das interfaces e das verificações com que você aceita o bot. Você pode levar o código e implantar, ou pedir a implantação. O cuidado contínuo é outro acordo: monitoramento, backups, falhas, mudanças da Bot API e pequenos ajustes dentro de uma franquia. Se a hospedagem terminar, você recebe código, dados e notas de implantação.

Antes do desenvolvimento fica escrito quem usa, o que envia, o que deve receber e o que acontece se o pagamento em Stars, um arquivo ou um serviço externo falhar. Essa lista é a aceitação. Ela também impede que uma mudança posterior vire uma reescrita.

O que não aceitamos

Não aceitamos apostas, conteúdo adulto, engajamento falso ou fazenda de contas, spam nem coleta que burle captcha ou login.

Perguntas antes de começar

Quem saca os Telegram Stars?

Você. Stars de bens digitais seguem as regras do Telegram, e a recompensa ou o anúncio fica entre o dono do bot e o Telegram. Não somos processador de pagamento e não sacamos o saldo por você.

Os usuários antigos acompanham a mudança?

Se você ainda controla o bot no BotFather, o nome e as conversas continuam nesse bot. Um bot novo é um chat novo. Registros só migram quando existe uma exportação.

Preciso de um Mini App?

Não por padrão. Use Mini App quando um catálogo, uma área de membro ou um formulário longo não cabe em botões. Um aviso ou uma aprovação curta pode ficar no chat.