แพลตฟอร์ม Messenger

ข้อมูลอ้างอิงเกี่ยวกับ API การส่ง

API การส่งคือ API หลักที่ใช้ในการส่งข้อความถึงผู้ใช้ ซึ่งรวมถึงข้อความ ไฟล์แนบ เทมเพลต การดำเนินการของผู้ส่ง และอื่นๆ

การสร้าง

สร้างและส่งข้อความไปยังลูกค้าหรือผู้ที่สนใจเพจ Facebook ของคุณ

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

คุณจำเป็นต้องมีดังต่อไปนี้

  • โทเค็นการเข้าถึงเพจที่ขอโดยผู้ที่สามารถดำเนินงาน MESSAGE บนเพจได้
  • สิทธิ์การอนุญาต pages_messaging
  • ผู้รับข้อความจะต้องส่งข้อความถึงเพจของคุณภายใน 24 ชั่วโมงที่ผ่านมา หรือตกลงที่จะรับข้อความจากเพจของคุณนอกช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมง

ข้อจำกัด

  • คุณจะไม่สามารถใช้แท็กข้อความเพื่อส่งเนื้อหาส่งเสริมการขายได้

โปรดทราบว่า API การส่งจะไม่มี recipient_id รวมอยู่ในการตอบกลับสำหรับข้อความต่างๆ ที่ส่งโดยใช้ recipient.user_ref หรือ recipient.phone_number เพื่อระบุผู้รับข้อความ

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

หากต้องการส่งข้อความถึงผู้ใช้ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messsages พร้อมทั้งตั้งค่าพารามิเตอร์ messaging_type และ recipient ไว้และมีเนื้อหาข้อความด้วย

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย

ตัวอย่างต่อไปนี้เป็นการตอบกลับข้อความของผู้ใช้โดยที่ข้อความที่เพจของคุณส่งนั้นมีเฉพาะตัวอักษร

curl -X POST "https://graph.facebook.com/v21.0/{PAGE_ID}/messages" \
      -d "recipient={'id':'{PSID}'}" \
      -d "messaging_type=RESPONSE" \
      -d "message={'text':'hello, world'}" \
      -d "access_token={PAGE_ACCESS_TOKEN}"

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

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
}

พารามิเตอร์

พารามิเตอร์คำอธิบาย

message

อ็อบเจ็กต์

ประเภทของข้อความที่เพจของคุณกำลังส่ง โดยต้องตั้งค่า text หรือ attachement เมื่อใช้พารามิเตอร์นี้

  • อ็อบเจ็กต์ attachment – ดูตัวอย่าง URL ใช้เพื่อส่งข้อความที่มีสื่อหรือข้อความที่มีการจัดโครงสร้าง และต้องตั้งค่า text หรือ attachment

  • metadata – สตริงข้อมูลเพิ่มเติมที่คุณต้องการส่งใน Webhook message_echo จำนวนอักขระต้องไม่เกิน 1000 ตัว

  • quick_replies – อาร์เรย์ของข้อความตอบกลับด่วนที่จะส่งในข้อความ
  • text – ข้อความที่มีเฉพาะตัวอักษรเท่านั้น ต้องเป็น UTF-8 และจำนวนอักขระต้องไม่เกิน 2000 ตัว

messaging_type

enum

จำเป็นต้องระบุ

ประเภทข้อความที่กำลังส่ง

notification_type

enum

ประเภทของการแจ้งเตือนแบบพุชที่ผู้ใช้จะได้รับ

  • NO_PUSH – ไม่มีการแจ้งเตือน
  • REGULAR (ค่าเริ่มต้น) – เสียงหรือการสั่นเมื่อผู้ใช้ได้รับข้อความ
  • SILENT_PUSH – การแจ้งเตือนบนหน้าจอเท่านั้น

recipient

อ็อบเจ็กต์

จำเป็นต้องระบุ

ผู้ที่จะได้รับข้อความที่เพจของคุณกำลังส่ง

  • id – ID ในเพจสำหรับผู้ใช้ที่ใช้เพื่อส่งข้อความตอบกลับข้อความที่เพจของคุณได้รับภายใน 24 ชั่วโมงที่ผ่านมา หรือสำหรับผู้ที่ตกลงรับข้อความจากเพจของคุณนอกช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมง
  • user_ref – ข้อมูลอ้างอิงสำหรับผู้ใช้ที่ใช้เพื่อส่งข้อความตอบกลับกล่องกาเครื่องหมายหรือปลั๊กอินแชทของลูกค้า
  • comment_id – ID สำหรับความคิดเห็นที่ใช้เพื่อส่งข้อความโดยเป็นการตอบกลับแบบส่วนตัวเพื่อตอบกลับความคิดเห็นของผู้เข้าชมบนโพสต์บนเพจ
  • post_id – ID สำหรับโพสต์บนเพจที่ใช้เพื่อส่งข้อความโดยเป็นการตอบกลับแบบส่วนตัวเพื่อตอบกลับโพสต์ของผู้เข้าชมบนเพจของคุณ

