Ir al contenido
Signal Pilot

Webhooks (TradingView → bot)

Los webhooks permiten enviar las alertas de TradingView a servicios externos, bots o API propias para automatizar tareas. Esta guía explica cómo se configuran y se usan con los indicadores de Signal Pilot.

Con fines educativos

Esta guía describe la integración de webhooks con fines formativos y de automatización. El trading automatizado conlleva riesgos importantes. Esto no es asesoramiento financiero.

📡 ¿Qué es un webhook?

Un webhook es una petición HTTP POST que TradingView envía por su cuenta a la dirección que tú indiques, en cuanto salta una alerta. Los usos más habituales son:

  • Avisos: enviar alertas a Discord, Telegram o Slack
  • Registro: guardar las alertas en una base de datos o en una hoja de cálculo
  • Automatización: disparar acciones a través de API propias
  • Pruebas: vigilar con qué frecuencia y en qué condiciones saltan las alertas

✅ Lo que necesitas antes

Antes de configurar un webhook suelen hacer falta estas cosas:

  • TradingView Pro, Pro+ o Premium: las cuentas gratuitas no tienen acceso a los webhooks
  • La dirección del destinatario: un servicio que acepte peticiones HTTP POST, por ejemplo un webhook de Discord, un servidor propio o una plataforma de automatización
  • Un indicador de Signal Pilot: configurado y puesto en tu gráfico
  • Nociones básicas de JSON: útil si quieres dar forma tú mismo al mensaje; imprescindible no es

🔧 Paso a paso

Paso 1: consigue la dirección del webhook

La dirección depende de adónde quieras que lleguen las alertas:

Webhook de Discord

  1. En Discord, entra en Ajustes del servidor → Integraciones → Webhooks
  2. Pulsa «New Webhook»
  3. Ponle nombre y elige el canal
  4. Copia la dirección del webhook (tiene esta forma: https://discord.com/api/webhooks/...)

📸 Captura pendiente

La pantalla de creación de webhooks de Discord

Añadiremos una captura de la pantalla de creación de webhooks de Discord, con el panel de integraciones y los pasos de configuración.

Bot de Telegram

  1. Busca «@BotFather» en Telegram
  2. Envía /newbot y sigue lo que te vaya pidiendo
  3. Copia el token del bot
  4. Usa un servicio puente o un servidor propio para reenviar a Telegram los webhooks de TradingView

Servidor o API propios

Puedes montar tu propio destinatario con plataformas como estas:

  • Webhook.site: para hacer pruebas; recibe el contenido del webhook y te lo muestra
  • Make.com (antes Integromat): para enlazar varios servicios entre sí
  • Zapier: para automatizar flujos de trabajo
  • Un servidor propio: Python con Flask, Node.js con Express y demás

Paso 2: configura la alerta en TradingView

  1. En el gráfico donde tengas el indicador de Signal Pilot, pulsa el icono Alerta (el reloj con el signo +)
  2. En el cuadro de la alerta:
    • Condición: elige tu indicador de Signal Pilot y la condición que quieras vigilar
    • Opciones: marca «Once Per Bar Close» para que no haya repintados dentro de la vela
    • Vencimiento: ponla según lo que necesites; lo habitual es «Open-ended»
  3. Baja hasta la pestaña «Notifications».
  4. Marca la casilla «Webhook URL».
  5. Pega ahí la dirección de tu destinatario

📸 Captura pendiente

El cuadro de alertas de TradingView y el campo Webhook URL

Añadiremos una captura del cuadro de alertas de TradingView donde se ve el campo Webhook URL, dentro del apartado «Notifications».

Paso 3: da forma al mensaje (opcional)

En el campo «Message» decides qué datos se envían. TradingView admite estos comodines:

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

Comodines habituales de TradingView:

  • {{ticker}}: el nombre del símbolo, por ejemplo «BTCUSDT»
  • {{close}}: el precio de cierre del momento
  • {{time}}: la hora a la que saltó la alerta
  • {{interval}}: la temporalidad, por ejemplo «15» o «1D»
  • {{exchange}}: el nombre del mercado

Paso 4: prueba el webhook

  1. Cuando la alerta esté creada, pulsa el botón «Test» de los ajustes de la alerta.
  2. Mira en el destino: el canal de Discord, webhook.site o lo que hayas puesto
  3. Comprueba que el mensaje llega con el formato correcto
  4. Si no llega nada, repasa esto:
    • Que la dirección del webhook sea la correcta
    • Que tu cuenta de TradingView tenga acceso a los webhooks, es decir Pro+ o Premium
    • Que se pueda llegar al destinatario y que ningún cortafuegos lo bloquee

📸 Captura pendiente

Un mensaje de prueba recibido en Discord

Añadiremos una captura del chat de Discord con un mensaje de prueba del webhook ya recibido, con los datos de la alerta de Signal Pilot bien formateados.

💬 Ejemplos de formato

Mensaje con formato de 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}
    ]
  }]
}

