การเชื่อมต่อกับผู้คนทั้งในแอพและ Bot ใน Messenger

เป็นเรื่องปกติที่ธุรกิจจะใช้หลายช่องทางในการสื่อสารกับลูกค้า เช่น เว็บไซต์ แอพมือถือ และ Messenger เมื่อบุคคลใช้การเข้าสู่ระบบด้วย Facebook บนเว็บไซต์หรือแอพมือถือ จะเป็นการสร้าง ID สำหรับแอพ Facebook เฉพาะ ซึ่งจะเรียกว่า ID ในแอพ” เมื่อผู้ใช้โต้ตอบกับธุรกิจผ่าน Messenger จะเป็นการสร้าง ID สำหรับเพจเฉพาะที่เกี่ยวข้องกับ Bot ใน Messenger ซึ่งจะเรียกว่า ID ในเพจ ซึ่งหมายความว่า สำหรับบุคคลเดียวแล้ว ID ในช่องทางการสื่อสารต่างๆ จะไม่เหมือนกัน โปรดทราบว่า ID ในแอพจะถูกสร้างขึ้นเมื่อผู้ใช้เข้าสู่ระบบด้วยแอพของคุณ ดังนั้นคุณจะไม่เห็น ID ในแอพสำหรับผู้ใช้ที่ยังไม่ได้ติดตั้งและลงชื่อเข้าใช้ด้วยแอพของคุณ

ธุรกิจอาจต้องการที่จะมอบประสบการณ์ที่ลื่นไหลตลอดช่องทางต่างๆ แก่ผู้ใช้ ตัวอย่างเช่น เมื่อมีผู้สื่อสารกับธุรกิจผ่าน Bot ใน Messenger บุคคลนั้นอาจได้รับประสบการณ์ที่เป็นส่วนบุคคลยิ่งขึ้นหากธุรกิจทราบว่าบุคคลดังกล่าวเป็นลูกค้าที่มีในแอพ Facebook ของธุรกิจ (เช่น เว็บไซต์หรือแอพมือถือที่มีการเข้าสู่ระบบด้วย Facebook) เราให้ API สำหรับเรียกใช้ ID ของบุคคลเดียวกันในแอพและ Bot ที่อยู่ใน Messenger ซึ่งเป็นเจ้าของเดียวกัน

ก่อนอื่น คุณต้องแจ้งให้ Facebook ทราบว่าแอพและเพจของคุณที่เกี่ยวข้องกับ Bot ใน Messenger มีธุรกิจเดียวกันเป็นเจ้าของ เพื่อแจ้งให้เราทราบ คุณต้องใช้ตัวจัดการธุรกิจของ Facebook เพื่อ:

จากนั้นคุณอาจสืบค้นจุดเชื่อมโยงids_for_appsหรือ ids_for_pagesสำหรับโหนดผู้ใช้เพื่อเรียกใช้ ID

การเรียก API ครั้งแรกอาจทริกเกอร์การตรวจสอบแอพที่อาจใช้เวลาถึงประมาณ 48 ชั่วโมงในการดำเนินการ

เอกสารนี้พูดถึง

กรณีการใช้งาน
การสืบค้นตัวอย่าง
นโยบาย

กรณีการใช้งาน

มีกรณีการใช้งานหลักบางอย่างสำหรับ API นี้

การมอบ ID ผู้ใช้ให้กับ Bot ใน Messenger จะเป็นการเรียกใช้ ID สำหรับแอพของธุรกิจเดียวกัน

โหนดผู้ใช้: ID ที่อยู่ในเพจที่เกี่ยวข้องกับ Bot ใน Messenger
จุดเชื่อมโยง:ids_for_apps
ข้อกำหนด: ต้องมีโทเค็นการเข้าถึงเพจ และ appsecret_proof ซี่งต้องใช้แอพที่จัดการเพจเพื่อสร้างทั้งสองสิ่งนี้ นอกจากนี้ แอพที่จัดการเพจและแอพอื่นๆ ที่เชื่อมต่อต้องมีเจ้าของเป็นธุรกิจเดียวกัน

ตัวอย่าง:

ฟังก์ชั่นนี้จะส่งคืน ID สำหรับแอพทั้งหมดที่มีเจ้าของเป็นธุรกิจเดียวกัน
```
GET /{user-id}/ids_for_apps
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]
```
ฟังก์ชั่นนี้จะคืน ID สำหรับแอพเฉพาะที่มี ID ของแอพ 10152368852405295
```
GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]
```

การมอบ ID ผู้ใช้ให้กับแอพจะเป็นการเรียกใช้ ID สำหรับ Bot ใน Messenger ของธุรกิจเดียวกัน

