@chat-adapter/ instagram (英语)
npm 软件包 :
@chat-adapter/instagram
本地 Instagram 直接信件适配器 聊天SDK。 。 。 . 它使用 Meta 的 Instagram API 与 Instagram 登录并不需要一个 聚会.
联合国 聊天-sdk.dev/适应者/官方/instagram 指南: vercel.com/kb/chat-sdk (英语)
脸书信使大楼? 使用
@chat-adapter/messenger换句话说 它通过信使平台API连接,并使用Facebook Page访问符.
安装
pnpm add @chat-adapter/instagram
带CLI的脚手架
npx create-chat-sdk@latest my-bot --adapter instagram memory
访问 适配器目录 查看其它 现有官方和供应商官方适配器.
配置
INSTAGRAM_ACCESS_TOKEN=
INSTAGRAM_APP_SECRET=
INSTAGRAM_VERIFY_TOKEN=
INSTAGRAM_ACCOUNT_ID=
# Optional; defaults to v26.0
INSTAGRAM_API_VERSION=
Instagram 账户必须是专业的企业或创建者账户. 这个
Meta 应用程序需求 instagram_business_basic 财务报告和审定财务报表
instagram_business_manage_messages; 生产应用软件服务于他们做的账户
不需要高级访问.
订阅Instagram Webhook 对象 messages, (中文(简体) ), messaging_postbacks, (中文(简体) ),
messaging_reactions, (中文(简体) ), messaging_seen, (中文(简体) ), messaging_referrals,以及
messaging_optins。 。 。 .
使用
import { createInstagramAdapter } from "@chat-adapter/instagram";
import { Chat } from "chat";
const bot = new Chat({
userName: "mystore",
adapters: {
instagram: createInstagramAdapter(),
},
});
bot.onDirectMessage(async (thread, message) => {
await thread.post(`Thanks for reaching out! You said: ${message.text}`);
});
export const POST = bot.webhooks.instagram;
export const GET = bot.webhooks.instagram;
使用线索ID instagram:{accountId}:{igsid} 所以对话范围应保持到
接收他们的专业账户.
特征
- 接收并发送文本模式
- 接收故事回复、故事提及、分享、媒体和反应
- 通过公共 HTTPS URL 或上传发送图像、视频、音频和 PDF 附件
- 使用Instagram模板或快速回复的卡片
- 打字指标
- 缓冲流线
- 已签名的 Webhooks 和订阅验证
Instagram 不支持信件编辑、信件删除、分组聊天或 通过此 API 模式 .
消息窗口
免费答复必须在顾客最新答复后24小时内发出
留言。 窗口失败被显示为输入 ValidationError。 。 。 .
对于一个真正具有 Meta 授权的人类支持代理,适配器 揭露:
await instagram.sendHumanAgentMessage(threadId, "A human follow-up");
HUMAN_AGENT 将窗口扩展至7天,并由Meta审计. 它必须
不用于自动电文.
AI 编码代理
如果你使用AI编码代理如OpenAI Codex,克洛德代码或Cursor, 在写入代码前安装 Chat SDK 技能 :
npx skills add vercel/chat
技能参考了捆绑的文档 node_modules/chat/docs。 。 。 .
您也可以安装可选
Vercel 插件数字 :
npx plugins add vercel/vercel-plugin
关于可代理阅读的文件,见 聊天- sdk.dev/llms.txt 或者说 聊天- sdk.dev/llms- full.txt。 。 。 .
许可证
麻省理工学院