Mensaje de texto simple

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

JSON estructurado para una API propia

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

🌐 Plataformas habituales

Plataforma Caso de uso Dificultad de configuración
Discord Avisar al equipo y dejar registro Muy fácil
Telegram Avisos en el móvil Media; hace falta un bot y un puente
Make.com Enlazar varios servicios Fácil, con flujo visual
Zapier Conectar con más de 5000 aplicaciones Fácil, con flujo visual
Webhook.site Probar y depurar Muy fácil
Servidor propio Control total y lógica a medida Avanzada; hay que programar

🔍 Si algo no funciona

🔍 ¿El webhook no envía nada? Repasa esto:
  1. ¿Has puesto la dirección en la alerta? → Si no, añádela
  2. ¿Llega a saltar la alerta? → Si no, arregla primero la alerta
  3. ¿La has probado en webhook.site? → Si no, pruébala ahí antes que nada. Si falla, genera una dirección nueva
  4. ¿El formato es el correcto? → Revisa el formato propio de Discord o de Telegram
  5. ¿El JSON es válido? → Pásalo por un validador de JSON para revisar la sintaxis
  6. ¿Tienes TradingView Pro+? → Las cuentas gratuitas no pueden usar webhooks

Prueba rápida: Prueba siempre antes en webhook.site. Si ahí llega y en Discord o Telegram no, el problema está en cómo tienes montado el destino.

El webhook no llega

  • Comprueba tu plan de TradingView: las cuentas gratuitas no pueden usar webhooks
  • Revisa la dirección: que no lleve espacios de más y que el protocolo sea https://
  • Prueba el destinatario: usa webhook.site para confirmar que TradingView llega a tu dirección
  • ¿Saltó la alerta?: mira el registro de alertas de TradingView para confirmar que saltó de verdad

El mensaje trae datos equivocados

  • Sintaxis del comodín: tienes que escribir {{ticker}} no {ticker}
  • Formato del JSON: si usas el formato estructurado, valídalo en jsonlint.com
  • Comillas escapadas: usa \" si necesitas comillas dentro de una cadena JSON

Llegan demasiados webhooks

  • Frecuencia de la alerta: cambia «Once Per Bar» por «Once Per Bar Close»
  • Precisión de la condición: afina la condición para que salte menos veces
  • Tiempo de espera: algunos servicios de webhooks limitan cuántas peticiones aceptan por minuto

🔒 Seguridad

Cosas importantes sobre seguridad

  • La dirección de un webhook es información delicada: trátala como una contraseña y no la publiques en ningún sitio
  • Cámbiala cada cierto tiempo: sobre todo si de ella dependen procesos críticos
  • Valida lo que te llega: si usas un servidor propio, comprueba que las peticiones vienen de TradingView
  • Usa HTTPS siempre que puedas: un destinatario que solo acepte HTTP sin cifrar es un riesgo

📋 Un montaje de ejemplo

Escenario: Recibir en un canal de Discord los avisos de vuelta de Pentarch

  1. Creado: un webhook de Discord en el canal #trading-alerts
  2. Configurado: Pentarch v1.0 en el gráfico de BTCUSDT a 15 minutos
  3. Alerta puesta: sobre la condición «Pentarch: Reversal Detected»
  4. Frecuencia: «Once Per Bar Close»
  5. Pegada: la dirección del webhook de Discord en los ajustes de la alerta
  6. Mensaje a medida: con el formato de incrustación de Discord que se ve arriba
  7. Probada: la alerta; el mensaje apareció en Discord
  8. Alerta activa: el equipo recibe un aviso cada vez que se detecta un patrón de vuelta

(Ejemplo de montaje real, solo con fines formativos. No es asesoramiento financiero. Los resultados pueden variar de una persona a otra.)