แพลตฟอร์ม Messenger

API โปรไฟล์ผู้ใช้

API โปรไฟล์ผู้ใช้ช่วยให้คุณสามารถใช้ ID ใน Instagram (IGSID) เพื่อเรียกดูข้อมูลโปรไฟล์ของลูกค้าได้ คุณสามารถใช้ข้อมูลนี้เพื่อสร้างประสบการณ์ที่เหมาะกับแต่ละบุคคลที่โต้ตอบกับธุรกิจของคุณได้

ความยินยอมของผู้ใช้

ต้องได้รับความยินยอมจากผู้ใช้จึงจะเข้าถึงโปรไฟล์ผู้ใช้ได้ ความยินยอมของผู้ใช้จะตั้งค่าก็ต่อเมื่อมีคนส่งข้อความถึงธุรกิจ หรือคลิกประโยคเริ่มการสนทนาหรือเมนูถาวร หากมีคนแสดงความคิดเห็นในโพสต์หรือในความคิดเห็นแต่ไม่ได้ส่งข้อความถึงธุรกิจ แอพของคุณจะได้รับข้อผิดพลาด "ต้องได้รับความยินยอมจากผู้ใช้จึงจะเข้าถึงโปรไฟล์ผู้ใช้ได้"

ข้อกำหนด

คุณจะต้องมีรายการดังต่อไปนี้

  • สิทธิ์การอนุญาต instagram_basic
  • สิทธิ์การอนุญาต instagram_manage_messages
  • สิทธิ์การอนุญาต pages_manage_metadata
  • สิทธิ์การอนุญาต pages_read_engagement
  • สิทธิ์การอนุญาต pages_show_list
  • โทเค็นการเข้าถึงเพจที่ร้องขอโดยบุคคลที่สามารถดำเนินงาน MODERATE บนเพจได้

ข้อจำกัด

หากลูกค้าบล็อกธุรกิจของคุณไว้ คุณจะไม่สามารถดูข้อมูลของลูกค้าดังกล่าวได้

ช่องโปรไฟล์ผู้ใช้

ช่องโปรไฟล์ต่อไปนี้พร้อมใช้งานสำหรับ API กราฟทุกเวอร์ชั่น

ชื่อช่อง คำอธิบาย

name

สตริง

ชื่อลูกค้า (อาจเป็น Null ได้หากไม่ได้ตั้งค่าชื่อไว้)

profile_pic

url

URL สำหรับรูปโปรไฟล์ของลูกค้า (อาจเป็น Null ได้หากไม่ได้ตั้งค่ารูปโปรไฟล์ไว้) URL จะหมดอายุภายใน 2-3 วัน

ช่องโปรไฟล์ต่อไปนี้พร้อมใช้งานสำหรับ API กราฟเวอร์ชั่น 12.0 ขึ้นไป

ชื่อช่อง คำอธิบาย

is_verified_user

บูลีน

สถานะการตรวจสอบยืนยันสำหรับลูกค้า

follower_count

จำนวนเต็ม

จำนวนผู้ติดตามสำหรับลูกค้า

is_user_follow_business

บูลีน

ระบุว่าลูกค้าติดตามธุรกิจอยู่หรือไม่

is_business_follow_user

บูลีน

ระบุว่าธุรกิจติดตามลูกค้าอยู่หรือไม่

ช่องโปรไฟล์ต่อไปนี้พร้อมใช้งานสำหรับ API กราฟเวอร์ชั่น 14.0 ขึ้นไป

ช่องคำอธิบาย

username

สตริง

ชื่อผู้ใช้สำหรับบัญชี Instagram ของลูกค้า

ตัวอย่าง

หากต้องการเรียกดูข้อมูลโปรไฟล์ของลูกค้า ให้ส่งคำขอ GET ไปยังโหนด ID ใน Instagram สำหรับลูกค้ารายนั้นๆ และใส่ช่องต่างๆ ที่คุณต้องการดูไว้ด้วย

ตัวอย่างคำขอ

จัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

การสนับสนุนสำหรับผู้พัฒนา