TheConnector Relay: instalar e utilizar a extensão do navegador

Para que serve a extensão

O campo webhook do TradingView, aquele que faz o próprio TradingView enviar um alerta para um URL, exige um plano pago do TradingView. O TheConnector Relay assume essa tarefa a partir do seu navegador: quando um alerta dispara e o TradingView mostra a sua janela pop-up no separador do gráfico, a extensão envia a mensagem para o seu webhook TheConnector.

É um modo de teste e descoberta, não um substituto do webhook nativo. Nada é reencaminhado com o navegador fechado, com o separador do TradingView fechado ou com o computador em suspensão, e um alerta perdido nunca é enviado mais tarde: uma ordem enviada com atraso seria executada a um preço que já não existe.

Antes de começar

• O URL do webhook e a chave de acesso da sua conta: As minhas contas > abra a conta de trading > copie-os.
• O robô MT4, MT5 ou cTrader instalado e ligado a essa conta.
• Um alerta do TradingView cuja mensagem use o formato TheConnector (consulte /docs/command-syntax-reference).

1. Instalar a extensão

Chrome ou Edge

• Abra a ficha TheConnector Relay na Chrome Web Store (https://chromewebstore.google.com/detail/theconnector-relay/hhjfaglcmckplbgmojbkpbkcmjphhebc) e clique em Adicionar ao Chrome. No Edge, a mesma ficha instala-se depois de permitir extensões de outras lojas.
• A extensão continua instalada quando o navegador reinicia e atualiza-se sozinha: deixa de haver pasta para guardar ou ZIP para substituir.
• ⚠ Se já tinha carregado a extensão em modo de programador, remova primeiro essa cópia em chrome://extensions (Edge: edge://extensions): as duas cópias são duas extensões diferentes e cada uma retransmitiria o mesmo alerta, ou seja, duas vezes, gastando o dobro da quota.
• Depois de instalar, abra a janela da extensão e volte a introduzir o URL do webhook e a chave de acesso: as definições da cópia anterior não acompanham.
• O ZIP do cartão Chrome / Edge continua disponível se a sua empresa bloquear a Chrome Web Store: descompacte-o numa pasta que fique sempre no mesmo sítio e depois chrome://extensions > modo de programador > Carregar expandida. Por esta via, as atualizações continuam manuais.
• Afixe o logótipo da TheConnector na barra de ferramentas (botão em forma de peça de puzzle) para o ter à mão.

Firefox

• Se o cartão Firefox mostrar Instalar: clique e aceite as confirmações do Firefox. A extensão fica instalada de forma permanente.
• Se mostrar «Extensão temporária»: abra about:debugging#/runtime/this-firefox, clique em Carregar extra temporário… e escolha o ZIP. Este modo serve para experimentar: o extra desaparece sempre que o Firefox fecha e, por isso, nunca consegue voltar a arrancar sozinho.

2. Ligar a extensão à sua conta

• Clique no logótipo da TheConnector na barra de ferramentas e depois em Ouvrir les options (abrir as opções).
• Leia a caixa Avant de commencer (antes de começar), marque a caixa de verificação e clique em Continuer (continuar). Nada é enviado antes deste consentimento.
• Cole o URL do webhook, e a chave de acesso se o URL não a contiver, e clique em Enregistrer (guardar).
• Tester la connexion (testar a ligação) verifica a chave sem abrir nenhuma ordem. Mesmo assim, conta como um alerta da sua quota diária e aparece como alerta recusado no seu histórico: um teste basta.

Os ecrãs da extensão estão em francês.

3. Preparar o alerta do TradingView

• Escreva a mensagem no formato TheConnector. A extensão ignora uma mensagem sem essa forma, como o texto que o TradingView sugere por predefinição.
• Nas notificações do alerta, mantenha a janela pop-up ativada («Show pop-up» no TradingView em inglês). A extensão reencaminha apenas a janela pop-up mostrada quando o alerta dispara, nunca o registo de alertas, onde se misturam alertas antigos.
• Não marque «Webhook URL»: se o seu plano do TradingView o permitir, o alerta sairia duas vezes, uma pelo TradingView e outra pela extensão.

4. Verificar que tudo está pronto

Abra o gráfico do TradingView, ou recarregue-o (F5) se já estava aberto. Aparece um indicador no topo do gráfico:

Um clique reduz o indicador. A janela da extensão, aberta com um clique no seu logótipo, indica se há um separador do TradingView ligado e lista os últimos alertas vistos: enviado, não entregue com o motivo devolvido pelo servidor, ou ignorado com a razão e o que corrigir.

Depois dispare um alerta e abra Histórico de alertas na sua área de cliente: deve lá estar.

Vários separadores, vários navegadores

• Vários separadores do TradingView no mesmo navegador: um alerta só é enviado uma vez.
• Instale a extensão num único navegador, num único computador. Cada instalação reencaminha por conta própria: o mesmo alerta abriria duas ordens.

Impedir que o separador do TradingView seja fechado

• Afixe o separador: clique direito no separador > Afixar. Um separador afixado não tem botão de fechar.
• Dê-lhe uma janela própria e navegue noutra: ninguém fecha por engano uma janela que não está a usar.
• Peça confirmação antes de fechar. Firefox: about:preferences > Geral > «Confirm before closing multiple tabs». Edge: edge://settings/appearance/browserBehavior > «Ask before closing a window with multiple tabs». O Chrome não tem esta opção: o separador afixado e a reabertura automática descrita abaixo substituem-na.
• Impeça a suspensão: prima Windows + R, escreva ms-settings:powersleep e defina a suspensão para Nunca. Um computador suspenso não reencaminha nada.
• Separador fechado por engano: Ctrl + Shift + T reabre-o de imediato. Os alertas disparados enquanto esteve fechado não são recuperados.

Arrancar tudo sozinho quando o computador reinicia (Windows)

1. O navegador reabre o separador do TradingView

• Chrome: chrome://settings/onStartup > «Continue where you left off».
• Edge: edge://settings/startHomeNTP > «Open tabs from the previous session».
• Firefox: about:preferences > Geral > «Open previous windows and tabs».

Mantenha a sessão do TradingView iniciada e não use a navegação privada, que apaga a sessão ao fechar.

2. O navegador arranca com o Windows

• Prima Windows + R, escreva shell:startup e confirme: abre-se a pasta de arranque.
• Clique direito > Novo > Atalho e indique o programa do seu navegador:

Chrome  : "C:\Program Files\Google\Chrome\Application\chrome.exe"
Edge    : "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
Firefox : "C:\Program Files\Mozilla Firefox\firefox.exe"

• Se não ativou a reabertura dos separadores, acrescente o endereço do gráfico a seguir ao caminho, separado por um espaço: https://www.tradingview.com/chart/.

3. O robô também arranca

Acrescente da mesma forma à pasta de arranque um atalho para o seu terminal MetaTrader (ou para o cTrader). Sem robô ligado, os alertas reencaminhados não têm quem abra a ordem.

4. O que verificar

• Nada arranca antes de a sua sessão do Windows ser aberta: após um reinício forçado por uma atualização, inicie sessão de novo. Para afastar esses reinícios das suas horas de trading, defina as horas de atividade: Windows + R, ms-settings:windowsupdate-activehours.
• Após cada reinício, traga o separador do TradingView para a frente e verifique o indicador en écoute des alertes.
• A extensão temporária do Firefox nunca volta a arrancar sozinha: precisa da versão que se instala com Instalar.
• No Mac: adicione o navegador e o terminal aos itens de início de sessão (Definições do Sistema > Geral) e impeça a suspensão automática.

Atualizar a extensão

• Chrome ou Edge: nada a fazer se a extensão vier da Chrome Web Store, as novas versões instalam-se sozinhas. Instalação manual por ZIP: transfira o novo ZIP, substitua o conteúdo da pasta e clique no ícone de recarregar da extensão em chrome://extensions (Edge: edge://extensions).
• Firefox: instale a nova versão a partir do cartão Firefox.
• Depois recarregue o separador do TradingView (F5).

Utilização responsável

A extensão lê uma mensagem que o TradingView já mostra numa página que abriu: não contorna nenhuma proteção nem modifica o TradingView. A utilização de ferramentas automatizadas no TradingView continua sujeita às condições de utilização do TradingView e é da sua responsabilidade.