# @chat-adapter/instagram 中文文档

规范地址：https://npmcn.com/package/%40chat-adapter/instagram/

版本：4\.44\.0
npm 元数据更新时间：2026-11-02T14:55:45.794Z
中文译文更新时间：2026-11-09T11:27:24.879Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chat-adapter/instagram
原文对照：https://npmcn.com/package/%40chat-adapter/instagram/?lang=original
项目主页：https://chat-sdk.dev/adapters/official/instagram
源码仓库：https://github.com/vercel/chat

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：123 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-08-05T15:00:13.697Z
- 最新版本发布：2026-11-02T14:55:45.452Z
- 近 30 天下载量：44760（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

Chat SDK的Instagram Direct Messages适配器——本土MetaMessage API webhooks,媒体,以及快速回复

## 安装

```sh
npm install @chat-adapter/instagram
```

也可以使用：`pnpm add @chat-adapter/instagram`、`yarn add @chat-adapter/instagram`、`bun add @chat-adapter/instagram`

## README

[![Instagram Direct Messages adapter for Chat SDK](https://chat-sdk.dev/en/adapters/official/instagram/og)](https://chat-sdk.dev/adapters/official/instagram)

# @chat-adapter/ instagram (英语)

> npm 软件包 : [`@chat-adapter/instagram`](https://www.npmjs.com/package/@chat-adapter/instagram)

[![Agent Stack](https://img.shields.io/badge/Agent%20Stack-000?style=flat-square&logo=vercel&logoColor=FFF&labelColor=000&color=000)](https://vercel.com/kb/agent-stack) [![MIT License](https://img.shields.io/badge/License-MIT-000?style=flat-square&logo=opensourceinitiative&logoColor=white&labelColor=000&color=000)](https://npmcn.com/package/LICENSE)

本地 Instagram 直接信件适配器 [聊天SDK](https://chat-sdk.dev/)。 。 。 . 它使用 Meta 的 Instagram API 与 Instagram 登录并不需要一个 聚会.

联合国 [聊天-sdk.dev/适应者/官方/instagram](https://chat-sdk.dev/adapters/official/instagram) 指南: [vercel.com/kb/chat-sdk (英语)](https://vercel.com/kb/chat-sdk)

> 脸书信使大楼? 使用 [`@chat-adapter/messenger`](https://chat-sdk.dev/adapters/official/messenger) 换句话说 它通过信使平台API连接,并使用Facebook Page访问符.

## 安装

```bash
pnpm add @chat-adapter/instagram
```

## 带CLI的脚手架

```bash
npx create-chat-sdk@latest my-bot --adapter instagram memory
```

访问 [适配器目录](https://chat-sdk.dev/adapters) 查看其它 现有官方和供应商官方适配器.

## 配置

```bash
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`。 。 。 .

## 使用

```ts
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 授权的人类支持代理,适配器 揭露:

```ts
await instagram.sendHumanAgentMessage(threadId, "A human follow-up");
```

`HUMAN_AGENT` 将窗口扩展至7天,并由Meta审计. 它必须 不用于自动电文.

## AI 编码代理

如果你使用AI编码代理如OpenAI Codex,克洛德代码或Cursor, 在写入代码前安装 Chat SDK 技能 :

```bash
npx skills add vercel/chat
```

技能参考了捆绑的文档 `node_modules/chat/docs`。 。 。 . 您也可以安装可选 [Vercel 插件](https://vercel.com/docs/agent-resources/vercel-plugin)数字 :

```bash
npx plugins add vercel/vercel-plugin
```

关于可代理阅读的文件,见 [聊天- sdk.dev/llms.txt](https://chat-sdk.dev/llms.txt) 或者说 [聊天- sdk.dev/llms- full.txt](https://chat-sdk.dev/llms-full.txt)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @chat-adapter/instagram 是什么？

Chat SDK的Instagram Direct Messages适配器——本土MetaMessage API webhooks,媒体,以及快速回复

### 如何安装 @chat-adapter/instagram？

在项目目录运行 npm install @chat-adapter/instagram，或使用 pnpm add / yarn add / bun add。

### @chat-adapter/instagram 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chat-adapter/instagram 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chat-adapter/instagram 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chat-adapter/instagram 可以商用吗？

@chat-adapter/instagram 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chat-adapter/instagram 的下载量有多少？

根据 npm 官方下载统计，@chat-adapter/instagram 在 2026/10/10 – 2026/11/08 这 30 天内被下载 44,760 次，日均约 1,492 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chat-adapter/instagram 还在维护吗？

最新版本 4\.44\.0 发布于 2026/11/02（6 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/08/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。