Trade Notifier for LINE Discord Telegram
- 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.3
- Ativações: 5
O Trade Notifier envia para LINE, Discord e Telegram o que acontece na sua conta MetaTrader 5: posições abertas e fechadas (com lucro ou prejuízo e pips), alterações de stop-loss e take-profit, ordens pendentes, um nível de margem baixo, uma grande perda flutuante e um resumo diário. As mensagens do Discord e do Telegram podem incluir uma captura de tela do gráfico. Seus próprios indicadores e EAs também podem enviar mensagens por meio dele escrevendo um pequeno arquivo de texto.
É apenas uma ferramenta de notificação. Ela nunca abre, altera ou fecha uma posição ou ordem, e não fornece sinais nem conselhos de trading. Não usa DLL. As mensagens vão diretamente do seu terminal para a sua própria conta oficial do LINE, webhook do Discord ou bot do Telegram; elas não passam por nenhum servidor nosso.
Para quem é: traders que querem ver no celular, ou compartilhar em um canal do Discord ou em um grupo do LINE ou Telegram, o que suas próprias operações manuais ou EAs estão fazendo, por exemplo enquanto um EA roda em um VPS. Usuários do LINE que usavam o LINE Notify (encerrado pelo LINE em março de 2025) podem voltar a enviar para o LINE por meio da LINE Messaging API, com as diferenças explicadas abaixo.
Recursos
- Três destinos, cada um ligado ou desligado, em qualquer combinação: LINE (push da Messaging API, somente texto), Discord (webhook, texto e captura do gráfico), Telegram (bot, texto e captura do gráfico).
- Eventos, cada um ligado ou desligado: posição aberta, ordem pendente executada, posição fechada com lucro ou prejuízo (incluindo swap e comissão) e pips, SL / TP alterado (posições e ordens pendentes), ordem pendente colocada, excluída ou expirada, nível de margem abaixo de um % definido (padrão 150%), perda flutuante acima de um % definido do saldo (padrão 10%), resumo diário quando a data do servidor muda (operações fechadas, ganhos / perdas, lucro ou prejuízo líquido, saldo, patrimônio líquido).
- Mensagens de outros programas: qualquer indicador, EA ou script no mesmo PC pode escrever um arquivo de texto na pasta comum, e o Trade Notifier o envia. Isso também funciona para indicadores, que não podem enviar requisições web por conta própria. O formato do arquivo e um exemplo de código MQL estão no guia do usuário.
- Filtros: todos os símbolos, apenas o símbolo deste gráfico ou uma lista de símbolos; todas as operações, apenas operações manuais (magic 0) ou uma lista de números mágicos.
- Menos mensagens: eventos dentro de 5 segundos (ajustável 0-60) são combinados em uma única mensagem. O LINE tem um contador mensal com o seu próprio limite (padrão 180); em 90% você recebe um aviso, e no limite apenas o LINE para e os outros destinos continuam.
- Mensagens não enviadas são mantidas em uma fila que sobrevive a uma reinicialização e são enviadas novamente mais tarde. Cada evento é enviado apenas uma vez, também após uma reinicialização.
- Botão "Envio de teste" (Test send) no painel: envia uma mensagem de teste para cada destino ligado e mostra o resultado.
- Painel: o estado de cada destino (OK com o código HTTP, não configurado, URL não permitida, limite de taxa, erro com o motivo), mensagens do LINE usadas neste mês, mensagens aguardando envio, horário do último envio.
- Mensagens e painel em 11 idiomas (inglês, japonês, russo, alemão, francês, chinês, coreano, turco, espanhol, português, italiano), automaticamente pelo idioma do terminal ou escolhido nos parâmetros.
- Log CSV de cada evento e de cada tentativa de envio. O modo de simulação (dry run) grava as requisições em arquivos em vez de enviá-las (os tokens são mascarados).
Parâmetros principais
- LINE: enviar (padrão desligado), token de acesso do canal, enviar para (seu ID de usuário ou um ID de grupo), limite mensal (padrão 180, 0 = sem limite), pessoas que recebem (padrão 1; o LINE conta cada pessoa).
- Discord: enviar (padrão desligado), URL do webhook, anexar captura do gráfico (padrão ligado).
- Telegram: enviar (padrão desligado), token do bot, ID do chat, anexar captura do gráfico (padrão ligado).
- O que enviar: posição aberta, posição fechada, SL / TP alterado, ordens pendentes (todos padrão ligado), nível de margem abaixo de % (padrão 150, 0 = desligado), perda flutuante acima de % do saldo (padrão 10, 0 = desligado), resumo diário (padrão ligado), mensagens de outros programas (padrão ligado).
- Quais operações: símbolos (todos / este gráfico / lista), lista de símbolos, números mágicos (todos / apenas manuais / lista), lista de números mágicos.
- Envio: combinar eventos dentro de (padrão 5 segundos), desistir de uma mensagem não enviada após (padrão 24 horas, 1-168), tempo limite de uma requisição (padrão 5000 ms), idioma, título em cada mensagem (vazio = MT5 e os 4 últimos dígitos do número da conta).
- Painel: mostrar, canto, deslocamento X / Y, tamanho da fonte. Avançado: log CSV, simulação.
Como funciona
- Configuração: crie sua conta oficial do LINE e o token de acesso do canal, um webhook do Discord ou um bot do Telegram, e depois adicione os endereços dos servidores em Tools > Options > Expert Advisors > Allow WebRequest for listed URL: https://api.line.me para o LINE, https://discord.com para o Discord (o host da sua URL de webhook; o painel mostra qual adicionar), https://api.telegram.org para o Telegram. Em seguida, pressione "Envio de teste". O guia do usuário explica cada passo com os menus oficiais.
- A ferramenta lê o histórico da conta e as listas de posições e ordens e envia o que mudou. Os horários nas mensagens são o horário do servidor, marcados com "(server)".
- Enquanto o terminal está desligado, nada é enviado. Na próxima inicialização, a ferramenta envia o que aconteceu nesse intervalo, até 2 dias atrás, sem repetir o que já foi enviado. Na primeiríssima inicialização, nada do passado é enviado.
- As capturas do gráfico (Discord e Telegram, em posições abertas, executadas e fechadas e no envio de teste) são feitas apenas se um gráfico desse símbolo estiver aberto no terminal; caso contrário, a mensagem é enviada sem imagem. A imagem mostra o gráfico como ele está, incluindo este painel e tudo o mais que houver nele.
- Se um envio falhar (sem conexão, tempo limite, erro do servidor), ele é tentado novamente após 10 s, 30 s, 60 s, 2 min, 5 min e depois a cada 10 min, até o tempo de desistência (padrão 24 horas). Com HTTP 429, espera-se o tempo que o servidor pedir. As mensagens para um destino são enviadas em ordem, então, enquanto um destino continua falhando, suas mensagens seguintes também esperam; os outros destinos não são afetados.
- Limite mensal do LINE: a ferramenta conta as mensagens do LINE por pessoa em um mês do calendário pelo horário do servidor. Quando o seu limite é atingido, ou o próprio LINE responde que o limite mensal do seu plano foi atingido, o LINE para e os outros destinos continuam. O LINE recomeça no mês seguinte ou quando você altera o parâmetro de limite mensal; após uma parada pelo limite do próprio LINE, um envio de teste bem-sucedido também o reinicia. Mensagens para o LINE criadas enquanto ele está parado não são enviadas depois.
- Apenas um gráfico por conta envia. Se a ferramenta estiver anexada a vários gráficos da mesma conta, os outros mostram apenas o painel.
- Mensagens de outros programas: os arquivos de texto na pasta comum Terminal\Common\Files\TradeNotifier\queue\ são lidos a cada 2 segundos em ordem de nome e excluídos após a leitura. Primeira linha (opcional): os destinos (all, line, discord, telegram) e "shot" para uma captura; a partir da segunda linha: o texto. Codificações aceitas: UTF-8 (com ou sem BOM), UTF-16 LE com BOM, ANSI. Até 64 KB por arquivo e 3000 caracteres de texto.
- As mensagens do Discord nunca mencionam @everyone nem cargos (as menções estão desativadas).
Notas e limitações
- Seus tokens e a URL do webhook são armazenados como texto simples nos parâmetros do EA e nos arquivos que os guardam: conjuntos de parâmetros salvos (.set), perfis de gráfico e templates (.chr / .tpl). O log do Testador de Estratégia também lista os parâmetros. Qualquer pessoa que os obtenha pode publicar na sua conta do LINE, canal do Discord ou bot do Telegram. Não compartilhe esses arquivos nem mostre a janela de parâmetros ao compartilhar sua tela, e tenha cuidado em um PC ou VPS compartilhado. Se um token vazar, emita um novo.
- Por padrão, cada mensagem começa com "MT5" e os 4 últimos dígitos do número da sua conta (por exemplo [MT5 #…1234]). Em canais ou grupos compartilhados, recomendamos escrever seu próprio texto no parâmetro Title; assim o título mostra apenas esse texto.
- LINE: somente texto, sem imagens. Você precisa de uma conta oficial do LINE com a Messaging API ativada, um token de acesso do canal e o ID de usuário ou ID de grupo para onde enviar. Diferentemente do LINE Notify, as mensagens contam na cota mensal de mensagens do seu plano do LINE (no Japão, o plano gratuito atualmente permite 200 mensagens por mês; preços, cotas e condições são definidos pelo LINE e podem mudar). Um grupo de N pessoas conta como N mensagens por envio: configure "pessoas que recebem". O contador desta ferramenta é uma estimativa; o que vale é a contagem do próprio LINE (inclusive de mensagens enviadas da mesma conta por outros meios). Um ID de grupo só pode ser obtido com um webhook, que esta ferramenta não fornece; enviar para o seu próprio ID de usuário é a configuração simples.
- Funciona apenas enquanto o MetaTrader 5 está em execução e conectado e a ferramenta está anexada a um gráfico. Recomenda-se um VPS para notificações constantes.
- Se a mesma conta estiver conectada em dois terminais (por exemplo seu PC e um VPS) e ambos executarem a ferramenta, ambos enviam, então você recebe cada mensagem duas vezes. A pasta comum para mensagens de outros programas é compartilhada por todos os terminais no mesmo PC.
- Em casos raros (por exemplo, se o terminal for encerrado à força logo após um envio), o Discord ou o Telegram podem receber a mesma mensagem duas vezes. O LINE usa uma chave de nova tentativa que impede isso.
- Contas netting: uma reversão é informada como um fechamento e uma nova posição. Isso foi verificado apenas de forma limitada em contas reais.
- O resumo diário é feito quando a data do servidor muda e conta as operações fechadas naquele dia que passam pelos filtros (cada fechamento parcial conta como uma operação). Se o terminal estava desligado na mudança de data, o resumo do último dia que ele viu é enviado na próxima inicialização.
- Testador de Estratégia: nada é enviado. As mensagens que seriam enviadas são gravadas apenas em um arquivo CSV.
- O painel pode se sobrepor ao painel de negociação com um clique; por padrão ele fica mais abaixo (Y = 100). Mova-o com os parâmetros de canto e X / Y.
Compatibilidade e suporte
- MetaTrader 5, contas hedging e netting, qualquer símbolo. Anexe-o a um único gráfico. Precisa de conexão com a internet e permissão de WebRequest para os endereços acima. As contas do Telegram e do Discord são gratuitas; o LINE precisa de uma conta oficial do LINE (existe um plano gratuito no Japão; a disponibilidade e as cotas em outros países são definidas pelo LINE).
- Sem DLL. Os arquivos são gravados apenas em MQL5\Files\TradeNotifier\ e na pasta comum TradeNotifier\queue\.
- Suporte por mensagens do MQL5, resposta em até 3 dias úteis: instalação, configurações (LINE, Discord, Telegram, WebRequest) e relatos de bugs. Não podemos criar nem operar suas contas do LINE, Discord ou Telegram, 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. Este produto não é feito, endossado nem suportado por eles.
Aviso legal
- Este produto é uma ferramenta de software para notificações. Ele não opera e não é recomendação de investimento. As notificações podem atrasar, faltar ou chegar duplicadas por causa do terminal, da conexão com a internet ou dos serviços do LINE, Discord e Telegram; não dependa delas como sua única forma de acompanhar sua conta. As tarifas e condições dos planos do LINE são de sua responsabilidade. Teste-o primeiro com uma conta demo.
