李克強総理、河野太郎外務大臣と会見

通过 Webhooks，您可以接收 Meta 社交关系图谱中特定对象变更的实时 HTTP 通知。例如，当客户向您的 Instagram 专业账户发送消息时，我们会向您发送通知。Webhooks 通知可帮助您追踪消息变更，避免在为追踪变更而查询 Messenger 开放平台端点时造成流量限制。

要求

您需要实现以下要求，才能接收 Instagram 消息的 Webhooks 通知。

• instagram_basic、instagram_manage_messages 和 pages_manage_metadata 权限
• 如要接收的 Webhooks 通知包含由没有应用身份的用户拥有或管理的数据，您的应用必须拥有高级访问级别

注意：您需要为企业的所有消息应用订阅消息 Webhooks。

应用模式

• 开发模式 – 仅在使用您应用的用户拥有该应用的身份时，系统才会发送 Webhooks，即使您的应用具有高级访问级别也是如此。您只能访问您拥有或管理的数据。
• 上线模式 – 系统将根据访问级别发送 Webhooks。

  • 标准访问级别 – 仅在使用您应用的用户拥有该应用的身份时，系统才会发送 Webhooks。您只能访问您拥有或管理的数据。
  • 高级访问级别 – 当任何用户使用您的应用时，只要该用户授予了必要的权限，系统就会发送 Webhooks。

详细了解访问级别 、应用模式 和应用身份

限制

• 当客户对 Instagram 帖子的轮播广告中的图片留下心情或进行转发时，通知将包含轮播广告中的第一张图片，但这可能并非客户留下心情或转发的图片。
• 当客户发送包含分享内容的消息时，通知中仅包含所分享的媒体或帖子的网址。
• 不支持带动图和贴图的消息。如果用户发送带动图或贴图的消息，这些消息不会触发 Webhooks，系统也不会发送 Webhooks 通知。
• Instagram 影音内容 Webhooks 不支持即阅影音内容（可查看一次，允许重播）。

Webhooks 事件

通知示例

以下是您可以接收的 Webhooks 通知类型的示例。

消息

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGID",  // ID of your Instagram Professional account
      "time": 1569262486134,
      "messaging": [
        {
          "sender": { "id": "IGSID" },    // Instagram-scoped ID for the customer who sent the message
          "recipient": { "id": "IGID" },  // ID of your Instagram Professional account
          "timestamp": 1569262485349,
          "message": {
            "mid": "MESSAGE-ID",   // ID of the message sent to your business
      
            "text": "MESSAGE-TEXT"     // Included when a customer sends a message containing text
      
            "attachments": [           // Included when a customer sends multiple media attachments or a URL for a story mention or share
              {
                "type":"image",             // Can be audio, file, image (image or sticker), share, story_mention, video, ig_reel or reel
                "payload":{ "url":"LINK" }  
              },
              {
                "type":"video",
                "payload":{ "url":"LINK" }
              }
            ]
      
            "is_deleted": true         // Included when a customer deletes a message
      
            "is_echo": true            // Included when your business sends a message to the customer

            "is_unsupported": true,    // Included when a customer sends a message with unsupported media
      
            "quick_reply": {           // Included when a customer clicks a quick reply
              "payload": "CUSTOMER-RESPONSE-PAYLOAD"   // The payload with the option selected by the customer
            },      
      
            "referral": {              // Included when a customer clicks an Instagram Shop product
              "product": {
                "id": "PRODUCT-ID"
            }      
      
            "referral": {                   // Included when a customer clicks an CTD ad
              "ref": "REF-DATA-IN-AD-IF-SPECIFIED"
              "ad_id": AD-ID,
              "source": "ADS",
              "type": "OPEN_THREAD",
              "ads_context_data": {
                "ad_title": TITLE-FOR-THE-AD,
                "photo_url": IMAGE-URL-THAT-WAS-CLICKED,
                "video_url": THUMBNAIL-URL-FOR-THE-AD-VIDEO,
              }
            }

            "reply_to":{               // Included when a customer sends an inline reply
              "mid":"MESSAGE-ID"
            } 
      
            "reply_to": {               // Included when a customer replies to a story
              "story": {
                "url":"CDN-URL",
                "id":"STORY-ID"       
              }
            }
          }
        }
      ]
    }
  ]
}

消息心情

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGID",  // ID for your Instagram Professional account
      "time": 1569262486134,
      "messaging": [
        {
          "sender": {
            "id": "IGSID"  // Instagram-scoped ID for the customer who sent the message
          },
          "recipient": {
            "id": "IGID"  // ID for your Instagram Professional account
          },
          "timestamp": 1569262485349,
          "reaction" :{
            "mid" : "MESSAGE-ID",
            "action": "react",    // or unreact
            "reaction": "love", // optional, to unreact if there is no reaction field
            "emoji": "\u{2764}\u{FE0F}" // optional, to unreact if there is no emoji field
          } 
        }
      ]
    }
  ]
}  

消息回传

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGSID",  // ID of your Instagram Professional account
      "time": 1502905976963,
      "messaging": [
        {
          "sender": { "id": "IGSID" },    // Instagram-scoped ID for the customer who sent the message
          "recipient": { "id": "IGID" },  // ID of your Instagram Professional account
          "timestamp": 1502905976377,
          "postback": {
            "mid":"MESSAGE-ID",           // ID for the message sent to your business
            "title": "SELECTED-ICEBREAKER-REPLY-OR-CTA-BUTTON",
            "payload": "CUSTOMER-RESPONSE-PAYLOAD",  // The payload with the option selected by the customer
          }
        }
      ]
    }
  ]
}

消息推荐

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGSID",  // ID of your Instagram Professional account  
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "IGSID"  // Instagram-scoped ID for the customer who sent the message
          },
          "recipient": {
            "id": "IGID"  // ID of your Instagram Professional account
          },
          "timestamp": 1502905976377,
          "referral": {
                 "ref": "INFORMATION-INCLUDED-IN-REF-PARAMETER-OF-IGME-LINK"
                 "source": "IGME-SOURCE-LINK"  
                 "type":  "OPEN_THREAD"  // Only supported for existing conversations 
          }
        }
      ]
    }
  ]
}
  

消息已被查看

{
   "object":"instagram",
   "entry":[
      {
         "id":"IGID",  // ID for your Instagram Professional account
         "time":1569262486134,
         "messaging":[
            {
               "sender":{
                  "id":"IGSID"  // Instagram-scoped ID for the customer who sent the message
               },
               "recipient":{
                  "id":"IGID"  // ID for your Instagram Professional account
               },
               "timestamp":1569262485349,
               "read":{
                  "mid":"MESSAGE-ID"
               }
            }
         ]
      }
   ]
}

即阅影音内容

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGID",  // ID of your Instagram Professional account
      "time": 1569262486134,
      "messaging": [
        {
          "sender": { "id": "IGSID" },    // Instagram-scoped ID for the customer who sent the message
          "recipient": { "id": "IGID" },  // ID of your Instagram Professional account
          "timestamp": 1569262485349,
          "message": {
            "mid": "MESSAGE-ID",   // ID of the message sent to your business
            "attachments": [
              {
                "type":"ephemeral" // no URL is included for ephemeral media
              }
            ]
          }
        }
      ]
    }
  ]
}

另请参阅

• Messenger 移交协议 – 如果有多个应用处理消息（例如一个应用处理自动回复，一个应用处理向人工客服上报），您需要实现移交协议，才能将对话从一个应用传递到另一个应用。
• Direct 直达广告 (CTD) – 访问 Business 帮助中心，详细了解如何创建 Instagram Direct 直达广告。