Vai al contenuto
Signal Pilot

Webhook (TradingView → bot)

I webhook permettono di mandare gli avvisi di TradingView a servizi esterni, bot o API per automatizzare qualcosa. Questa guida spiega come impostarli e usarli con gli indicatori di Signal Pilot.

A scopo didattico

Questa guida descrive il collegamento dei webhook a scopo didattico e di automazione. Il trading automatico comporta rischi notevoli. Non è una consulenza finanziaria.

📡 Che cos'è un webhook?

Un webhook è una richiesta HTTP POST che TradingView manda da sé all'indirizzo che indichi tu, non appena scatta un avviso. Di solito serve per:

  • Avvisare: mandare gli avvisi su Discord, Telegram o Slack
  • Tenere traccia: salvare gli avvisi in un database o in un foglio di calcolo
  • Automatizzare: far partire azioni tramite API tue
  • Controllare: vedere ogni quanto e in quali condizioni scattano gli avvisi

✅ Cosa ti serve prima

Prima di impostare un webhook di solito servono queste cose:

  • TradingView Pro, Pro+ o Premium: i profili gratuiti non hanno accesso ai webhook
  • L'indirizzo del destinatario: un servizio che accetta richieste HTTP POST, per esempio un webhook di Discord, un server tuo o una piattaforma di automazione
  • Un indicatore di Signal Pilot: impostato e messo sul tuo grafico
  • Qualche nozione di JSON: utile se vuoi comporre tu il messaggio, ma non è indispensabile

🔧 Passo per passo

Passo 1: procurati l'indirizzo del webhook

L'indirizzo dipende da dove vuoi che arrivino gli avvisi:

Webhook di Discord

  1. In Discord vai su Impostazioni del server → Integrazioni → Webhook
  2. Fai clic su «New Webhook»
  3. Dagli un nome e scegli il canale
  4. Copia l'indirizzo del webhook (ha questa forma: https://discord.com/api/webhooks/...)

📸 Schermata in arrivo

La schermata di creazione dei webhook in Discord

Aggiungeremo una schermata della creazione dei webhook in Discord, con il pannello delle integrazioni e i passaggi dell'impostazione.

Bot di Telegram

  1. Cerca «@BotFather» su Telegram
  2. Manda /newbot e segui quello che ti chiede
  3. Prendi il token del bot
  4. Usa un servizio ponte o un server tuo per rigirare a Telegram i webhook di TradingView

Server o API tuoi

Puoi montarti il destinatario con piattaforme come queste:

  • Webhook.site: per le prove; riceve il contenuto del webhook e te lo mostra
  • Make.com (una volta Integromat): per collegare fra loro più servizi
  • Zapier: per automatizzare sequenze di operazioni
  • Un server tuo: Python con Flask, Node.js con Express e simili

Passo 2: imposta l'avviso su TradingView

  1. Sul grafico dove hai l'indicatore di Signal Pilot, fai clic sull'icona Avviso (la sveglia con il +)
  2. Nella finestra dell'avviso:
    • Condizione: scegli il tuo indicatore di Signal Pilot e la condizione da sorvegliare
    • Opzioni: spunta «Once Per Bar Close» per evitare ridisegni dentro la candela
    • Scadenza: impostala come ti serve; di solito si mette «Open-ended»
  3. Scendi fino alla scheda «Notifications».
  4. Spunta la casella «Webhook URL».
  5. Incolla lì l'indirizzo del tuo destinatario

📸 Schermata in arrivo

La finestra degli avvisi di TradingView e il campo Webhook URL

Aggiungeremo una schermata della finestra degli avvisi di TradingView, dove si vede il campo Webhook URL nella sezione «Notifications».

Passo 3: componi il messaggio (facoltativo)

Nel campo «Message» decidi quali dati partono. TradingView accetta questi segnaposto:

{
  "indicator": "{{ticker}}",
  "price": "{{close}}",
  "time": "{{time}}",
  "signal": "Pentarch Reversal Detected",
  "timeframe": "{{interval}}"
}

I segnaposto di TradingView più usati:

  • {{ticker}}: il nome dello strumento, per esempio «BTCUSDT»
  • {{close}}: il prezzo di chiusura del momento
  • {{time}}: l'ora in cui è scattato l'avviso
  • {{interval}}: il periodo, per esempio «15» o «1D»
  • {{exchange}}: il nome della borsa

Passo 4: prova il webhook

  1. Una volta creato l'avviso, premi il pulsante «Test» delle impostazioni dell'avviso.
  2. Guarda dove doveva arrivare: il canale di Discord, webhook.site o quello che hai messo
  3. Controlla che il messaggio arrivi con la formattazione giusta
  4. Se non arriva niente, ricontrolla:
    • Che l'indirizzo del webhook sia quello giusto
    • Che il tuo profilo TradingView abbia accesso ai webhook, quindi Pro+ o Premium
    • Che il destinatario sia raggiungibile e nessun firewall lo blocchi

