การเริ่มต้นใช้งาน

เอกสารนี้จะอธิบายวิธีเรียกใช้การรองรับ Messenger API สำหรับ Instagram (หรือที่ในนโยบายผู้พัฒนาของเราเรียกว่า API การส่งข้อความบน Instagram) ด้วยแอพของคุณและรับข้อความในบัญชีมืออาชีพบน Instagram ให้สำเร็จ เอกสารนี้เหมาะสำหรับผู้ที่คุ้นเคยกับ API กราฟและการเข้าสู่ระบบด้วย Facebook

ก่อนเริ่มต้น

คุณจะต้องมีสิทธิ์การเข้าถึงต่อไปนี้

• บัญชีมืออาชีพบน Instagram
• เพจ Facebook ที่เชื่อมต่อกับบัญชีนั้น
• บัญชีผู้พัฒนา Meta ที่สามารถดำเนินงาน MODERATEในเพจนี้ได้
• แอพ Meta ที่สร้างขึ้นโดยมีกรณีการใช้งานการเข้าสู่ระบบด้วย Facebook และมีการกำหนดค่าการตั้งค่าพื้นฐานไว้

ผู้พัฒนาที่ไม่เคยใช้แพลตฟอร์ม Messenger มาก่อน

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

ผู้พัฒนาที่มีประสบการณ์การใช้งานบนแพลตฟอร์ม Messenger มาก่อน

• โทเค็นการเข้าถึงและ Webhooks มีหลักการคล้ายกัน การรองรับ Messenger API สำหรับ Instagram จะต้องใช้ instagram_manage_messages ในโทเค็นการเข้าถึงเพจและ Webhooks หัวข้อ Instagram ที่ติดตามข้อมูลอยู่
• ฟีเจอร์ส่วนใหญ่จะคล้ายกับ Messenger API ตรวจสอบรายละเอียดเกี่ยวกับรายการฟีเจอร์และนำฟีเจอร์ที่เหมาะสมกับความต้องการของคุณมาใช้

ขั้นตอนการเข้าสู่ระบบ

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

ขั้นตอนการเข้าสู่ระบบธุรกิจสำหรับ Instagram ช่วยให้ผู้ใช้สามารถดำเนินการต่อไปนี้ระหว่างขั้นตอนการเข้าสู่ระบบ

• แปลงบัญชี Instagram ของคุณเป็นบัญชีมืออาชีพบน Instagram
• สร้างเพจ Facebook สำหรับธุรกิจของคุณ
• เชื่อมโยงเพจกับบัญชีมืออาชีพบน Instagram

หากต้องการใช้การเข้าสู่ระบบธุรกิจสำหรับ Instagram ให้ไปที่คู่มือการเข้าสู่ระบบธุรกิจสำหรับ Instagram จากนั้นกลับมาที่คู่มือนี้

1. รับโทเค็นการเข้าถึงผู้ใช้

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

เมื่อคุณเรียกใช้กล่องรับค่าดังกล่าวแล้ว ให้คลิกตกลงเพื่อให้สิทธิ์การอนุญาต instagram_basic, instagram_manage_messages และ pages_manage_metadata แก่แอพของคุณ

API ควรจะส่งคืนโทเค็นการเข้าถึงผู้ใช้ ให้เก็บบันทึกโทเค็นดังกล่าวไว้ เพื่อที่แอพของคุณจะสามารถใช้โทเค็นนั้นเพื่อทำการสืบค้นใน 2-3 ครั้งถัดไปได้ หากคุณกำลังใช้ Graph API Explorer ระบบจะเก็บบันทึกโทเค็นให้โดยอัตโนมัติ และจะแสดงโทเค็นนั้นในช่องโทเค็นการเข้าถึงเพื่อใช้อ้างอิง

2. เรียกดูเพจของผู้ใช้

สืบค้นตำแหน่งข้อมูล GET /me/accounts (ซึ่งจะแปลเป็น GET /{user-id}/accounts โดยดำเนินการ GET บนโหนดผู้ใช้ Facebook ตามโทเค็นการเข้าถึงของคุณ)

curl -i -X GET \
 "https://graph.facebook.com/v9.0/me/accounts?access_token={access-token}"

การดำเนินการนี้ควรส่งคืนคอลเลกชั่นของเพจ Facebook ที่ผู้ใช้ Facebook ปัจจุบันสามารถดำเนินงาน MANAGE, CREATE_CONTENT, MODERATE หรือ ADVERTISE ได้:

{
  "data": [
    {
      "access_token": "EAAJjmJ...",
      "category": "App Page",
      "category_list": [
        {
          "id": "2301",
          "name": "App Page"
        }
      ],
      "name": "Metricsaurus",
      "id": "134895793791914",  // capture the Page ID
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    }
  ]
}

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

