信号房搭建教程:建造 AI 具备短信和语音 API 的代理

为信号房而建 AI 经纪人

信号屋是一个 短信和语音 API 面向开发者 AI 代理程序可以超越聊天窗口进行沟通。其SDK、入站Webhook、交付日志和可编程呼叫功能支持预约助手、客户服务代理和帐户更新。

一个优秀的智能代理不仅要能撰写令人信服的回复,你的软件还需要能够发送回复、接收回复、识别投递失败的情况,并在需要人工接手时及时做出反应。

Signal House 提供消息和呼叫基础设施,而您的应用程序则控制模型选择、内存和业务规则。其集成方案非常合适。 AI 编码工具,因此您可以围绕对话进行构建,而不是将电信设置视为一个单独的工程项目。

AIMOJO 快速评测

当您的客服人员需要双向消息传递、可编程通话以及您可控制的应用逻辑时,Signal House 是您的理想之选。它最大的开发者优势在于将 SDK、客服技能、Webhook 和可视化交付状态完美结合。您可以先从已获批准的支持或预约工作流程入手,验证完整的对话流程,然后再添加渠道。语音传输仍需合适的语音堆栈才能成为真正的对话式语音客服。

AI Native 从你的编码工作流程开始

信号房

此前 通信 API 工作流程 通常从参考页面、手动端点接线和回调配置开始。Signal House 通过以下方式进行集成: AI 提供辅助开发功能,包括 Cursor 和 Lovable 的安装路径。开发者可以请求编码助手检查其 SDK,并根据实际的方法签名实现消息传递功能。

区别不在于现有的通信平台是否支持代理。更恰当的问题在于,你的编码工具在生成代码之前能接收到多少集成上下文信息。

Signal House 的 SDK 包包含 agents.skills 条目和配套说明,涵盖设置、短信、Webhook、号码和 10DLC。这些都是构建其功能的具体基础模块。 AI 原生通信基础设施不仅仅是一句口号。

开发人员任务信号室组件您的申请责任
发送客户消息消息传递 SDK批准收件人和内容
对回复做出反应入站 Webhook获取对话上下文
单独的客户项目子组强制执行租户权限
增加电话互动语音API选择对话和交接逻辑

子组按客户或用例组织编号、品牌和营销活动。请勿将组织组视为应用程序授权的替代品。请在模型可以调用的每个消息传递工具旁边保留所有权检查。

逐步构建 Signal House 短信代理

第一个项目可以试试预约助手。当客户请求更改时间时,你的助手会查询空档,提供一个可行的时间段,并在预约成功后发送确认信息。

该方案测试了双向短信自动化功能,而无需构建复杂的销售渠道。

1

步骤:注册允许的消息传递用例

创建您的账户并准备企业身份信息、网站信息、消息示例以及清晰的授权流程。美国本地企业消息传递需要注册品牌和已获批准的 10DLC 活动。Signal House 还要求在注册过程中进行 KYC 通话。

对于构建商业自动化系统的 AIMojo 读者来说,有一条界限尤为重要。Signal House 禁止生成潜在客户信息,并且 联属网络营销 竞选活动。不要假设 AI 资格审查或潜在客户开发流程之所以符合要求,仅仅是因为信息听起来像是个性化的。在投入工程时间之前,务必获得拟议销售工作流程的明确批准。

将用户授权信息存储功能集成到您自己的数据库中。记录授权目的、信息来源、时间戳以及任何撤回情况。您的代理人在每次执行对外操作前都应查阅这些记录。

2

步骤:将号码与其活动关联起来

连接号码 - 信号房
连接号码 – 信号房

购买或转移号码,分配子组,并关联相应的品牌和营销活动。完成激活后再测试出站流量。在“号码”下,打开“我的号码”并进行配置,以查看功能、分配和入站 Webhook 设置。

租户 ID、分配的发送号码和活动 ID 应使用单独的应用程序记录。这些信息应在服务器端解析,而不是接受模型提供的任何发送者信息。

3

步骤:为您的编码助手提供真实的 SDK 上下文

