通用入站

POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>

{
  "channel": "my-app",
  "external_id": "user-42",
  "text": "Hello from my custom integration"
}

**通用入站是进入 AiHummer 的通用入口。** 当没有为你的来源专门建立的渠道——例如电子邮件到 webhook 的中继、定时任务、内部工具——你将消息发送到一个端点，它就会像其他渠道消息一样进入对话引擎。 ## 终点 发送一个 JSON `POST` 到入口： ```http POST /v1/inbound/generic Content-Type: application/json X-AIHummer-Inbound-Secret: <hmac> { "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration" } ``` 该主体包含三个字段： - **`channel`** — 你为来源选择的逻辑通道名称。 - **`external_id`** — 终端用户或对话的稳定标识符。 - **`text`** — 消息内容。 ## 认证 该端点由一个...保护 **哈希消息认证码** 被携带在 **`X-AIHummer-Inbound-Secret`** 头部，来源于共享 **`AIHUMMER_INBOUND_SECRET`**没有有效签名的请求会被拒绝，因此只有持有密钥的调用者才能注入消息。 > [!NOTE] > 网关必须配置默认工作区 > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) 用于分发通用的入站消息。 ## 附加通道连接器 AiHummer 提供额外的通道连接器。每个连接器都可以从市场安装，在自己的端口上本地运行，并将传入消息转发给 `/v1/inbound/generic`. | 连接器 | 港口 | 笔记 | |---|---|---| | Discord | 8801 | | | Slack | 8802 | | | 矩阵 | 8803 | | | 信号 | 8804 | 需要一个 `signal-cli` 边车 | | 微软团队 | 8805 | | | 电子邮件 (IMAP/SMTP) | 8806 | | | WhatsApp 云 API | 8807 | | > [!NOTE] > 连接器可以从市场安装；有些需要额外的服务 > （例如， `signal-cli` 用于 Signal)。 ## 浏览器扩展 AiHummer 还提供一个浏览器扩展， **Manifest V3 侧边栏** 聊天界面。它是一个 **……的客户 `/v1/chat/completions`** 使用个人 `ah-` API 密钥 — **不是服务器端通道**将其用于个人的浏览器内聊天，而不是用作路由的入站来源。 ## 接下来去哪儿 - 有关生产聊天，请参见 [电报](/zh/v1.0/channels/telegram) 和 [最大](/zh/v1.0/channels/max). - 关于员工即时消息，请参见 [Bitrix24](/zh/v1.0/channels/bitrix24). - 针对 API 构建？看 [聊天/完成](/zh/v1.0/api/chat-completions).