TradingView Webhook to Phone Call Tutorial (Complete Technical Guide)
TradingView Webhook to Phone Call Tutorial
Webhooks are TradingView's most powerful notification method - they're fast, reliable, and enable unlimited automation possibilities. But setting them up can be confusing, especially if you're not a developer.
In this comprehensive technical guide, you'll learn exactly how to configure TradingView webhooks to trigger instant phone calls, including code examples, JSON formatting, and troubleshooting tips.
What Are Webhooks?
A webhook is an HTTP POST request that TradingView sends to a URL you specify when an alert triggers. Think of it as TradingView calling your phone line the moment your conditions are met.
**Key characteristics:**
Webhooks are the fastest notification method TradingView offers and the only way to achieve true sub-2 second phone call alerts.
Prerequisites
Before you start, ensure you have:
**Important**: If you're on TradingView's free plan, you must upgrade to Pro first. There's no workaround for this requirement.
Part 1: Understanding Webhook Basics
### How Webhooks Work
When your TradingView alert triggers, here's what happens:
1. **Alert condition is met** (e.g., BTC crosses $45,000)
2. **TradingView sends HTTP POST request** to your webhook URL
3. **Webhook service receives the request** (TradeAlert.Pro)
4. **Service processes the data** and initiates phone call
5. **Your phone rings** in under 2 seconds
The entire process is automated and happens faster than you can blink.
### Webhook URL Format
A webhook URL looks like this:
```
https://tradealert.pro/hook/yourUsername/abc123def456
```
Breaking it down:
**Security note**: Never share your webhook URL publicly. It contains your API key and can be used to trigger alerts on your account.
### TradingView Webhook Limitations
TradingView imposes these technical limits:
If you exceed the rate limit, TradingView will drop subsequent webhook requests until the limit resets.
Part 2: Setting Up Your First Webhook
### Step 1: Get Your Webhook URL from TradeAlert.Pro
1. Sign up at [TradeAlert.Pro](/dashboard) (free tier available)
2. Verify your phone number with the 6-digit code
3. Navigate to your dashboard
4. Find the "Webhook URL" section
5. Click "Copy" to copy your unique URL
Your URL will be automatically formatted correctly and ready to use.
### Step 2: Enable 2FA on TradingView
TradingView requires 2FA for webhook security:
1. Log into TradingView.com
2. Click your profile → Settings
3. Go to Security settings
4. Click "Enable Two-Factor Authentication"
5. Scan QR code with Google Authenticator or Authy
6. Enter the 6-digit verification code
7. Save your backup codes
**Pro tip**: Use Authy instead of Google Authenticator - it backs up to the cloud and won't be lost if you lose your phone.
### Step 3: Create Your First Webhook Alert
Now for the actual webhook configuration:
1. **Open TradingView** and load the chart you want to monitor
2. **Click the Alert button** (clock icon) in the top toolbar
3. **Set your alert condition**:
- Condition: "Crossing"
- Value: Your target price
- Options: "Once Per Bar Close" (recommended)
4. **Configure the webhook**:
- Scroll down to the Notifications section
- Check the box labeled "Webhook URL"
- Paste your TradeAlert.Pro webhook URL
5. **Set the alert message** (this will be spoken in the phone call):
```
{{ticker}} crossed {{price}}. Check chart immediately.
```
6. **Click Create**
That's it! Your webhook is now live.
### Step 4: Test Your Webhook
Always test before relying on a webhook:
1. Create a test alert that will trigger immediately:
- Set condition to current price
- Enable webhook with your URL
- Use message: "Test alert - please disregard"
2. Click Create
3. Your phone should ring within 2 seconds
4. Verify the voice message is clear and contains correct info
5. Check TradeAlert.Pro dashboard for call log
6. Delete the test alert
If the call doesn't come through, see the Troubleshooting section below.
Part 3: Advanced Webhook Configuration
### Using TradingView Placeholders
TradingView provides dynamic placeholders that are automatically filled when the alert triggers:
**Price & Market Data:**
**Time Data:**
**Interval & Chart:**
**Example message using placeholders:**
```
{{ticker}} on {{exchange}}: Price {{close}}, Volume {{volume}}
```
When alert triggers at BTC price $45,123:
```
BTCUSD on BINANCE: Price 45123, Volume 1234567
```
### Custom JSON Payloads
For advanced users, you can send structured JSON data:
```json
{
"symbol": "{{ticker}}",
"price": {{close}},
"action": "BUY",
"strategy": "Breakout",
"timestamp": "{{time}}"
}
```
**Important**: If your message is valid JSON, TradingView automatically sets the content-type header to `application/json`. Otherwise, it uses `text/plain`.
For phone calls with TradeAlert.Pro, simple text messages work best since they're converted to speech. JSON is more useful for bot integrations.
### Creating Multiple Webhooks
You can create separate webhooks for different alert types:
**High Priority (Phone Calls):**
**Medium Priority (SMS backup):**
**Low Priority (Dashboard only):**
Simply use different webhook URLs for each priority level, or use a single URL and differentiate with message tags like `[URGENT]` or `[INFO]`.
Part 4: Best Practices
### Message Optimization for Voice
Since your webhook message will be spoken aloud, follow these guidelines:
**DO:**
**DON'T:**
**Good example:**
```
Ethereum reached 3,000 dollars. Buy signal confirmed on 4 hour chart.
```
**Bad example:**
```
{{ticker}}@{{exchange}}|P:{{close}}|V:{{volume}}|ACT:BUY|STRAT:BB_SQUEEZE
```
### Alert Condition Best Practices
**Use "Once Per Bar Close"** instead of "Only Once":
**Combine multiple conditions** to reduce noise:
**Set appropriate cooldown periods:**
### Managing Rate Limits
TradingView limits you to 60 webhooks per minute and 500 per hour. To stay within limits:
1. **Use "Once Per Bar Close"** not "Any alert() function call"
2. **Don't create alerts on 1-second charts** - stick to 1-minute minimum
3. **Consolidate similar alerts** - use one alert with multiple conditions instead of many separate alerts
4. **Monitor your usage** in TradingView's alert manager
If you hit rate limits, your webhooks will be dropped silently. There's no error message.
Part 5: Troubleshooting
### Webhook Not Firing
**Check these first:**
1. Verify you have TradingView Pro or higher
2. Confirm 2FA is enabled on your account
3. Check webhook URL has no extra spaces or characters
4. Ensure alert condition is set correctly
5. Verify alert is Active (not expired or paused)
**Test your webhook URL:**
You can test if your webhook URL is valid by creating a test alert that triggers immediately (set to current price).
### Phone Call Not Received
**If webhook fires but no phone call:**
1. Check TradeAlert.Pro dashboard for webhook logs
2. Verify your phone number is verified
3. Check you haven't exceeded your monthly call limit
4. Ensure your phone isn't blocking unknown numbers
5. Check TradeAlert.Pro status page for outages
### Webhook Timing Out
TradingView cancels webhooks that take longer than 3 seconds to respond.
**Solutions:**
### Message Not Clear in Phone Call
**If the voice message is garbled or unclear:**
Part 6: Advanced Use Cases
### Strategy Alert Webhooks
You can trigger webhooks from Pine Script strategies:
```pinescript
//@version=5
strategy("Webhook Strategy", overlay=true)
// Your strategy logic here
longCondition = ta.crossover(ta.sma(close, 14), ta.sma(close, 28))
if longCondition
strategy.entry("Long", strategy.long)
alert("Long entry at " + str.tostring(close), alert.freq_once_per_bar_close)
```
Then create an alert on your strategy and enable webhooks.
### Multi-Exchange Monitoring
Monitor the same asset across multiple exchanges:
1. Create alerts on different exchange feeds (BINANCE:BTCUSD, COINBASE:BTCUSD, etc.)
2. Use same webhook URL for all
3. Include `{{exchange}}` in message to identify source
4. Get phone call from whichever exchange triggers first
### Conditional Webhooks
Use PineScript to create complex conditions:
```pinescript
// Only alert if volume is above average AND price breaks resistance
highVolumeBreakout = volume > ta.sma(volume, 20) * 2 and close > resistance
if highVolumeBreakout
alert("High volume breakout confirmed", alert.freq_once_per_bar_close)
```
Part 7: Security Considerations
### Protecting Your Webhook URL
Your webhook URL contains your API key and should be treated as a password:
**DO:**
**DON'T:**
### Regenerating Your API Key
If your webhook URL is compromised:
1. Log into TradeAlert.Pro dashboard
2. Go to Settings → API Key
3. Click "Regenerate API Key"
4. Update all your TradingView alerts with the new URL
This immediately invalidates the old webhook URL.
Frequently Asked Questions
**Q: Can I use webhooks without TradingView Pro?**
A: No. Webhooks are only available on paid TradingView plans (Pro, Pro+, Premium). This is a TradingView limitation, not a TradeAlert.Pro limitation.
**Q: How many webhook alerts can I create?**
A: TradingView Pro allows up to 400 simultaneous alerts. Each can have its own webhook. However, remember the rate limits (60/minute, 500/hour).
**Q: Can I send webhooks to multiple URLs?**
A: No, each TradingView alert can only send to one webhook URL. However, you can create duplicate alerts with different webhook URLs if needed.
**Q: What happens if TradeAlert.Pro is down?**
A: TradingView will attempt to send the webhook but it will fail after 3 seconds. We maintain 99.9% uptime, but you can check our status page or set up a backup webhook to a different service.
**Q: Can I see webhook delivery logs?**
A: Yes! Your TradeAlert.Pro dashboard shows all received webhooks, including timestamp, message content, and call status.
**Q: Will webhooks work on mobile?**
A: Yes, webhooks are sent from TradingView's servers (not your device). Even if your phone is off, the webhook will fire and call your phone.
Next Steps
Now that you understand webhooks, here's how to level up:
1. **Test thoroughly**: Create multiple test alerts with different conditions
2. **Optimize messages**: Experiment with different message formats to find what's clearest
3. **Monitor usage**: Check your alert manager to ensure you're not hitting rate limits
4. **Explore Pine Script**: Write custom strategies that trigger webhooks
5. **Set up backups**: Enable SMS backup in TradeAlert.Pro for redundancy
Ready to set up your first webhook-to-phone-call alert? [Start your free trial](/dashboard) and get 3 free test calls to verify everything works before you commit.
**Related Resources:**