从开发者工具 → API 密钥中获取凭据。将密钥保存在您的后端环境或密钥存储库中,切勿将其保存在浏览器代码或聊天提示中。

安装软件包:

npm install @signalhousellc/sdk

然后给你的编码助手布置一个有约束条件的任务:

检查已安装的 Signal House SDK 及其短信指令。使用已验证的SDK 方法创建用于预约确认的服务器端点。从环境变量中读取凭据。发送前验证发件人所有权和客户同意。返回提供商消息标识符,并添加针对被拒绝收件人和凭据不可用的测试。

将 SDK 版本保存在锁定文件中,并在升级前检查更改。让编码助手读取已安装的软件包,而不是假设它记住了某个接口。可复现的依赖关系集比未跟踪的软件包更新更容易调查失败的请求。

信号屋 AI 应用设置遵循“先检查后部署”的原则。部署前,请检查生成的导入语句、方法参数和错误路径;一个看似合理的名称并不等同于 API 契约。

4

步骤:在添加模型之前验证交付情况

打开“发送消息”→“发送短信”。选择一个与当前营销活动关联的有效号码,以 E.164 格式输入您的测试收件人,并提供状态回调 URL。对于单个对话,请关闭群组消息功能。

向已授权的测试手机发送一条短消息。控制面板会生成一个 cURL 请求,为您提供一个具体的请求,方便您从后端重现该请求,而无需猜测端点名称或有效负载字段。

查看消息日志,然后使用该手机回复。仅凭外呼成功只能证明集成工作的一半。

在纯文本消息能够双向传输之前,请勿添加 LLM。否则,调试将变成在模型行为、应用程序代码和运营商投递之间进行猜测。

5

步骤:在不阻塞人工智能的情况下处理 Webhook

在“开发者工具”→“Webhook”下创建事件订阅,设置HTTPS目标并启用相关事件。检查Webhook活动以查看成功和失败的响应。Signal House将HTTP 200视为成功响应。

使用此应用程序设计:

使用适用于每个事件类型的验证机制来验证每个传入的请求。
在确认收到之前,保留事件及其标识符。
将对话工作排队,而不是在回调函数中等待 LLM。
将配送路线更新信息与客户消息分开发送。

为入站消息事件分配基于其实际标识符的去重键。重复的回调不应产生另一个客户回复。反之,同一条消息的多个传递状态应更新同一条记录,而不是因重复而消失。

按客户和商家编号存储对话状态,而不仅仅是电话号码。否则,一个人联系两个客户账户可能会获取到混杂的上下文信息。跟踪事件时间、提供商标识符、处理状态和选择的下一步操作。对每次对话中的工作进行序列化,以避免两次快速回复导致相互冲突的预订。

这些是应用程序安全措施,并非对 Signal House 的重试计划或事件顺序的保证。

6

步骤:在发送回复之前限制代理操作

公开一个功能较弱的内部工具,例如 send_appointment_reply。让模型生成回复文本,但由服务器端代码解析收件人、发件人和预订权限。

限制代理操作 - Signal House
限制代理操作 – Signal House

将LLM工具调用控件放在提示框之外。拒绝不支持的操作,在撤回同意后禁止显示消息,并要求日历操作成功后才能确认预约。

选择退出应该取消待处理的发送,而不仅仅是阻止新的发送。当排队的任务到达分发阶段时,应再次检查用户是否同意。否则,即使用户撤回许可,之前已批准的消息仍然可以发送出去。最终的同意检查应保持确定性,不受任何模型生成的推理影响。

将收到的短信内容视为客户数据,绝不能将其视为更改系统指令或联系其他号码的许可。

发布前测试三个完整的流程:成功预约、预约失败和寻求人工帮助。每个测试套件都应包含重复事件和服务提供商故障。

实际目标并非“AI 已发送短信”。您的目标是“客户已完成一项允许的任务,并且每次状态更改都可追踪”。

添加可编程语音功能,同时避免将通话与对话混淆