3. รับโทเค็นการเข้าถึงเพจ

หากต้องการดำเนินการเรียกใช้ API การส่งข้อความบน Instagram ต่างๆ คุณจะต้องใช้โทเค็นการเข้าถึงเพจ (PAT) ที่เชื่อมโยงอยู่กับบัญชีมืออาชีพบน Instagram ที่เกี่ยวข้อง ซึ่งเคยได้รับมาผ่านขั้นตอนการเข้าสู่ระบบด้วย Facebook ก่อนหน้านี้

ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /{page-id} โดยใช้โทเค็นการเข้าถึงผู้ใช้ของคุณ ตัวอย่างเช่น

curl -i -X GET "https://graph.facebook.com/{page-id}?
  fields=access_token&
  access_token={user-access-token}"  

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

{
  "access_token":"{page-access-token}",
  "id":"{page-id}"              
}  

• หากคุณใช้โทเค็นการเข้าถึงผู้ใช้แบบระยะสั้น โทเค็นการเข้าถึงเพจจะมีอายุเพียง 1 ชั่วโมงเท่านั้น
• หากคุณใช้โทเค็นการเข้าถึงผู้ใช้แบบระยะยาว โทเค็นการเข้าถึงเพจจะไม่มีวันหมดอายุ

ในการสร้างโทเค็นการเข้าถึงเพจแบบใช้งานระยะยาว คุณสามารถปฏิบัติตามคำแนะนำได้ที่นี่

3a. รับโทเค็นการเข้าถึงเพจผ่านเครื่องมือแดชบอร์ดของผู้พัฒนา Instagram

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

4. เปิดใช้งานการตั้งค่าเครื่องมือที่เชื่อมต่อในการควบคุมข้อความ

หากต้องการจัดการข้อความบน Instagram ผ่าน API บัญชีมืออาชีพบน Instagram จะต้องเปิดใช้งานปุ่มเปิดปิดของเครื่องมือที่เชื่อมต่อในการตั้งค่าการควบคุมข้อความ

5. รับอ็อบเจ็กต์กล่องข้อความของบัญชีมืออาชีพบน Instagram

ใช้ ID เพจที่คุณบันทึกไว้และโทเค็นการเข้าถึงเพจ (PAT) เพื่อสืบค้นตำแหน่งข้อมูล GET /{page-id}/conversations?platform=instagram ดังนี้

curl -i -X GET \
 "https://graph.facebook.com/v9.0/17841405822304914/conversations?platform=instagram&access_token={access-token}"  

การดำเนินการนี้ควรส่งคืน ID ของอ็อบเจ็กต์เธรดทั้งหมดบนผู้ใช้ Instagram ดังนี้

{
  "data": [
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTM2MDk5MDc1MzYyOTgx"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTYzMzQ2MzE5NjM1NDcy"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MTk3MTY0NjI2NzAyMjMw"
    },
    {
      "id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6OTAwMTAxNDYyOTkyODI6MzQwMjgyMzY2ODQxNzEwMzAwOTQ5MTI4MzkzNDI5MDYzMzkyNjU0"
    }
}

หากคุณสามารถสืบค้นขั้นสุดท้ายนี้ได้สำเร็จ คุณควรจะสามารถสืบค้นโดยใช้ตำแหน่งข้อมูลการรองรับ Messenger API สำหรับ Instagram ทั้งหมดได้ โดยคุณสามารถดูคำแนะนำและข้อมูลอ้างอิงต่างๆ ของเราเพื่อเรียนรู้ว่าตำแหน่งข้อมูลแต่ละรายการสามารถทำอะไรได้บ้างและต้องได้รับสิทธิ์การอนุญาตใดบ้าง

ขั้นตอนถัดไป

• พัฒนาแอพของคุณไปอีกขั้นเพื่อให้สามารถใช้ตำแหน่งข้อมูลอื่นๆ ที่ต้องการได้สำเร็จ และคอยติดตามสิทธิ์การอนุญาตที่ตำแหน่งข้อมูลแต่ละรายการต้องใช้
• ตั้งค่า Webhook ให้เสร็จสมบูรณ์ เพื่อให้สามารถรับการแจ้งเตือนแบบเรียลไทม์ทุกครั้งที่ผู้ใช้ส่งข้อความไปยังบัญชีมืออาชีพบน Instagram
• ดำเนินการตามขั้นตอนการตรวจสอบแอพให้เสร็จสมบูรณ์ และส่งคำขออนุมัติสิทธิ์การอนุญาตทั้งหมดที่แอพของคุณต้องใช้ เพื่อให้ผู้ใช้แอพของคุณสามารถให้สิทธิ์การอนุญาตดังกล่าวได้ในขณะที่แอพของคุณอยู่ระหว่างการใช้งานจริง