Conectando o bot
O bot é configurado pelo sistema unificado de Conexões — não existe nenhum token para colar manualmente. No app, adicione uma conexão do Telegram e ele te entrega a etapa exata de vínculo.
Em um chat pessoal, o bot abre com um deep link exclusivo /start <token> — ao pressionar Start, esse token é enviado e o bot conecta sua conta. Em um grupo ou canal, você adiciona o bot e envia o comando /start exclusivo pela sua conta pessoal.
Cada conta se vincula uma vez só. Se você tentar conectar um chat já vinculado, o bot avisa que ele já está conectado.
Chat privado x grupo
Em um grupo ou canal, o bot apenas envia notificações — todos os comandos sob demanda funcionam somente em chat privado. Como o próprio bot diz: "Em um chat/grupo, eu só consigo enviar notificações. Todos os outros comandos estão disponíveis apenas em mensagens privadas comigo."
Ou seja: use as conexões de grupo para enviar alertas ao time e converse com o bot em um chat privado para puxar relatórios e posições abertas.
Comandos do bot
Use estes comandos no seu chat privado com o bot para buscar dados sob demanda:
- •
/start— a lista de todos os comandos e o status do seu perfil (plano e validade). - •
/mytrades— suas posições abertas no momento, com PnL flutuante e preço médio de entrada. - •
/dayreport— um mini relatório do dia atual, para uma chave de API escolhida. - •
/weekreport— um mini relatório da semana; você escolhe a semana e a chave de API. - •
/monthreport— um relatório do mês. - •
/hot— as moedas quentes: os tickers com mais operações em um período. - •
/balance— o saldo da sua conta.
Notificações de operações
O bot envia alertas em tempo real conforme as operações acontecem. Cada notificação identifica a conta (nome da chave de API), o lado (long/short), o ticker e a ação — operação aberta, ordem executada ou operação fechada.
Os alertas de abertura e de execução acrescentam a ação de compra/venda, o preço de execução, o volume da ordem, o PnL e um link para a operação (a menos que o modo de privacidade esteja ativo). Os tipos de alerta e o formato da mensagem são configurados na própria conexão — veja Conexões para os tokens de modelo.
Os alertas de operação (abertura / execução / fechamento) exigem o plano Trader ou superior; os comandos sob demanda e a lista de posições abertas funcionam em qualquer plano.
Registrando o diário pelo Telegram
Toda notificação traz botões interativos para enriquecer a operação sem abrir o app web. Toque em um botão para adicionar:
- •Descrição e conclusão — envie o texto e o bot anexa à operação.
- •Motivos de entrada (tags) — categorize a operação.
- •Capturas de tela — envie imagens (PNG/JPG, até 3MB cada) e elas são anexadas à operação.
- •Links de vídeo — envie um link (não um arquivo de vídeo) para anexar.
Tudo sincroniza
Tudo o que você adiciona pelo bot sincroniza na hora com o seu diário na plataforma web — a descrição que você ditou no celular já está na operação quando você abre Minhas operações no desktop.