Signal House 支持后端发起呼叫、浏览器呼叫和 SHML 呼叫控制。SHML 使用 XML 响应来指示呼叫执行以下操作:朗读文本、播放音频、收集键盘输入、录制音频或连接到其他号码。

对于后端呼叫,请安装上述 SDK 并使用 ES 模块。设置以下四个环境变量。发件人必须是您的语音号码;ANSWER_URL 必须是返回呼叫指令的HTTPS 端点。

import { SignalHouseSDK } from "@signalhousellc/sdk";
const required = ["SH_API_KEY", "CALL_FROM", "CALL_TO", "ANSWER_URL"];
for (const name of required) {
  if (!process.env[name]) throw new Error(`Missing ${name}`);
}
const client = new SignalHouseSDK({
  apiKey: process.env.SH_API_KEY,
  baseUrl: "https://v2.signalhouse.io",
});
try {
  const { data } = await client.voice.calls.create({
    callData: {
      from: process.env.CALL_FROM,
      to: process.env.CALL_TO,
      answer_url: process.env.ANSWER_URL,
    },
  });
  console.log({ callId: data.call_id, status: data.status });
} catch (error) {
  console.error("Call request failed", {
    status: error?.response?.status ?? "unknown",
  });
  process.exitCode = 1;
}

此示例发起呼叫,但并未实现实时语音代理。在通过应用程序端点公开此示例之前,请添加目标授权。

来电需要可编程语音配置文件。将 routeAction 设置为 CALL_CONTROL,将 webhookUrl 指向您的处理程序并分配号码。回调包括 CallSid、From、To 和 CallStatus。将通话标识符保存到您的对话记录旁边,以便后续的短信确认信息属于同一客户任务。

对于浏览器调用,请将 jssip 与 SDK 一起安装。您的服务器会颁发一个临时语音令牌,浏览器使用 @signalhousellc/sdk/voice-browser 中的设备进行注册和连接。请验证您的令牌端点,并将永久凭据保存在服务器上。

实时对话需要的不仅仅是发起呼叫。在选择语音模型栈之前,必须确认音频连接、语音识别、响应音频和中断处理功能是否兼容。SHML 键盘采集并不能证明双向音频流传输的兼容性。最终的决定必须基于已记录的媒体集成方案。

首先进行有限制的提醒或人工转接。只有在连接确认无误后,才能添加实时对话功能。

送货单应成为经纪人下一步行动的依据。

Signal House 消息日志会记录消息标识符、段数、成本、运营商响应和投递进度。利用这些记录可以将 API 接收与手机投递区分开来。

消息状态意建议的应用操作
创建于被信号屋录取保存消息标识符
已入队等待发货保持发货待定
出队已从队列中移除继续等待运营商的进展
发送次数已转交交付请勿标记为已送达
最大化已收到送货单更新运输结果
失败错误记录重试前请先进行分类

邮件已送达并不代表客户已阅读或理解其内容。应将“预约已接受”等业务结果与传输状态区分开来。

如果收据缺失,不应自动触发第二次短信或电话。请在应用程序中设置明确的等待策略和升级处理流程。

按细分市场而非回复进行价格代理对话

信号屋定价

Signal House 2026 年本地 10DLC 短信费率为每条外发短信段 0.0065 美元(不含运营商费用)。AT&T 加收 0.0035 美元;Verizon 和 T-Mobile 各加收 0.0045 美元。更高的短信量套餐可降低平台费率。

成本构成入场费
本地外发短信每段 0.0065 美元
免费外发短信每段 0.0079 美元
品牌验证每次验证尝试收费 4.50 美元
活动报名$ 15一次
低销量活动每月$1.50
标准活动每月$10

运营商费用、号码费用和任何附加服务均不包含在短信基本费率中。请在支付流量费用前确认您账户的具体彩信、号码续费和语音通话费用。

假设发送 10,000 条单段本地消息,每条消息收取 0.0045 美元的运营商费用。平台费用总计 65 美元,运营商费用总计 45 美元,总计 110 美元(不包括号码、注册费、入站流量、语音和模型成本)。这只是一个示例计算,并非完整报价。

