iMessage 频道
这个包通过 BlueBibbles HTTP 桥,给一个代理服务器一个文本消息工具和一个输入的webhook适配器. 运单需要一个macOS服务器.
安装
npm install @framers/agentos-ext-channel-imessage
同伴依赖 : @framers/agentos >=0.10.40。 。 。 .
使用量
import { AgentOS } from '@framers/agentos';
const agentos = await AgentOS.create({
extensionManifest: {
packs: [
{
package: '@framers/agentos-ext-channel-imessage',
options: {
serverUrl: process.env.IMESSAGE_SERVER_URL ?? process.env.BLUEBUBBLES_SERVER_URL,
password: process.env.IMESSAGE_PASSWORD ?? process.env.BLUEBUBBLES_PASSWORD,
webhookPath: process.env.BLUEBUBBLES_WEBHOOK_PATH ?? process.env.IMESSAGE_WEBHOOK_PATH,
},
},
],
},
});
配置
由备选方案产生的全权证书决定,然后 options.secrets,然后是环境变量.
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
|---|---|---|---|---|
serverUrl | imessage.serverUrl | IMESSAGE_SERVER_URL, (中文(简体) ), BLUEBUBBLES_SERVER_URL | 对 | 无; 缺失时投掷 |
password | imessage.password | IMESSAGE_PASSWORD, (中文(简体) ), BLUEBUBBLES_PASSWORD | 对 | 无; 缺失时投掷 |
webhookPath | 无 | BLUEBUBBLES_WEBHOOK_PATH, (中文(简体) ), IMESSAGE_WEBHOOK_PATH | 没有 | /bluebubbles-webhook |
maxBodyBytes | 无 | 无 | 没有 | 1048576 |
priority | 无 | 无 | 没有 | 50 |
secrets | 无 | 无 | 没有 | 未设置 |
服务器 URL 已修剪、 增益 http:// 当不存在 HTTP 方案并失去后缀时。 网路获得领先的斜线,失去领先的斜线。 无效或非阳性 maxBodyBytes 值使用默认值.
工具
| 工具 | 它会做什么 |
|---|---|
imessageChannelSendMessage | 通过iMessage BlueBubbles适配器发送短信. |
imessageChannelSendMessage
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
conversationId | 字符串 | 对 | 目标蓝泡 chatGuid (对话ID) |
text | 字符串 | 对 | 信件文本 |
频道适配器
适配器注册平台 imessage. 激活标志连接的服务。 将第一个文本块发送到 /api/v1/message/text 与谈话的 chatGuid,生成 tempGuid 和密码作为查询参数.
这个 imessageWebhook HTTP处理器接收了"蓝泡"JSON有效载荷并发送了消息事件. 它接受嵌入式信件数据,获取发件人和聊天标识符,并使用聊天GUID或显式组旗来映射分组或直接聊天. 它忽略了由桥面本身的用户发送的信息和没有发送或聊天GUID的信息. 没有文本的信件变为 <media:message>. 打字指标无所作为.
页:1
发送会创建远程消息,需要蓝泡macOS服务器. 在包创建过程中缺少服务器 URL 或密码抛出 。 激活前发送或空对话 ID 或文本失败 。 没有消息标识符返回的成功响应 ok。 。 。 .
Webhook Get请求返回健康响应. POST 请求以配置的密码认证 。 页眉优先是 x-guid, (中文(简体) ), x-password, (中文(简体) ), x-bluebubbles-guid,则 authorization; 没有页眉, 查询参数使用 guid,则 password。在比较前删除一个无记名前缀.
认证失败, 请求体大小过大以及 JSON 无效 。 其他HTTP方法被否决. 未处理配置的 Webhook 路径以外的请求 .
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .
许可证
阿帕奇 - 2.0