跳到主要内容

📡 渠道概述

PulseHub 中的渠道代表一个已连接的消息账户。您可以拥有多个相同类型的渠道 — 例如，两个用于不同部门的 WhatsApp 号码，或三个用于销售/支持/账单的邮箱。

渠道工作原理​

提供商（WhatsApp、Twilio 等）
           │
           │  HTTP POST（webhook）
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. 验证签名
  2. 标准化载荷
  3. 查找/创建联系人
  4. 查找/创建会话
  5. 保存消息
  6. 触发自动化事件

每个渠道都有：

  • 一个唯一 ID（UUID）— 这是 webhook URL 中的 {channel_id}
  • 一个类型 — 8 种支持的渠道类型之一
  • 一个配置 — 包含该渠道类型特定凭据的 JSON 数据
  • 一个 webhook 令牌 — 创建时生成的 32 位十六进制随机令牌
  • 一个活跃标志 — 非活跃渠道会拒绝入站 webhook 且不发送出站消息

添加渠道​

  1. 在侧边栏中进入渠道
  2. 点击添加渠道
  3. 从下拉菜单中选择渠道类型
  4. 填写特定类型的凭据（参见各渠道指南）
  5. 点击保存渠道

保存后，渠道卡片会显示 Webhook URL。复制此 URL 并粘贴到您提供商的开发者面板中。

Webhook URL 格式​

https://yourdomain.com/webhooks/{type}/{channel_id}

支持的渠道​

渠道方向签名验证备注
WhatsApp双向✅ HMAC-SHA256需要 Meta Business 账户
SMS / Twilio双向部分需要 Twilio 账户
Email双向不适用IMAP 轮询接收
Telegram双向—Bot API，无签名
Viber双向✅ HMAC-SHA256需要 Viber Partners 账户
Instagram双向✅ HMAC-SHA256通过 Meta Graph API
Facebook Messenger双向✅ HMAC-SHA256通过 Meta Graph API
网页聊天小部件双向Token嵌入式 JS 代码片段