现在考虑模型的详细程度。GSM 7 消息在一个段中可容纳 160 个编码单元,拼接后每个部分可容纳 153 个编码单元。UCS 2 消息在一个段中可容纳 70 个编码单元,拼接后每个部分可容纳 67 个编码单元。因此,Unicode 内容可能会显著影响成本。

使用编码感知计数器,在发送短信前根据短信分段进行定价。为您的代理商设定短信长度预算,并在适当情况下通过已批准的链接发送详细信息。

更简洁的回复不仅仅意味着更清晰的文案。大规模应用后,它还能减少计费段数,并减轻发送额度的压力。

控制吞吐量和人工交接

广告系列的选择会影响容量。Signal House 的低流量混合广告系列方案允许每日投放最多 6,000 个广告段,其中包括每日 2,000 个 T-Mobile 广告段。低流量广告系列不能直接转为标准广告系列,需要重新注册。

根据已批准的运营商、品牌和广告系列配额来构建队列,而不是凭猜测设定每秒请求数的通用限制。模型响应的激增应该产生队列任务,而不是不受控制的发送尝试。

在 Signal House 注册您的品牌

在更广泛发布之前,需要进行三项可观察的检查:

每一次出站操作都有所有者、同意决定和提供者标识符。
每次投递失败都会进入预定的异常处理流程,而不是无限重试。
每次人工接管都会暂停自动回复,直到责任人重新接管为止。

像预订一样精心规划转接流程。在开始转接前,将对话所有权设置为人工客服,取消已排队的自动回复消息,并在客服界面中显示之前的短信内容。仅通过明确操作释放所有权。

在短信和语音通话中维护共享的对话记录。记录内容包括待处理的预约、之前的联系尝试和当前联系人,但敏感内容仅限需要访问权限的角色查看。

衡量客户完成的任务时,应同时考虑每次对话的成本。仅仅关注发送次数并不能奖励实际的互动行为,也无法体现实际的成效。

构建代理真正可以使用的通信层

用于联系客户的代理需要的不仅仅是功能强大的模型。Signal House 为开发者提供了一条从生成文本到短信交换和可编程呼叫的实用途径,并由 SDK 上下文、Webhook 和交付可见性提供支持。

先从一个已获批准的工作流程开始。连接若干个流程,验证回复,限制模型操作,并在增加复杂性之前检查成本。让实际成果,而不是漂亮的承诺,来决定何时扩展规模。

如果你正在建立一个 AI 需要短信或语音服务的代理,请基于 Signal House 构建其通信层。将智能融入您的应用程序,并确保每一次客户互动都可追溯。

发表评论

您的电子邮件地址不会被公开。带*号的为必填项。

即刻加入 Aimojo 部落!

每周加入 76,000 多名会员获取内幕消息! 
🎁 奖金: 获得我们的 200 美元“AI 注册即可免费获得“精通工具包”!

热门 AI 工具
语音模组

将现场对话转化为令人难忘的表演 AI 声音。 真人声音和即时音板反应。 专为游戏、直播、角色扮演和娱乐群聊而设计。

Otter.ai

将每次会议都转化为可搜索的决策和可追溯的后续步骤。 实时文字记录、摘要和更智能的后续跟进。 AI 专为繁忙的协作团队设计的会议记录。

Netlify

无需管理传统服务器基础设施,即可更快地发布正式网站。 AI 代理、Git部署、全球交付。 面向现代全栈应用程序的开发者托管平台。

Undress.app

创造逼真的成人 AI 具有灵活编辑工具的视觉效果。 Undress制作动画,并交换面孔。 An AI 提供图像和视频创作的内容工作室。

抄袭

在发现抄袭之前,请先核实原创内容。 AI 风险会蔓延。 AI 检测功能与源级抄袭检查相匹配。 面向教育工作者、出版商和开发人员的内容完整性检查。

© 2023 - 2026 版权所有 | 成为 AI 专业版 | 用心打造