30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
---
|
||
title: "Webhook"
|
||
type: concept
|
||
tags: [webhook, http, api, real-time]
|
||
sources: [n8n-configure-telegram-trigger]
|
||
last_updated: 2026-04-22
|
||
---
|
||
|
||
## Definition
|
||
Webhook 是一种服务器间实时推送数据的机制，通过 HTTP POST 请求将事件通知从发送方服务器主动推送到接收方服务器。与轮询（Polling）不同，Webhook 是被动接收，无需客户端频繁请求。
|
||
|
||
## How It Works
|
||
1. 接收方服务器向发送方注册一个公开可访问的 HTTPS URL
|
||
2. 发送方在特定事件发生时向该 URL 发送 HTTP POST 请求
|
||
3. 接收方处理请求并返回响应
|
||
|
||
## Telegram Webhook
|
||
Telegram Bot API 支持两种消息接收模式：
|
||
- **Polling 模式**：Bot 主动轮询 Telegram 服务器拉取更新
|
||
- **Webhook 模式**：Telegram 服务器在收到消息时主动 POST 到 Bot 指定的 HTTPS URL
|
||
|
||
Telegram 要求 Webhook URL 必须是 HTTPS 协议，HTTP 或 localhost 无法使用。
|
||
|
||
## n8n 与 Webhook
|
||
n8n Telegram Trigger 节点依赖 Telegram Webhook 机制接收消息。配置时需确保 n8n 实例可通过 HTTPS 访问，否则 Telegram 会拒绝注册 Webhook。
|
||
|
||
## Related Concepts
|
||
- [[Telegram Trigger]] — n8n 中使用 Webhook 接收 Telegram 消息的节点
|
||
- [[WEBHOOK_URL]] — n8n 环境变量，指定 Webhook URL 基础地址
|