nexus/wiki/concepts/WEBHOOK_URL.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
WEBHOOK_URL	concept	n8n environment-variable webhook telegram	n8n-configure-telegram-trigger	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 中设置：

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 节点