ข้อมูลอ้างอิง Send API

Send 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 -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
    ?recipient={'id':'PSID'}
    &messaging_type=RESPONSE
    &message={'text':'hello,world'}
    &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 ต้องมีความยาวน้อยกว่า 1,000 อักขระ

  • quick_replies – ข้อความตอบกลับด่วนต่างๆ ที่จะส่งในข้อความ
  • text – ข้อความที่มีเพียงตัวอักษรเท่านั้น ต้องเป็น UTF-8 และมีความยาวน้อยกว่า 2,000 อักขระ

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 ใช้งานไม่ได้สำหรับสิทธิ์การเข้าถึงแบบมาตรฐานหรือโหมดการพัฒนา คุณจะต้องดำเนินกระบวนการตรวจสอบแอพให้เสร็จสิ้นก่อนจึงจะสามารถใช้ประโยชน์จากแท็กเจ้าหน้าที่ที่เป็นมนุษย์ได้ ในระหว่างที่ส่งคำขอเพื่อตรวจสอบแอพ โปรดระบุคำแนะนำที่ชัดเจนและอธิบายวิธีที่คุณประสงค์จะใช้ประโยชน์จากแท็กเจ้าหน้าที่ที่เป็นมนุษย์ในการใช้งานของคุณ

  • 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

การอ่าน

คุณไม่สามารถทำการดำเนินการนี้บนปลายทางนี้ได้

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

การอัพเดต

คุณไม่สามารถทำการดำเนินการนี้บนปลายทางนี้ได้

การลบ

คุณไม่สามารถทำการดำเนินการนี้บนปลายทางนี้ได้

ดูเพิ่มเติม

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