📸 Schermata in arrivo

Un messaggio di prova arrivato su Discord

Aggiungeremo una schermata di una chat di Discord con un messaggio di prova arrivato dal webhook, con i dati dell'avviso di Signal Pilot formattati come si deve.

💬 Esempi di formato

Messaggio nel formato di Discord

{
  "content": "🔔 **Signal Pilot Alert**",
  "embeds": [{
    "title": "Pentarch Reversal",
    "description": "Reversal pattern detected on {{ticker}}",
    "color": 65280,
    "fields": [
      {"name": "Price", "value": "{{close}}", "inline": true},
      {"name": "Timeframe", "value": "{{interval}}", "inline": true},
      {"name": "Time", "value": "{{time}}", "inline": false}
    ]
  }]
}

Messaggio di solo testo

Signal Pilot: {{ticker}} - Harmonic Oscillator cross detected at {{close}} on {{interval}} timeframe

JSON strutturato per una API tua

{
  "alert_type": "signal_pilot",
  "indicator": "janus_atlas",
  "symbol": "{{ticker}}",
  "exchange": "{{exchange}}",
  "timeframe": "{{interval}}",
  "price": "{{close}}",
  "timestamp": "{{time}}",
  "condition": "Level Break Alert"
}

🌐 Le piattaforme più diffuse

Piattaforma Caso d'uso Quanto è difficile impostarla
Discord Avvisare la squadra e tenere traccia Molto facile
Telegram Avvisi sul telefono Media; servono un bot e un ponte
Make.com Collegare più servizi Facile, con schema visivo
Zapier Collegamento con oltre 5000 applicazioni Facile, con schema visivo
Webhook.site Prove e messa a punto Molto facile
Server tuo Controllo completo e logica su misura Alta; bisogna programmare

🔍 Quando qualcosa non va

🔍 Il webhook non manda niente? Ricontrolla questo:
  1. L'indirizzo è davvero nell'avviso? → Se no, mettilo
  2. L'avviso scatta? → Se no, sistema prima l'avviso
  3. L'hai provato su webhook.site? → Se no, provalo prima lì. Se fallisce, genera un indirizzo nuovo
  4. Il formato è quello giusto? → Ricontrolla il formato proprio di Discord o di Telegram
  5. Il JSON è valido? → Passalo in un validatore JSON per controllare la sintassi
  6. Hai TradingView Pro+? → I profili gratuiti non possono usare i webhook

Prova veloce: Fai sempre la prima prova su webhook.site. Se lì arriva e su Discord o Telegram no, il problema è come hai impostato il destinatario.

Il webhook non arriva

  • Controlla il tuo piano TradingView: i profili gratuiti non possono usare i webhook
  • Ricontrolla l'indirizzo: niente spazi di troppo e protocollo https://
  • Prova il destinatario: usa webhook.site per confermare che TradingView arriva al tuo indirizzo
  • L'avviso è scattato?: guarda il registro degli avvisi di TradingView per confermare che sia scattato davvero

Il messaggio porta dati sbagliati

  • Scrittura dei segnaposto: devi scrivere {{ticker}} non {ticker}
  • Formato del JSON: se usi il formato strutturato, validalo su jsonlint.com
  • Virgolette con la barra: usa \" se ti servono virgolette dentro una stringa JSON

Arrivano troppi webhook

  • Frequenza dell'avviso: passa da «Once Per Bar» a «Once Per Bar Close»
  • Precisione della condizione: stringi la condizione così scatta meno spesso
  • Tempo di attesa: certi servizi di webhook limitano quante richieste accettano

🔒 Sicurezza

Punti di sicurezza da tenere a mente

  • L'indirizzo di un webhook è un dato delicato: trattalo come una password e non pubblicarlo da nessuna parte
  • Cambialo ogni tanto: soprattutto se da lì dipendono cose importanti
  • Controlla quello che ti arriva: se usi un server tuo, verifica che le richieste vengano davvero da TradingView
  • Meglio HTTPS, sempre: un destinatario che accetta solo HTTP in chiaro è un rischio

📋 Un montaggio di esempio

Scenario: Ricevere in un canale di Discord gli avvisi di inversione di Pentarch

  1. Creato: un webhook di Discord nel canale #trading-alerts
  2. Impostato: Pentarch v1.0 sul grafico BTCUSDT a 15 minuti
  3. Avviso messo: sulla condizione «Pentarch: Reversal Detected»
  4. Frequenza: «Once Per Bar Close»
  5. Incollato: l'indirizzo del webhook di Discord nelle impostazioni dell'avviso
  6. Messaggio su misura: con il formato incorporato di Discord che vedi sopra
  7. Provato: l'avviso; il messaggio è comparso su Discord
  8. Avviso attivo: la squadra riceve un avviso ogni volta che si vede uno schema di inversione

(Esempio di montaggio reale, solo a scopo didattico. Non è una consulenza finanziaria. I risultati cambiano da persona a persona.)