Trade Notifier for LINE Discord Telegram MT4
- Utilitários
-
Kazuma Uezono
Desenvolvedor MQL5 / MQL4 / Pine Script v6. Crio indicadores, utilitários e Expert Advisors para MetaTrader 4/5 e TradingView.
Serviços:
- Conversão de Pine Script do TradingView para MT5/MT4
- Migração de MT4 para MT5
- Correção de erros e novos recursos em EAs e indicadores existentes - Versão: 1.4
- Ativações: 5
Esta versão para MetaTrader 4 do Trade Notifier publica a atividade da sua conta MT4 em um chat do LINE, um canal do Discord ou um chat do Telegram. Você recebe uma mensagem quando uma operação é aberta ou fechada (com o resultado em dinheiro e em pips), quando o SL ou o TP é movido, quando uma ordem pendente é colocada, excluída, expirada ou executada, quando o nível de margem cai abaixo do seu nível, quando o prejuízo flutuante ultrapassa o seu nível, e uma vez por dia com um resumo. O Discord e o Telegram também podem mostrar uma imagem do gráfico.
O EA apenas lê e informa. Ele não coloca, modifica nem fecha nenhuma ordem, não escolhe operações e não dá sinais. Nenhuma DLL é usada. Cada mensagem é enviada do seu MT4 diretamente para a sua própria conta oficial do LINE, webhook do Discord ou bot do Telegram, nunca por um servidor operado por nós.
Feito para: usuários do MT4 que executam EAs em um VPS ou operam manualmente e querem uma mensagem curta no celular ou em um canal da equipe sempre que algo acontece na conta. Usuários do LINE podem voltar a receber mensagens pela LINE Messaging API após o fim do LINE Notify (março de 2025); a configuração e a cota gratuita são diferentes, como explicado abaixo.
Recursos
- Envio para LINE (Messaging API, texto), Discord (webhook, texto mais imagem do gráfico) e Telegram (bot, texto mais imagem do gráfico). Ative ou desative cada um; vários ao mesmo tempo também funcionam.
- Escolha os eventos: operação aberta, ordem pendente executada, operação fechada com lucro ou prejuízo (swap e comissão incluídos) e pips, SL / TP movido em uma operação ou em uma ordem pendente, ordem pendente colocada / excluída / expirada, nível de margem abaixo de um nível (padrão 150%), prejuízo flutuante acima de uma parcela do saldo (padrão 10%), resumo diário na mudança da data do servidor (operações fechadas, ganhos e perdas, resultado líquido, saldo, patrimônio).
- Ponte para os seus próprios programas: um indicador, EA ou script no mesmo computador grava um pequeno arquivo de texto na pasta de dados comum e o Trade Notifier envia o texto dele. Indicadores não podem fazer requisições web em MQL4, então esta é a forma de levar os alertas deles ao LINE, Discord ou Telegram. O guia mostra o formato do arquivo e uma função MQL4 pronta.
- Filtro por símbolo (todos, o símbolo do gráfico ou uma lista) e por número mágico (todos, operações manuais com magic 0 ou uma lista).
- Mantém baixo o número de mensagens: eventos que ocorrem em até 5 segundos (0-60, ajustável) chegam como uma única mensagem. Para o LINE, um contador mensal com o seu próprio limite (padrão 180) avisa uma vez em 90% e depois para apenas o LINE; Discord e Telegram continuam.
- Mensagens que não puderam ser enviadas aguardam em uma fila salva e são enviadas quando possível, também depois que o MT4 é reiniciado. Nada é enviado duas vezes de propósito.
- Botão de envio de teste no painel do gráfico, com o resultado mostrado por destino.
- O painel mostra para LINE, Discord e Telegram: OK com o código HTTP, não configurado, URL não permitida, aguardando por excesso de requisições, ou o erro, além da contagem do LINE no mês, do número de mensagens aguardando e do horário do último envio.
- 11 idiomas para mensagens e painel (inglês, japonês, russo, alemão, francês, chinês, coreano, turco, espanhol, português, italiano), a partir do idioma do terminal ou definido nos parâmetros.
- Um arquivo CSV registra cada evento e cada envio. Uma configuração de simulação (dry run) grava as requisições em arquivos e não envia nada (tokens ocultos).
Parâmetros principais
- LINE: enviar (desativado por padrão), token de acesso do canal, enviar para (ID de usuário ou ID de grupo), limite mensal (180 por padrão, 0 = nenhum), pessoas que recebem (1 por padrão; o LINE conta cada destinatário).
- Discord: enviar (desativado por padrão), URL do webhook, anexar imagem do gráfico (ativado por padrão).
- Telegram: enviar (desativado por padrão), token do bot, ID do chat, anexar imagem do gráfico (ativado por padrão).
- Eventos: operação aberta, operação fechada, SL / TP alterado, ordens pendentes (todos ativados), nível de margem abaixo de % (150, 0 = desativado), prejuízo flutuante acima de % do saldo (10, 0 = desativado), resumo diário (ativado), mensagens de outros programas (ativado).
- Filtros: símbolos (todos / símbolo do gráfico / lista), lista de símbolos, números mágicos (todos / somente manuais / lista), lista de números mágicos.
- Envio: combinar eventos dentro de (5 s), desistir após (24 horas, 1-168), tempo limite da requisição (5000 ms), idioma, título de cada mensagem (vazio = MT4 e os 4 últimos dígitos da conta).
- Painel: mostrar, canto, deslocamento X e Y, tamanho da fonte. Avançado: log CSV, simulação (dry run).
Como funciona
- Primeiro você cria uma conta oficial do LINE com um token de acesso do canal, um webhook do Discord ou um bot do Telegram. No MT4, abra Tools > Options > Expert Advisors, marque Allow WebRequest for listed URL e adicione https://api.line.me (LINE), https://discord.com (Discord, ou o host com que começa a URL do seu webhook; o painel o indica) e https://api.telegram.org (Telegram). Pressione Test send para verificar. Cada passo está no guia do usuário.
- O EA compara as ordens abertas com a última verificação e lê o histórico da conta, depois informa as diferenças. Todos os horários são do servidor e são marcados com "(server)".
- Quando o MT4 está fechado, nada pode ser enviado. Após a próxima inicialização, as operações fechadas e outras mudanças desde a última execução são informadas, até 2 dias atrás e sem repetições. Na primeira vez que o EA é anexado, o histórico mais antigo não é enviado.
- Uma imagem do gráfico (Discord e Telegram; operações abertas, executadas e fechadas e o envio de teste) só é criada quando um gráfico desse símbolo está aberto no MT4. Sem esse gráfico, o texto é enviado sozinho. A imagem mostra o gráfico inteiro, incluindo este painel.
- Envios com falha (sem conexão, tempo esgotado, erro do servidor) são repetidos após 10 s, 30 s, 60 s, 2 min, 5 min e depois a cada 10 min até o tempo de desistência (24 horas por padrão). Em caso de HTTP 429, o EA espera o tempo que o serviço pede. Cada destino mantém a sua ordem: enquanto um continua falhando, as mensagens mais novas dele aguardam atrás das antigas; os outros destinos não ficam retidos.
- Limite mensal do LINE: o EA conta as mensagens do LINE por destinatário em cada mês civil no horário do servidor. Quando o seu limite é atingido, ou o LINE responde que o limite mensal do seu plano foi esgotado, o LINE é pausado e o Discord e o Telegram continuam. O LINE volta no mês seguinte ou quando você altera o parâmetro de limite mensal; após o limite próprio do LINE, um envio de teste bem-sucedido também o traz de volta. As mensagens do LINE durante a pausa são descartadas, não enviadas depois.
- Apenas um gráfico por conta envia. Cópias extras do EA em outros gráficos da mesma conta apenas mostram o painel.
- Mensagens de outros programas: arquivos *.txt na pasta comum Terminal\Common\Files\TradeNotifier\queue\ são verificados a cada 2 segundos, lidos em ordem de nome e excluídos após a leitura. Primeira linha opcional: destinos (all, line, discord, telegram) e "shot" para uma imagem do gráfico; o texto segue a partir da segunda linha. São aceitos arquivos UTF-8 (com ou sem BOM), UTF-16 LE com BOM e ANSI, de até 64 KB, com texto de até 3000 caracteres.
- Mensagens para o Discord não mencionam @everyone nem cargos.
Notas e limitações
- Os tokens e a URL do webhook ficam legíveis como texto simples: nos parâmetros do EA, em arquivos .set salvos, em perfis e modelos de gráfico (.chr / .tpl), e o MT4 grava todos os parâmetros do EA no log Experts cada vez que ele é carregado. Quem os tiver pode publicar na sua conta do LINE, canal do Discord ou bot do Telegram. Não compartilhe esses arquivos ou logs, oculte a janela de parâmetros ao compartilhar a sua tela e tenha cuidado em um PC ou VPS compartilhado. Crie um novo token se algum vazar.
- A menos que você preencha o parâmetro Title, cada mensagem começa com "MT4" e apenas os 4 últimos dígitos do número da sua conta, como [MT4 #…1234]. Se outras pessoas puderem ler o canal ou o grupo, recomendamos um texto próprio; ele substitui esse título.
- O LINE envia apenas texto. São necessários uma conta oficial do LINE com a Messaging API, o token de acesso do canal dela e o ID de usuário ou ID de grupo. As mensagens usam a cota mensal do seu plano do LINE, que o LINE Notify não tinha (plano gratuito no Japão atualmente com 200 mensagens por mês; o LINE define e pode alterar preços e condições). Um grupo conta uma vez por membro, então configure "pessoas que recebem". O contador do EA é apenas uma estimativa; o que vale é a contagem do LINE, incluindo outras mensagens da mesma conta. Encontrar um ID de grupo exige um webhook, que o EA não oferece; a configuração fácil é enviar para o seu próprio ID de usuário.
- O MT4 precisa estar em execução e online com o EA em um gráfico. Use um VPS para avisos 24 horas por dia.
- Executar o EA na mesma conta em dois terminais (por exemplo, PC de casa e VPS) envia tudo duas vezes. A pasta comum usada por outros programas é compartilhada por todos os terminais do computador.
- Somente MT4: uma ordem pendente executada em cerca de 1 segundo após ser colocada pode ser informada como operação aberta em vez de ordem pendente executada. Uma operação que foi aberta e fechada enquanto o MT4 estava desligado é informada apenas como fechada.
- Após uma parada forçada do terminal, o Discord ou o Telegram podem raramente receber uma mensagem duas vezes. O LINE é protegido por uma chave de nova tentativa.
- O resumo diário é enviado na mudança da data do servidor e conta as operações fechadas naquele dia dentro dos filtros (um fechamento parcial conta como uma operação). Se o MT4 estava desligado nesse momento, o último dia que o EA viu é resumido na próxima inicialização.
- No Testador de Estratégia nada é enviado; as mensagens são apenas gravadas em um arquivo CSV.
- Mova o painel com os parâmetros de canto e X / Y se ele cobrir o painel One Click Trading (padrão Y = 100). Se ele for difícil de ver, desative "Chart on foreground" nas propriedades do gráfico.
- O MT4 mostra o texto do gráfico, como o painel do EA, com a configuração de idioma do Windows (página de código ANSI). Se o idioma escolhido usar caracteres que essa configuração do Windows não suporta (por exemplo, coreano em um Windows japonês ou inglês), apenas o painel passa automaticamente para o inglês; as mensagens enviadas ao LINE, Discord e Telegram continuam no idioma escolhido.
Compatibilidade e suporte
- MetaTrader 4, qualquer símbolo, um gráfico por conta. São necessários acesso à internet e permissão de WebRequest para os endereços acima. Contas do Discord e do Telegram não custam nada; o LINE precisa de uma conta oficial do LINE (plano gratuito no Japão; o LINE decide os planos em outros países).
- Sem DLL. Arquivos apenas em MQL4\Files\TradeNotifier\ e na pasta comum TradeNotifier\queue\.
- Ajuda por mensagem do MQL5 em até 3 dias úteis para instalação, configurações (LINE, Discord, Telegram, WebRequest) e bugs. Não podemos configurar nem operar as suas contas do LINE, Discord ou Telegram por você, e não damos conselhos de trading nem opiniões sobre o mercado.
- LINE, Discord e Telegram são marcas registradas de seus respectivos proprietários, que não fabricam, endossam nem apoiam este produto.
Aviso legal
- Este EA é uma ferramenta de notificação. Ele não opera e não dá aconselhamento de investimento. As mensagens podem chegar atrasadas, não chegar ou chegar duas vezes por causa do MT4, da rede ou dos serviços LINE, Discord e Telegram, então não as use como a única forma de acompanhar a sua conta. Você é responsável por quaisquer tarifas do plano do LINE. Teste-o primeiro em uma conta demo.
