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
- En Discord, entra en Ajustes del servidor → Integraciones → Webhooks
- Pulsa «New Webhook»
- Ponle nombre y elige el canal
- 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
- Busca «@BotFather» en Telegram
- Envía
/newboty sigue lo que te vaya pidiendo - Copia el token del bot
- 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¶
- En el gráfico donde tengas el indicador de Signal Pilot, pulsa el icono Alerta (el reloj con el signo +)
- 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»
- Baja hasta la pestaña «Notifications».
- Marca la casilla «Webhook URL».
- 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¶
- Cuando la alerta esté creada, pulsa el botón «Test» de los ajustes de la alerta.
- Mira en el destino: el canal de Discord, webhook.site o lo que hayas puesto
- Comprueba que el mensaje llega con el formato correcto
- 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}} timeframeJSON 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¶
- ¿Has puesto la dirección en la alerta? → Si no, añádela
- ¿Llega a saltar la alerta? → Si no, arregla primero la alerta
- ¿La has probado en webhook.site? → Si no, pruébala ahí antes que nada. Si falla, genera una dirección nueva
- ¿El formato es el correcto? → Revisa el formato propio de Discord o de Telegram
- ¿El JSON es válido? → Pásalo por un validador de JSON para revisar la sintaxis
- ¿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
- Creado: un webhook de Discord en el canal #trading-alerts
- Configurado: Pentarch v1.0 en el gráfico de BTCUSDT a 15 minutos
- Alerta puesta: sobre la condición «Pentarch: Reversal Detected»
- Frecuencia: «Once Per Bar Close»
- Pegada: la dirección del webhook de Discord en los ajustes de la alerta
- Mensaje a medida: con el formato de incrustación de Discord que se ve arriba
- Probada: la alerta; el mensaje apareció en Discord
- 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.)