跳到主要内容

消息提供商

设置 → 通信 → 消息提供商是您将 LeadHub 连接到双向消息渠道的地方。配置后，可直接从线索详情视图联系线索，来自这些渠道的入站消息将出现在对话中。

支持的渠道：

渠道方向提供商
WhatsApp发送和接收Meta Cloud API（WhatsApp Business）
SMS发送和接收Twilio 可编程消息
Telegram发送和接收Telegram Bot API
Viber发送和接收Viber 商业消息
语音（点击通话）出站 + 录音Twilio 可编程语音

WhatsApp Business（Meta Cloud API）​

前提条件​

  • 在 business.facebook.com 注册的 Meta 商业账户
  • 已通过审核手机号码的 WhatsApp 商业账户
  • 该号码必须在 WhatsApp Cloud API 上注册（而非普通 WhatsApp 应用）

步骤 1 — 创建 Meta 应用​

  1. 前往 developers.facebook.com → 我的应用 → 创建应用。
  2. 选择商业作为应用类型。
  3. 给它起个名称（例如 LeadHub Integration）并点击创建应用。
  4. 在添加产品下，找到 WhatsApp 并点击设置。

步骤 2 — 获取您的凭证​

  1. 在 WhatsApp 产品控制台中，前往 API 设置。
  2. 记录：
    • 电话号码 ID（数字，例如 106540352242922）
    • WhatsApp 商业账户 ID
  3. 前往系统用户（在商业设置中）→ 创建系统用户 → 生成具有 whatsapp_business_messaging 权限的永久访问令牌。

步骤 3 — 在 LeadHub 中配置​

  1. 前往 设置 → 通信 → 消息提供商。

  2. 展开 WhatsApp Business 部分并填写：

    字段值
    已启用开启
    永久访问令牌来自步骤 2
    电话号码 ID来自步骤 2
    显示电话号码您的 WhatsApp 号码（例如 +1-415-555-0199）

  3. 点击保存设置。

  4. 保存后会出现入站 Webhook URL，格式如下： https://yourdomain.com/api/messaging/whatsapp/webhook/TENANT_ID/TOKEN

步骤 4 — 在 Meta 中注册 Webhook​

  1. 在 Meta 应用控制台中，前往 WhatsApp → 配置 → Webhooks。
  2. 将回调 URL 设置为步骤 3 中的入站 Webhook URL。
  3. 将验证令牌设置为任意字符串（例如 leadhub_verify）——您将在确认步骤中粘贴此内容。
  4. 订阅 messages Webhook 字段。

测试： 从您的手机向您的 WhatsApp 号码发送消息。它应该作为新对话出现在 LeadHub 中。

SMS（Twilio 可编程消息）​

步骤 1 — 获取 Twilio 凭证​

  1. 登录 console.twilio.com。
  2. 在控制台中，复制您的账户 SID 和身份验证令牌。
  3. 在电话号码 → 管理 → 活跃号码下，记录您的 Twilio 号码。

步骤 2 — 在 LeadHub 中配置​

  1. 前往 设置 → 通信 → 消息提供商。

  2. 展开 SMS (Twilio) 并填写：

    字段值
    已启用开启
    账户 SIDTwilio 控制台中的 AC...
    身份验证令牌来自 Twilio 控制台
    发送号码E.164 格式的 Twilio 号码（例如 +14155550199）

  3. 点击保存设置。

  4. 复制保存后出现的入站 Webhook URL。

步骤 3 — 在 Twilio 中注册 Webhook​

  1. 在 Twilio 中，前往电话号码 → 管理 → 活跃号码 → 点击您的号码。
  2. 在消息→收到消息时下，将 Webhook URL 设置为您的 LeadHub 入站 Webhook URL。
  3. 设置方法为 HTTP POST 并保存。

试用账户： 只能向已验证的号码发送短信。生产使用请升级到付费账户。

Telegram​

