跳到主要内容

💬 Viber

PulseHub 通过 Viber REST API 连接到 Viber，使用 Viber 公共账户或 Viber 机器人。

前提条件​

在 partners.viber.com 拥有一个 Viber Partners 账户。

设置步骤​

1. 创建 Viber 机器人/公共账户​

  1. 前往 partners.viber.com
  2. 使用您的 Viber 账户登录
  3. 点击 Create Bot Account
  4. 填写机器人名称、描述和类别
  5. 创建后，您会收到一个 Auth Token

2. 在 PulseHub 中添加频道​

  1. 前往 Channels → Add Channel
  2. 选择 Viber
  3. 输入 Auth Token 和机器人名称
  4. 点击 Save Channel
  5. 复制 Webhook URL

3. 注册 Webhook​

选项 A — 使用在线工具（无需终端）： 使用任何免费的在线 REST 客户端（例如 Reqbin、Hoppscotch 或 Postman web）发送 POST 请求：

  • URL： https://chatapi.viber.com/pa/set_webhook
  • Header： Content-Type: application/json
  • Body：
{
    "auth_token": "YOUR_VIBER_AUTH_TOKEN",
    "url": "https://yourdomain.com/webhooks/viber/YOUR_CHANNEL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
}

选项 B — 使用终端（VPS）：

curl -X POST https://chatapi.viber.com/pa/set_webhook \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "YOUR_VIBER_AUTH_TOKEN",
    "url": "https://yourdomain.com/webhooks/viber/YOUR_CHANNEL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
  }'

4. 测试​

在应用中打开您的 Viber 机器人并发送一条消息。消息应在几秒内出现在 PulseHub 中。

签名验证​

Viber 使用 HMAC-SHA256 和您的 Auth Token 通过 X-Viber-Content-Signature 对每个 webhook 进行签名。