---
title: "WEBHOOK_URL"
type: concept
tags: [n8n, environment-variable, webhook, telegram]
sources: [n8n-configure-telegram-trigger]
last_updated: 2026-04-22
---

## Definition
`WEBHOOK_URL` 是 n8n 工作流自动化平台的环境变量，用于指定 n8n 实例对外暴露的 HTTPS 基础地址。n8n 基于此地址自动生成各个 Trigger 节点的 Webhook URL。

## Why It Matters
Telegram Bot API 要求 Webhook 必须使用 HTTPS 协议。如果 `WEBHOOK_URL` 未设置或指向 HTTP/本地地址，Telegram 会拒绝注册 Webhook 并报错：
```
bad webhook: An HTTPS URL must be provided for webhook
```

## Configuration in Docker
在 Docker Compose 或 Docker Desktop 中设置：
```yaml
environment:
  - WEBHOOK_URL=https://n8n.cpolar.top
```

## Related Entities
- [[n8n]] — 读取 WEBHOOK_URL 环境变量的工作流平台
- [[Telegram]] — 要求 HTTPS Webhook 的消息平台

## Related Concepts
- [[Webhook]] — WEBHOOK_URL 生成的 HTTPS URL 用于 Webhook 注册
- [[Telegram Trigger]] — 依赖 WEBHOOK_URL 的 n8n 节点