Telegram Trade Notifier MT5
- Utilitários
- Versão: 1.0
- Ativações: 10
Receba no Telegram cada operação da sua conta MT5: abertura, fechamento, fechamento parcial, alterações de SL/TP e ordens pendentes, além de um relatório diário da conta. A configuração leva 3 minutos, e o utilitário avisa em palavras simples se algo estiver errado.
Saiba o que acontece na sua conta sem abrir o MetaTrader. O Telegram Trade Notifier envia uma mensagem clara para o seu chat, grupo ou canal do Telegram toda vez que algo acontece na sua conta MT5. Funciona com operações manuais, operações de qualquer Expert Advisor e operações abertas pelo app móvel ou pelo terminal web, desde que o terminal com o utilitário esteja rodando (recomenda-se uma VPS).
COMO FUNCIONA
- Você cria o seu próprio bot privado do Telegram (grátis, 1 minuto com o @BotFather).
- Você anexa o Telegram Trade Notifier a qualquer gráfico no MetaTrader 5.
- O utilitário observa a conta inteira. Quando uma operação é aberta, fechada ou alterada, ele monta uma mensagem curta e envia para o seu bot.
- Seu bot entrega a mensagem no seu celular, como qualquer chat do Telegram.
As mensagens vão diretamente do seu MetaTrader para o Telegram. Não há servidor de terceiros, e o token do seu bot nunca sai do seu terminal.
O QUE VOCÊ RECEBE
- Posição aberta: direção, símbolo, lote, preço, SL, TP, ticket e número mágico
- Posição fechada: lucro total na moeda da conta (swap e comissão incluídos), preço de abertura e fechamento, motivo do fechamento (Stop Loss, Take Profit, manual, Expert Advisor, Stop Out) e duração da operação
- Fechamento parcial: lote fechado, lucro da parte fechada e lote restante
- Alteração de SL / TP: novos níveis e resultado flutuante
- Ordens pendentes: colocadas (com preço, SL e TP), modificadas, excluídas e expiradas
- Relatório diário no horário que você escolher: operações fechadas, ganhos e perdas, resultado líquido, melhor e pior operação, saldo, patrimônio e posições abertas
UMA OPERAÇÃO, UMA MENSAGEM LIMPA
- SL/TP adicionados logo após a abertura entram na mensagem OPEN, em vez de mensagens extras
- Várias alterações rápidas de SL/TP são combinadas em uma única atualização com os valores finais
- O trailing stop envia no máximo uma atualização a cada 30 segundos, então seu chat nunca fica lotado
- As mensagens sempre chegam na ordem certa
PARA QUEM É
- Traders que rodam Expert Advisors em uma VPS e querem acompanhá-los pelo celular
- Traders de mesas proprietárias (prop firms) que querem um registro escrito de cada operação e um resultado diário
- Provedores de sinais que querem publicar suas operações em um canal do Telegram automaticamente
FILTROS
- Número mágico: todas as operações, apenas manuais ou um único Expert Advisor
- Símbolos: todos os símbolos ou uma lista como EURUSD,XAUUSD (sufixos como EURUSD.m são reconhecidos automaticamente)
CONFIGURAÇÃO PASSO A PASSO (cerca de 3 minutos)
Passo 1 - Crie seu bot. No Telegram, abra o @BotFather e envie /newbot. Escolha um nome e depois um nome de usuário terminado em "bot". O BotFather responde com o token do seu bot (parece com 123456789:AAH...). Copie tudo.
Passo 2 - Inicie seu bot. Abra seu novo bot (t.me/your_bot) e toque em START. Isso é obrigatório: um bot do Telegram não pode escrever para você antes de você tocar em Start.
Passo 3 - Pegue o SEU Chat ID. Envie qualquer mensagem para o @userinfobot. Ele responde com o seu Id, um número como 123456789. Esse é o seu Chat ID. NÃO use o número do início do token do bot: esse é o ID do próprio bot. Para um grupo, adicione seu bot ao grupo. Para um canal, adicione seu bot como administrador. IDs de grupos e canais começam com -100.
Passo 4 - Permita a conexão no MetaTrader 5. Ferramentas > Opções > Expert Advisors. Marque "Permitir WebRequest para as URLs listadas" e adicione: https://api.telegram.org
Passo 5 - Anexe o utilitário. Arraste o Telegram Trade Notifier MT5 para qualquer gráfico, cole o token do bot e o seu Chat ID e clique em OK. Em poucos segundos o gráfico mostra "Status: Connected to @your_bot" e você recebe "Telegram Trade Notifier is running" no Telegram. Pronto.
O QUE SIGNIFICA O STATUS NO GRÁFICO
O utilitário verifica seu token e seu Chat ID assim que inicia, antes de qualquer operação. Se algo estiver errado, o gráfico diz exatamente o que corrigir, e um alerta aparece uma única vez. Ele não fica tentando de novo uma configuração que não pode funcionar.
- Connected to @your_bot: tudo funcionando.
- Checking connection...: a primeira verificação está em andamento (alguns segundos).
- SETUP NEEDED: leia a linha abaixo, corrija o parâmetro (F7 no gráfico) e clique em OK.
- WAITING: o MetaTrader está bloqueando a conexão. Adicione https://api.telegram.org como no passo 4. Não precisa reiniciar: as mensagens são enviadas assim que for permitido.
- Messages in queue: mensagens esperando envio. Elas são entregues automaticamente quando a conexão funcionar.
SOLUÇÃO DE PROBLEMAS
- "The Chat ID is your BOT's ID" - você colou o número do bot (a parte do token antes de ":"). Use o seu próprio ID do @userinfobot.
- "Chat ID not found" - abra seu bot e toque em Start, depois confira o número do @userinfobot. IDs de grupos e canais começam com -100.
- "Your bot cannot write to you yet" ou "You blocked your bot" - abra seu bot no Telegram, desbloqueie se necessário e toque em Start.
- "The Bot token is wrong or was revoked" - copie o token de novo no @BotFather: /mybots > seu bot > API Token.
- "Your bot is not allowed in this group/channel" - adicione o bot ao grupo, ou como administrador do canal.
- "MetaTrader blocks the connection" - adicione https://api.telegram.org em Ferramentas > Opções > Expert Advisors (passo 4).
- As mensagens pararam de chegar - verifique se o MetaTrader está aberto e conectado à corretora. Os avisos só são enviados enquanto o terminal está aberto, por isso recomenda-se uma VPS.
PARÂMETROS
- Bot token: o token do @BotFather
- Chat ID: o ID do seu usuário, grupo ou canal
- Account name in messages: um rótulo como "Prop 100k" (vazio = número da conta)
- Position opened / Position closed / Partial close / SL / TP changed / Pending orders: liga ou desliga cada evento
- Max wait to combine SL/TP changes (seconds): várias alterações de SL/TP são combinadas em uma mensagem com os valores finais. O trailing stop envia no máximo uma mensagem por este período
- Wait for SL/TP after opening (seconds): SL/TP definidos logo após a abertura entram na mensagem OPEN. Padrão 15, 0 = enviar OPEN na hora
- Magic number: -1 = todas as operações, 0 = operações manuais, qualquer outro valor = somente esse Expert Advisor
- Symbols: vazio = todos os símbolos, ou uma lista separada por vírgulas
- Send daily summary / Report hour / Report minute: relatório diário no horário do servidor escolhido
- Send a test message on start: mensagem de teste ao iniciar
OBSERVAÇÕES
- Um gráfico basta para toda a conta. Não anexe duas vezes, ou você receberá cada mensagem em dobro.
- O utilitário não abre, altera nem fecha nenhuma operação.
- No Testador de Estratégias nenhuma mensagem é enviada, porque o Telegram não está disponível lá.
Dúvidas ou sugestões? Envie-me uma mensagem privada no MQL5. Se o utilitário ajudar você, uma breve avaliação é muito bem-vinda.
