开场白

开场白会通过一系列常见问题帮助用户与商家开启对话。通过使用开场白 API，最多可设置 4 个问题。

从 2021 年 10 月 19 日开始，开场白支持本地化，允许商家根据用户的语言设置自定义问题。此 API 将使用新格式，我们建议开发者利用这种新格式来设置和检索开场白的信息。点击此处，可获取支持的语言清单。

设置开场白

新格式（推荐）

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

旧格式（不应用于开场白的新设置）

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

获取开场白

GET 请求将根据开场白的设置方式返回不同的格式。以下行为适用：

• 如果使用旧格式设置开场白，GET 请求将返回旧格式的响应。
• 如果使用新格式设置开场白，GET 请求将返回新格式的响应。

我们鼓励开发者迁移到新格式，因为我们将来会停用旧格式。

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

新格式响应

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

旧格式响应

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

删除开场白

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Webhooks 事件

要从开场白接收回发 Webhook 通知，请确保已在应用设置的已订阅 Instagram 主题下为应用订阅 messaging_postbacks v8.0 及以上版本的 webhook。

Webhooks 将收到一个类似下方示例的 JSON 负载。

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}