Hey David, let's break down how to get Instagram Webhooks working on your own server, and clear up that confusion around PUT requests for content publish events.

一、先搞定Webhook的基础配置 #

First off, you'll need a Meta Developer account and an Instagram Business/Creator Account (personal accounts don't support Webhooks—this is a key point). Here's the step-by-step:

1. 配置Meta应用并关联Instagram账号 #

• 进入Meta开发者平台，创建一个「Business」类型的应用，然后在应用的「Products」模块中添加Instagram Graph API。
• 完成Instagram Business/Creator账号与应用的关联（需要走授权流程，确保账号权限符合要求）。

2. 准备服务器的Webhook端点 #

你的服务器需要一个公开可访问的HTTPS端点（Instagram不支持HTTP地址，这是硬性要求），比如https://your-domain.com/instagram-webhook。这个端点要处理两类请求：

• 处理初始验证的GET请求：当你在Meta平台配置Webhook时，Meta会发送一个带有hub.mode、hub.challenge、hub.verify_token三个参数的GET请求。你需要验证verify_token是否和自己在Meta设置的一致，一致的话直接返回hub.challenge的内容作为200响应即可。
  示例代码（Node.js/Express）：

  app.get('/instagram-webhook', (req, res) => {
    const YOUR_VERIFY_TOKEN = '自定义的验证令牌';
    const { hub: { mode, verify_token, challenge } } = req.query;
  
    if (mode === 'subscribe' && verify_token === YOUR_VERIFY_TOKEN) {
      console.log('Webhook验证成功！');
      res.status(200).send(challenge);
    } else {
      res.sendStatus(403);
    }
  });
  

• 处理事件通知的POST请求：验证通过后，Instagram会把所有Webhook事件以POST请求的形式发送到这个端点。

3. 在Meta平台订阅目标事件 #

• 进入应用的「Webhooks」设置页面，选择Instagram Graph API作为订阅对象，填入你的端点URL和验证令牌。
• 订阅你需要的事件：如果关注内容发布，就勾选media_publish（自己账号发布内容时触发）和mention（他人@你的内容时触发）。注意：这些事件需要对应的权限（比如instagram_basic、pages_show_list），你需要在Meta平台申请并通过审核才能使用。

二、关于PUT请求的疑问解答 #

直接说结论：Instagram Webhook只会用POST请求发送事件通知。PUT请求一般是你调用Instagram Graph API更新资源（比如修改媒体标题）时用到的，不是Instagram给你推送通知的方式，这就是你找不到相关资料的原因。

如何处理内容发布的事件通知 #

Webhook配置完成后，这样处理发布事件：

1. 解析POST请求的事件数据
   端点需要解析POST请求的JSON请求体，同时建议验证请求签名，确保通知确实来自Instagram（防止恶意请求）。
   示例代码（Node.js/Express）：

   const crypto = require('crypto');
   const YOUR_APP_SECRET = 'Meta应用的密钥';
   
   app.post(
     '/instagram-webhook',
     express.json({ verify: (req, res, buf) => { req.rawBody = buf; } }),
     (req, res) => {
       // 验证请求签名
       const signature = req.headers['x-hub-signature-256'];
       const expectedSignature = `sha256=${crypto
         .createHmac('sha256', YOUR_APP_SECRET)
         .update(req.rawBody)
         .digest('hex')}`;
   
       if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature))) {
         return res.sendStatus(403);
       }
   
       // 处理事件逻辑
       const { object, entry } = req.body;
       if (object === 'instagram') {
         entry.forEach(entry => {
           entry.changes.forEach(change => {
             // 自己发布内容的触发逻辑
             if (change.field === 'media' && change.value.event === 'publish') {
               console.log(`新内容发布！媒体ID：${change.value.media_id}`);
               // 这里可以调用Instagram Graph API获取媒体的详细信息，比如内容、发布时间等
               // 示例：调用GET /${change.value.media_id}接口
             }
             // 被他人@的触发逻辑
             if (change.field === 'mentions') {
               console.log(`你被@了！媒体ID：${change.value.media_id}`);
             }
           });
         });
       }
   
       res.sendStatus(200);
     }
   );
   

2. 关于他人发布内容的监听限制
   你无法收到任意用户的内容发布通知——Instagram的API权限限制只能获取和你账号相关的事件（自己的发布、被@、评论等）。如果需要跟踪特定用户的内容，只能通过定期调用Graph API获取其媒体列表（但会受API调用次数限制）。

常见问题排查 #

• 验证失败：检查端点是否为HTTPS、验证令牌是否完全匹配、服务器是否能被公网访问。
• 收不到事件：确认已订阅正确的事件、相关权限已通过审核、Instagram账号已正确关联到Meta应用。
• 签名验证失败：确保使用的是Meta应用的「应用密钥」（不是访问令牌），且用原始请求体进行哈希计算（Express的json中间件会修改请求体，所以示例中保存了rawBody）。

内容的提问来源于stack exchange，提问作者David Alen