---
title: "Telegram Trigger"
type: concept
tags: [n8n, telegram, trigger, automation]
sources: [n8n-configure-telegram-trigger]
last_updated: 2026-04-22
---

## Definition
Telegram Trigger 是 n8n 工作流自动化平台内置的触发器节点，用于接收 Telegram Bot 的消息事件并触发后续工作流。当用户在 Telegram 中向 Bot 发送消息时，n8n 通过 Telegram Webhook 机制实时接收消息并执行工作流。

## Configuration Requirements
- n8n 实例必须可通过 **HTTPS** 公开访问（Telegram Webhook 的硬性要求）
- Telegram Bot Token（通过 BotFather 创建获取）
- `WEBHOOK_URL` 环境变量指向 HTTPS 基础地址

## Common Error
```
Telegram Trigger: Bad Request: bad webhook: An HTTPS URL must be provided for webhook
```
此错误表示 n8n 生成的 Webhook URL 不是 HTTPS 协议。解决方法：在 Docker / Docker Desktop / docker-compose 中设置 `WEBHOOK_URL=https://your-domain.com/`

## Related Concepts
- [[Webhook]] — Telegram Trigger 的底层通信机制
- [[WEBHOOK_URL]] — n8n 环境变量，控制 Telegram Trigger 的 Webhook URL 生成