TheConnector Relay: teste o produto sem um plano pago do TradingView

Para que serve

O campo de webhook nativo do TradingView — aquele que permite ao próprio TradingView fazer POST de um alerta para uma URL — exige um plano pago Essential ou superior. O TheConnector Relay é uma extensão de navegador que lê o pop-up que o TradingView exibe no seu separador de gráfico aberto quando um alerta dispara, e reencaminha a mensagem para o seu webhook TheConnector. Existe para que possa testar o TheConnector de ponta a ponta, com histórico real no painel, antes de se comprometer com um plano pago do TradingView.

Não substitui o webhook nativo do TradingView. Encare-a como um modo de teste/descoberta: útil para validar o seu payload, o encaminhamento da sua conta e a sua ligação MT4/MT5/cTrader, com o separador do navegador aberto à sua frente.

Como funciona

• Crie o seu alerta TradingView com a mesma mensagem que usaria para um webhook nativo — /docs/command-syntax-reference e /first-alert aplicam-se aqui sem alterações. Deixe vazio o campo "Webhook URL" do TradingView; não é utilizado.
• Nas notificações do alerta, mantenha o pop-up ativado ("Show pop-up" no TradingView em inglês). A extensão só reencaminha o pop-up exibido quando o alerta dispara, nunca o registo de alertas, que também lista alertas disparados há horas ou dias.
• Os alertas já visíveis quando a página carrega são memorizados sem serem enviados: abrir ou recarregar o separador nunca repete um sinal antigo.
• Enquanto o separador do gráfico está visível, envia um ping ao processo em segundo plano da extensão a cada 20 segundos. Esse processo mantém-se assim ativo e a ligação ao TheConnector aberta: enviar um alerta custa uma única viagem de ida e volta.
• A sua chave de acesso viaja com o pedido, tal como um webhook nativo do TradingView, para o mesmo endpoint que a sua conta já utiliza.

{
  "action": "buy",
  "symbol": "{{ticker}}",
  "volume": 0.10,
  "sl": 1.0820,
  "tp": 1.0910
}

Não precisa de adicionar um campo accessKey você mesmo; a extensão adiciona-o antes de enviar. Se ainda assim incluir um, é respeitado.

Verificar que está à escuta

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

• en écoute des alertes — a extensão está carregada neste separador e aguarda os alertas
• à configurer — falta o consentimento ou as definições
• rechargez cette page (F5) — a extensão foi atualizada ou recarregada depois de o separador ser aberto
• dernière alerte envoyée ✓ — o último alerta saiu para a sua conta
• non livrée ✗ ou ignorée — o motivo exato está na janela da extensão

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 — consentimento em falta, mensagem no formato errado, alerta visto apenas no registo.

Fiabilidade assumida

Um envio falhado é repetido até 3 vezes em menos de 5 segundos (imediatamente, depois +400 ms, depois +1,5 s), sendo depois abandonado e reportado. Não há nova tentativa mais tarde. É deliberado: o TheConnector mede a atualidade de uma ordem a partir do momento em que a recebe, pelo que um alerta repetido minutos depois pareceria novo e seria executado sobre um sinal que já não é válido, a um preço que já não lhe corresponde. Uma chave recusada ou uma mensagem rejeitada é reportada de imediato: reenviá-la daria a mesma resposta.

• Cada alerta detetado é escrito no armazenamento local antes de qualquer tentativa de rede: uma ligação perdida ou um reinício do processo em segundo plano nunca perde um alerta já capturado.
• Um alerta duplicado (mesma mensagem, mesma hora exibida pelo TradingView) é filtrado duas vezes: uma vez na página, outra na fila persistente, que continua a bloqueá-lo após um recarregamento ou um reinício do navegador. Com vários separadores do TradingView abertos, um alerta só é enviado uma vez.
• Uma falha nunca é silenciosa: o ícone da extensão fica vermelho e a sua janela indica o motivo.

O que não faz

Leia isto antes de confiar nela para algo além de testes:

• Precisa do seu navegador aberto no gráfico do TradingView durante todo o tempo em que quiser reencaminhar alertas. Fechar o separador ou o navegador para tudo.
• Um alerta com o pop-up desativado não é enviado: só aparece no registo, e a janela da extensão assinala-o.
• Um alerta não entregue em 5 segundos é descartado e reportado, nunca repetido mais tarde.
• Não consegue reencaminhar nada enquanto o computador está em suspensão: defina a suspensão para "Nunca" durante o seu teste.
• É menos fiável do que o webhook de servidor nativo do TheConnector, que não depende de nenhum navegador estar aberto. Por isso permanece limitada a testes e descoberta, não à negociação ao vivo.

Segurança e permissões

A extensão guarda apenas duas definições: o endereço do seu webhook e a chave de acesso da sua conta — as mesmas que já usa para o seu conector MT4/MT5/cTrader ou um webhook nativo do TradingView. Nunca lê nem armazena um login do TradingView, um login de broker ou qualquer outra credencial. Na página do TradingView só lê o texto e a hora dos alertas, nunca as suas posições ou detalhes da conta.

As permissões correspondem exatamente ao que faz: storage e alarms para a sua fila e agendamento, mais acesso a hosts limitado a tradingview.com e ao seu host de webhook TheConnector. Sem tabs, sem notifications, sem acesso amplo a hosts. Todo o código vem incluído no pacote da extensão — sem script remoto, sem eval.

A página de opções exige um consentimento explícito e com hora registada antes de qualquer envio, e a janela da extensão lembra permanentemente que se trata de uma ferramenta de teste/descoberta. Esse aviso não pode ser fechado.

Compatibilidade de navegadores

• Chrome — validado com alertas realmente disparados; instalação num clique a partir da Chrome Web Store, atualizações incluídas
• Edge — mesmo pacote Chromium, instalado a partir dessa mesma ficha da Chrome Web Store
• Firefox — validado com alertas realmente disparados, com o seu próprio pacote assinado pela Mozilla: um clique para instalar e as atualizações chegam sozinhas

Obtenha-a a partir da sua área de cliente

O TheConnector Relay está disponível na página de transferências da sua área de cliente (Transferir o robô no menu), em todos os planos, incluindo o plano Basic gratuito. No Chrome e no Edge, um clique em Instalar abre a ficha da Chrome Web Store e depois a Google mantém a extensão atualizada sozinha; no Firefox, o pacote assinado pela Mozilla também se instala com um clique. Se já tinha carregado uma cópia em modo de programador, remova-a antes: as duas cópias são duas extensões diferentes e cada uma retransmitiria o mesmo alerta, ou seja, duas vezes. Em seguida, abra as opções da extensão, aceite o aviso de modo de teste, cole o endereço do seu webhook e a sua chave de acesso, dispare um alerta e veja-o chegar ao seu Histórico de alertas.

O guia completo — instalação em cada navegador, ligação à sua conta, preparação do alerta, proteção do separador do TradingView contra o fecho e reabertura de tudo após um reinício — está em /docs/browser-extension.

Um detalhe antes de clicar: Tester la connexion (testar a ligação) verifica a sua chave sem colocar nenhuma ordem, mas conta como um alerta da sua quota diária e aparece como alerta rejeitado no seu histórico. Um único teste basta.

Uso responsável

O TheConnector Relay lê uma mensagem que o TradingView já exibe numa página que você abriu; não contorna nenhuma proteção do TradingView nem altera o seu funcionamento. A utilização de ferramentas automatizadas no TradingView continua a reger-se pelos próprios termos de utilização do TradingView, sendo da responsabilidade do utilizador.