@ agentphone/chat-sdk-适应器
代理电话 用于 聊天SDK ——第一个配有SMS,MMS,iMessage,和语音调用支持的适配器.
特征
| 特性 | 简讯 | 管理事务 | iMessage 图像 | 语音 |
|---|---|---|---|---|
| 发送信件 | 对 | 对 | 对 | —— 说 |
| 接收信件 | 对 | 对 | 对 | —— 说 |
| 媒体附件 | —— 说 | 对 | 对 | —— 说 |
| 反应 | —— 说 | —— 说 | 对 | —— 说 |
| 电话记录 | —— 说 | —— 说 | —— 说 | 对 |
| 调用摘要 | —— 说 | —— 说 | —— 说 | 对 |
安装
npm install @agentphone/chat-sdk-adapter chat
快开始
import { Chat } from "chat";
import { createAgentPhoneAdapter } from "@agentphone/chat-sdk-adapter";
const chat = new Chat({
adapter: createAgentPhoneAdapter({
apiKey: process.env.AGENTPHONE_API_KEY,
agentId: process.env.AGENTPHONE_AGENT_ID,
webhookSecret: process.env.AGENTPHONE_WEBHOOK_SECRET,
}),
onNewMention: async ({ message, reply }) => {
// Handles SMS, MMS, iMessage, and voice call transcripts
await reply(`Got your message: ${message.text}`);
},
});
// In your HTTP server (Express, Hono, Next.js, etc.)
app.post("/webhook/agentphone", (req) => chat.webhooks.agentphone(req));
配置
| 选项 | 新闻 var | 需求 | 说明 |
|---|---|---|---|
apiKey | AGENTPHONE_API_KEY | 对 | 您的代理 Phone API 密钥 |
agentId | AGENTPHONE_AGENT_ID | 对 | 发送信件的代理ID |
webhookSecret | AGENTPHONE_WEBHOOK_SECRET | 没有 | HMAC-SHA256 网签秘密 |
apiUrl | —— 说 | 没有 | API 基础 URL( 默认 ): https://api.agentphone.ai(中文(简体) ) |
userName | BOT_USERNAME | 没有 | 瓶子显示名( 默认 ): "bot"(中文(简体) ) |
Webhook活动
适配器处理来自AgentPhone的三种webhook事件类型:
agent.message——入站短信,MS,或iMessage. 路由到onNewMention。 。 。 .agent.call_ended——语音通话完成并配有完整笔录和摘要. 路由到onNewMention作为包含笔录的信息.agent.reaction——iMessage回扣反应(爱,如出一辙等). 路由到onReaction。 。 。 .
Webhook 校验
所有AgentPhone Webhooks都与HMAC-SHA256签约. 设定 webhookSecret 能够进行核查。 适配器检查:
X-Webhook-Signature标题与 HMAC 相匹配{timestamp}.{body}X-Webhook-Timestamp在5分钟内( 重放保护)
iMessage 反应
AgentPhone是唯一支持iMessage反应的Chat SDK适配器:
// Send a tapback reaction
await adapter.addReaction(threadId, messageId, "love");
// Supported: love, like, dislike, laugh, emphasize, question
// Custom emoji also supported on newer devices: "🔥", "😂", etc.