sender_action

enum

ไอคอนการดำเนินการที่แสดงในหน้าต่างการส่งข้อความ ซึ่งแสดงถึงการดำเนินการที่เพจได้ทำกับข้อความที่เพจได้รับจากผู้ใช้

  • typing_on – แสดงบับเบิลที่บ่งบอกว่ากำลังพิมพ์ในขณะที่เพจกำลังเขียนข้อความตอบกลับ
  • typing_off – ไม่แสดงบับเบิลที่บ่งบอกว่ากำลังพิมพ์
  • mark_seen – แสดงไอคอนที่บ่งบอกว่าเห็นแล้วสำหรับข้อความที่เพจเห็นแล้ว

สามารถส่งด้วยพารามิเตอร์ recipient เท่านั้น ไม่สามารถส่งด้วยพารามิเตอร์ message แต่ต้องส่งเป็นคำขอแยกต่างหาก

tag

enum

แท็กที่ช่วยให้เพจของคุณสามารถส่งข้อความไปยังผู้ใช้นอกช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมงได้

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

    ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

  • CONFIRMED_EVENT_UPDATE – แท็กข้อความที่คุณส่งถึงลูกค้าโดยเป็นการเตือนความจำเกี่ยวกับกิจกรรมที่กำลังจะจัดขึ้นหรือเป็นข้อมูลอัพเดตสำหรับกิจกรรมที่กำลังดำเนินอยู่ซึ่งลูกค้าได้ลงทะเบียนไว้ ดูการใช้งานที่อนุญาต

    ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

  • CUSTOMER_FEEDBACK – แท็กข้อความที่คุณส่งถึงลูกค้าโดยเป็นแบบสำรวจความเห็นของลูกค้า ทั้งนี้ ต้องส่งแบบสำรวจความเห็นของลูกค้าภายใน 7 วันนับจากข้อความสุดท้ายของลูกค้า ดูการใช้งานที่อนุญาต

    ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

  • HUMAN_AGENT – จำเป็นต้องระบุสำหรับ API การส่งข้อความบน Instagram เมื่อเพิ่มแท็กนี้ในข้อความที่ส่งถึงผู้ใช้ จะช่วยให้เจ้าหน้าที่สามารถตอบกลับข้อความของผู้ใช้ได้ โดยสามารถส่งข้อความได้ภายใน 7 วันนับจากที่ผู้ใช้ส่งข้อความมา ความช่วยเหลือจากเจ้าหน้าที่มีไว้สำหรับปัญหาที่ไม่สามารถแก้ไขได้ภายในช่วงเวลาการส่งข้อความมาตรฐาน ดูการใช้งานที่อนุญาต
    • แอพจะต้องขอสิทธิ์การอนุญาต Human Agent ผ่านแดชบอร์ดของแอพสำหรับผู้พัฒนา ไปที่แดชบอร์ดของแอพ -> การตรวจสอบแอพ -> สิทธิ์การอนุญาตและฟีเจอร์ -> เจ้าหน้าที่ แอพที่ได้รับการอนุมัติก่อนหน้านี้ให้เข้าถึงสิทธิ์การอนุญาต Human Agent ในขั้นเบต้าได้จะไม่จำเป็นต้องยื่นขอสิทธิ์การเข้าถึงอีกครั้ง

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

  • POST_PURCHASE_UPDATE – แท็กข้อความที่คุณส่งถึงลูกค้าว่าเป็นข้อมูลอัพเดตเกี่ยวกับการซื้อครั้งล่าสุดของลูกค้า ดูการใช้งานที่อนุญาต

    ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

การใช้งานแท็กข้อความ

ตารางต่อไปนี้แสดงรายการประเภทการส่งข้อความสำหรับแต่ละแท็กข้อความ

แท็กข้อความการใช้งาน

ACCOUNT_UPDATE

การใช้งานที่อนุญาต

  • การแจ้งเตือนการเปลี่ยนแปลงสถานะของการสมัคร เช่น การสมัครบัตรเครดิตหรือการสมัครงาน
  • การแจ้งเตือนกิจกรรมที่น่าสงสัย เช่น การแจ้งเตือนการฉ้อโกง

การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)

  • เนื้อหาส่งเสริมการขาย รวมถึงแต่ไม่จำกัดเพียงดีล, โปรโมชั่น, คูปอง และส่วนลด เนื้อหาประจำ (เช่น ใบแจ้งยอดพร้อมแล้ว ใบเรียกเก็บเงินถึงกำหนดชำระ มีประกาศงานใหม่)
  • แจ้งให้ทำแบบสำรวจ โพลล์ หรือรีวิวใดๆ ที่ไม่เกี่ยวข้องกับการโต้ตอบที่มีมาก่อนหน้านี้ใน Messenger

ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

CONFIRMED_EVENT_UPDATE

การใช้งานที่อนุญาต

  • การเตือนความจำเกี่ยวกับชั้นเรียน การนัดหมาย หรืองานกิจกรรมที่กำลังจะมาถึงซึ่งผู้ใช้นัดหมายเวลาไว้
  • การยืนยันการจองของผู้ใช้หรือการเข้าร่วมงานกิจกรรมหรือการนัดหมายที่ผู้ใช้ได้ตอบรับ
  • การแจ้งเตือนการเดินทางหรือกำหนดการเดินทางของผู้ใช้ เช่น การมาถึง การยกเลิก สัมภาระล่าช้า หรือการเปลี่ยนแปลงสถานะการเดินทางอื่นๆ

การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)

  • เนื้อหาเพื่อการโปรโมท ซึ่งรวมถึงแต่ไม่จำกัดเพียงดีล ข้อเสนอ คูปอง และส่วนลด
  • เนื้อหาที่เกี่ยวข้องกับงานกิจกรรมที่ผู้ใช้ไม่ได้ลงทะเบียนไว้ (เช่น การเตือนให้ซื้อตั๋วงานกิจกรรม การขายพ่วงสินค้าของงานกิจกรรมอื่นๆ ตารางทัวร์ ฯลฯ)
  • ข้อความที่เกี่ยวข้องกับงานกิจกรรมที่ผ่านมา
  • แจ้งให้ทำแบบสำรวจ โพลล์ หรือรีวิวใดๆ ที่ไม่เกี่ยวข้องกับการโต้ตอบที่มีมาก่อนหน้านี้ใน Messenger

ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

CUSTOMER_FEEDBACK

การใช้งานที่อนุญาต

  • แบบสำรวจความเห็นเกี่ยวกับฝ่ายสนับสนุนการซื้อ
  • แบบสำรวจความเห็นเกี่ยวกับงานกิจกรรม
  • รีวิวสินค้า

การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)

  • สามารถใช้แท็กได้กับเทมเพลตความเห็นของลูกค้าเท่านั้น ห้ามใช้ในรูปแบบอื่นใดและการใช้นั้นจะล้มเหลว

ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

HUMAN_AGENT

การใช้งานที่อนุญาต

  • ความช่วยเหลือจากเจ้าหน้าที่สำหรับปัญหาที่ไม่สามารถแก้ไขได้ภายในช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมง เช่น การแก้ไขปัญหานอกเวลาทำการปกติ หรือปัญหาต้องใช้เวลามากกว่า 24 ชั่วโมงในการแก้ไข

การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)

  • ข้อความอัตโนมัติ
  • เนื้อหาที่ไม่เกี่ยวข้องกับคำถามของผู้ใช้

จำเป็นต้องระบุสำหรับ API การส่งข้อความบน Instagram

POST_PURCHASE_UPDATE

การใช้งานที่อนุญาต

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

การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)

  • เนื้อหาเพื่อการโปรโมท ซึ่งรวมถึงแต่ไม่จำกัดเพียงดีล โปรโมชั่น คูปอง และส่วนลด
  • ข้อความที่ขายพ่วงสินค้าหรือต่อยอดการขายสินค้าหรือบริการ
  • แจ้งให้ทำแบบสำรวจ โพลล์ หรือรีวิวที่ไม่เกี่ยวข้องกับการโต้ตอบที่มีมาก่อนหน้านี้ใน Messenger

ไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

การอ่าน

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

หากต้องการข้อมูลเกี่ยวกับการสนทนาที่เพจของคุณมีส่วนร่วม โปรดไปที่ข้อมูลอ้างอิงเกี่ยวกับการสนทนาของเพจ

การอัพเดต

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

การลบ

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

ดูเพิ่มเติม

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