步骤 1 — 创建 Telegram Bot​

  1. 打开 Telegram 并向 @BotFather 发消息。
  2. 发送 /newbot 并按提示操作（名称和用户名）。
  3. BotFather 会给您一个 Bot Token（格式：123456:ABCdef...）。
  4. 还要记录 Bot 用户名（例如 @your_leadhub_bot）。

步骤 2 — 在 LeadHub 中配置​

  1. 前往 设置 → 通信 → 消息提供商。

  2. 展开 Telegram 并填写：

    字段值
    已启用开启
    Bot Token来自 BotFather
    Bot 用户名例如 @your_leadhub_bot

  3. 点击保存设置。

  4. 复制出现的入站 Webhook URL。

LeadHub 使用 Telegram Bot API 自动向 Telegram 注册 Webhook——您无需手动将 URL 粘贴到 Telegram 中。

Viber 商业消息​

⚠️ Viber 商业消息需要已审批的 Viber 服务账户（ISV/商业账户）。普通 Viber 个人账户无法发送商业消息。

步骤 1 — 获取您的 Viber 身份验证令牌​

  1. 联系 Viber 合作伙伴计划并获取您的服务账户。
  2. 登录 Viber 合作伙伴门户并找到您的身份验证令牌。
  3. 记录发件人名称（您的品牌名称，最多 28 个字符）。

步骤 2 — 在 LeadHub 中配置​

  1. 前往 设置 → 通信 → 消息提供商。

  2. 展开 Viber 并填写：

    字段值
    已启用开启
    身份验证令牌来自 Viber 合作伙伴门户
    发件人名称您的品牌名称

  3. 点击保存设置。

  4. 复制入站 Webhook URL 并在您的 Viber 服务账户控制台中注册它。

语音/点击通话（Twilio Voice）​

Twilio Voice 可直接从线索详情页面一键拨号。通话记录在通话历史中，可以录音并自动转录。

前提条件： 必须先配置 SMS (Twilio)——语音复用相同的账户 SID 和身份验证令牌。

步骤 1 — 在 LeadHub 中配置​

  1. 前往 设置 → 通信 → 消息提供商。

  2. 展开语音 (Twilio Voice) 并填写：

    字段值
    已启用开启
    语音主叫 ID 号码E.164 格式的 Twilio 语音号码（可能与短信号码不同）
    录制通话开启以录制双方通话
    自动转录 + AI 摘要开启以生成文字转录和摘要（需要平台配置中的 OpenAI API 密钥）

  3. 点击保存设置。

  4. 出现三个 URL——TwiML URL、状态 URL 和录音 URL。全部复制。

步骤 2 — 在 Twilio 中注册 Webhooks​

  1. 在 Twilio 中，前往您的语音号码 →语音部分。
  2. 设置接到电话时 → Webhook → 粘贴您的 TwiML URL。
  3. 设置通话状态变更 → 粘贴您的状态 URL。
  4. 在录音下，将 Webhook 设置为您的录音 URL。

发送测试消息​

保存任何渠道后，点击发送测试消息（页面右上角）：

  1. 选择渠道（WhatsApp、SMS、Telegram 或 Viber）。
  2. 输入要发送到的电话或聊天 ID（测试时使用您自己的号码）。
  3. 输入测试消息正文。
  4. 点击发送——真实消息将被发送到该联系人。

使用您自己的号码或测试号码。这会发送真实消息。

故障排除​

问题解决方案
"保存设置一次以生成入站 Webhook URL"您尚未保存——填写凭证后先点击保存
WhatsApp Webhook 验证失败确保 Meta 中的验证令牌与设置时使用的一致
Telegram 消息未到达LeadHub 自动注册 Webhook——检查 Bot Token 是否正确
SMS 测试失败确认身份验证令牌正确且您的 Twilio 号码处于活跃状态
语音通话无法连接确保 TwiML 和状态 URL 都已在 Twilio 中注册
令牌显示为遮掩（••••••••••••）这是有意为之——现有密钥出于安全目的被遮掩。保持不变以保留存储的密钥。