โหนดผู้ใช้: ID ที่อยู่ในแอพ
จุดเชื่อมโยง:ids_for_pages
ข้อกำหนด: ต้องมีโทเค็นการเข้าถึงหน้าและ appsecret_proof ซี่งต้องใช้แอพที่จัดการเพจและ ID ในแอพเพื่อสร้างรายการทั้งสองนี้ นอกจากนี้ แอพและเพจต้องมีเจ้าของเป็นธุรกิจเดียวกัน

ตัวอย่าง:

ฟังก์ชั่นนี้จะส่งคืน ID สำหรับ Bot ทั้งหมดใน Messenger ที่เกี่ยวข้องกับเพจที่มีเจ้าของเป็นธุรกิจเดียวกัน
```
GET /{user-id}/ids_for_pages
    ?access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]
```
ฟังก์ชั่นนี้จะส่งคืน ID สำหรับ Bot เฉพาะใน Messenger ที่เพจที่เกี่ยวข้องมี ID ของเพจ 380374449010653
```
GET /{user-id}/ids_for_pages
    ?page=380374449010653
    &access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]
```

การมอบ ID ผู้ใช้ให้กับแอพจะเป็นการเรียกใช้ ID สำหรับแอพอื่นๆ ของธุรกิจเดียวกัน

โหนดผู้ใช้: โหนดผู้ใช้คือ ID ที่อยู่ในแอพ
จุดเชื่อมโยง:ids_for_apps
ข้อกำหนด: ฟังก์ชั่นนี้ต้องมีโทเค็นการเข้าถึงแอพ ซึ่งใช้แอพที่มี ID นั้นในการสร้าง นอกจากนี้ แอพต้องมีเจ้าของเป็นธุรกิจเดียวกัน

ตัวอย่าง:

ฟังก์ชั่นนี้จะส่งคืน ID สำหรับแอพทั้งหมดที่มีเจ้าของเป็นธุรกิจเดียวกัน
```
GET /{user-id}/ids_for_apps
    ?access_token=[app_access_token]
```
ฟังก์ชั่นนี้จะคืน ID สำหรับแอพเฉพาะที่มี ID ของแอพ 10152368852405295
```
GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[app_access_token]
```

การมอบ ID ผู้ใช้ให้กับเพจ (ที่เกี่ยวข้องกับ Bot) จะเป็นการเรียกใช้ ID สำหรับเพจอื่นๆ ของธุรกิจเดียวกัน

โหนดผู้ใช้: ID ที่อยู่ในเพจที่เกี่ยวข้องกับ Bot ใน Messenger
จุดเชื่อมโยง:ids_for_pages
ข้อกำหนด: ต้องมีโทเค็นการเข้าถึงเพจ และ appsecret_proof ซี่งต้องใช้แอพที่จัดการเพจเพื่อสร้างทั้งสองสิ่งนี้ นอกจากนี้ เพจต้องมีเจ้าของเป็นธุรกิจเดียวกัน

ตัวอย่าง:

ฟังก์ชั่นนี้จะส่งคืน ID สำหรับเพจทั้งหมดที่มีเจ้าของเป็นธุรกิจเดียวกัน
```
GET /{user-id}/ids_for_pages
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]
```
ฟังก์ชั่นนี้จะคืน ID สำหรับเพจเฉพาะที่มี ID ของแอพ 380374449010653
```
GET /{user-id}/ids_for_pages
    ?app=380374449010653
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]
```

การสืบค้นตัวอย่าง

เรียกใช้ ID ที่เกี่ยวข้องจาก ID สำหรับแอพ

GET /{user-id}
    ?fields=name,age_range,ids_for_apps,ids_for_pages
    &access_token=[app_access_token]

ตัวอย่างการตอบกลับ

{
  "name": "John Smith",
  "age_range": {
    "min": 21
  },
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

เรียกใช้ ID ที่เกี่ยวข้องจาก ID สำหรับ Bot ใน Messenger

GET /{user-id}
    ?fields=name,is_payment_enabled,ids_for_apps,ids_for_pages
    &access_token=[page_access_token]
    &appsecret_proof=[appsecrete_proof]

ตัวอย่างการตอบกลับ

{
  "name": "John Smith",
  "is_payment_enabled": true,
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

นโยบาย

ธุรกิจอาจใช้ API เพื่อเชื่อมต่อ ID กับแอพหรือเพจของธุรกิจกับแอพหรือเพจอื่นที่มีเจ้าของและได้รับการดูแลในนามของธุรกิจเดียวกัน ตัวอย่างเช่น ผู้ให้บริการอาจไม่ใช้ API เพื่อสนับสนุนลูกค้าหลายราย

สำหรับการละเมิดนโยบายนี้ที่อาจเกิดขึ้น คำขอ API ขอคุณจะอยู่ภายใต้การพิจารณาและส่งคืนข้อความแสดงข้อผิดพลาด “(#200) ธุรกิจของคุณกำลังได้รับการพิจารณาเพื่อเข้าถึง API นี้”