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 alerta que o TradingView já exibe, depois de disparado, no seu separador de gráfico aberto, e reencaminha-o 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 JSON 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.
• Quando o alerta dispara, a extensão lê o texto da mensagem exibido no registo de alertas. Um MutationObserver reage em cerca de 1 ms.
• O seu service worker em segundo plano é mantido ativo por um ping periódico enviado a partir do separador, pelo que já está ativo quando o alerta dispara — caso contrário, o Chrome descarrega um service worker inativo ao fim de cerca de 30 segundos.
• O pedido sai por uma ligação já aquecida, pelo que do disparo ao envio há apenas 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.

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 despacho em tempo real do TheConnector rejeita uma ordem que ficou obsoleta, pelo que reproduzir um alerta antigo minutos depois seria, na melhor das hipóteses inútil e, na pior, perigoso — abrir uma posição a um preço que já não existe.

• Cada alerta detetado é escrito no armazenamento local antes de qualquer tentativa de rede: uma ligação perdida ou um reinício do service worker nunca perde um alerta já capturado.
• Um alerta duplicado (mesma mensagem, mesma hora TradingView) é filtrado duas vezes: uma vez por página, outra na fila persistente.
• O popup mostra o total acumulado reencaminhado, a latência do último envio, e uma contagem e lista visíveis de alertas abandonados (hora, motivo, excerto da mensagem). Uma falha nunca é silenciosa.

O que não faz

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

• Precisa do seu navegador aberto no separador do gráfico TradingView durante todo o tempo em que quiser capturar alertas. Fechar o separador ou o navegador para tudo.
• Um alerta não entregue em 5 segundos é descartado e reportado, nunca reproduzido mais tarde.
• O computador entrar em suspensão pausa completamente a deteção — o próprio TradingView deixa de executar o Pine Script durante esse tempo.
• É 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 a negociação ao vivo.

Segurança e permissões

A extensão armazena exatamente dois valores: a URL 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. Só lê o texto da mensagem do alerta e a sua hora exibida, 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 o popup lembra permanentemente que se trata de uma ferramenta de teste/descoberta. Esse aviso não pode ser fechado.

Compatibilidade de navegadores

• Chrome — validado: extração da mensagem e hora confirmadas num alerta realmente disparado
• Edge — funciona tal como está, mesmo pacote Chromium, mesmo manifest
• Firefox — é fornecida uma variante separada, ainda não testada numa instalação ligada

Obtenha a partir do seu painel

O TheConnector Relay está disponível na página Downloads do seu painel de cliente, em todos os planos, incluindo o plano Basic gratuito. Por agora instala-se em modo de programador — Chrome ou Edge: abra a página de extensões, ative o modo de programador, carregue a pasta descompactada. A publicação na Chrome Web Store e no Firefox Add-ons é um passo posterior. Depois de instalada, cole o URL do seu webhook e a sua chave de acesso na página de opções, aceite o aviso de modo de teste e depois dispare um alerta e verifique a sua página Transações para o ver chegar.

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.