การสร้าง
สร้างและส่งข้อความถึงลูกค้าหรือผู้ที่สนใจเพจ 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จำเป็น | ประเภทของข้อความที่ส่ง RESPONSE – ข้อความใช้สำหรับตอบกลับข้อความที่ได้รับ ซึ่งรวมถึงข้อความส่งเสริมการขายและข้อความที่ไม่ใช่การส่งเสริมการขายที่ส่งภายใน กรอบเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมง ตัวอย่างเช่น ใช้แท็กนี้ในการตอบกลับหากมีบุคคลใดขอให้มีการยืนยันการจองหรือการอัพเดตสถานะ
|
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 ใช้งานไม่ได้สำหรับสิทธิ์การเข้าถึงแบบมาตรฐานหรือโหมดการพัฒนา คุณจะต้องดำเนินกระบวนการตรวจสอบแอพให้เสร็จสิ้นก่อนจึงจะสามารถใช้ประโยชน์จากแท็กเจ้าหน้าที่ที่เป็นมนุษย์ได้ ในระหว่างที่ส่งคำขอเพื่อตรวจสอบแอพ โปรดระบุคำแนะนำที่ชัดเจนและอธิบายวิธีที่คุณประสงค์จะใช้ประโยชน์จากแท็กเจ้าหน้าที่ที่เป็นมนุษย์ในการใช้งานของคุณ POST_PURCHASE_UPDATE – แท็กข้อความที่คุณจะส่งถึงลูกค้าให้เป็นการอัพเดตสำหรับการซื้อล่าสุดของลูกค้า ดูการใช้งานที่อนุญาต ไม่พร้อมใช้งานสำหรับ API การส่งข้อความของ Instagram
|
การใช้แท็กข้อความ
ตารางต่อไปนี้แสดงประเภทของการส่งข้อความสำหรับแต่ละแท็กข้อความ
การใช้ | แท็กข้อความ | ACCOUNT_UPDATE
| การใช้งานที่อนุญาตการใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)เนื้อหาส่งเสริมการขาย รวมถึงแต่ไม่จำกัดเพียงดีล, โปรโมชั่น, คูปอง และส่วนลด เนื้อหาประจำ (เช่น ใบแจ้งยอดพร้อมแล้ว ใบเรียกเก็บเงินถึงกำหนดชำระ มีประกาศงานใหม่) พร้อมท์ไปยังแบบสำรวจ โพลล์ หรือการรีวิวใดๆ ที่ไม่เกี่ยวข้องกับการโต้ตอบก่อนหน้านี้ใน Messenger
ไม่พร้อมใช้งานสำหรับ API การส่งข้อความของ Instagram |
CONFIRMED_EVENT_UPDATE
| การใช้งานที่อนุญาตการเตือนความจำสำหรับชั้นเรียน การนัดหมาย หรืองานกิจกรรมที่ผู้ใช้กำหนดเวลาไว้และกำลังจะมาถึง การยืนยันการจองหรือการเข้าร่วมของผู้ใช้ต่องานกิจกรรมหรือการนัดหมายที่ผู้ใช้ตอบรับ การแจ้งเตือนเกี่ยวกับการโดยสารหรือการเดินทางที่กำหนดเวลาไว้ของผู้ใช้ เช่น การมาถึง, การยกเลิก, สัมภาระล่าช้า หรือการเปลี่ยนแปลงสถานะการเดินทางอื่นๆ
การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)เนื้อหาส่งเสริมการขาย รวมถึงแต่ไม่จำกัดเพียงดีล, ข้อเสนอ, คูปอง และส่วนลด เนื้อหาที่เกี่ยวข้องกับงานกิจกรรมที่ผู้ใช้ไม่ได้สมัครเข้าร่วม (เช่น การเตือนความจำให้ซื้อตั๋วสำหรับงานกิจกรรม, การขายพ่วงงานกิจกรรมอื่น, แผนการทัวร์ ฯลฯ) ข้อความที่เกี่ยวข้องกับงานกิจกรรมในอดีต พร้อมท์ไปยังแบบสำรวจ โพลล์ หรือการรีวิวใดๆ ที่ไม่เกี่ยวข้องกับการโต้ตอบก่อนหน้านี้ใน Messenger
ไม่พร้อมใช้งานสำหรับ API การส่งข้อความของ Instagram |
CUSTOMER_FEEDBACK
| การใช้งานที่อนุญาตการใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)ไม่พร้อมใช้งานสำหรับ API การส่งข้อความของ Instagram |
HUMAN_AGENT
| การใช้งานที่อนุญาตการใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)จำเป็นสำหรับ API การส่งข้อความของ Instagram |
POST_PURCHASE_UPDATE
| การใช้งานที่อนุญาตการยืนยันธุรกรรม เช่น ใบเรียกเก็บเงินหรือใบเสร็จรับเงิน การอัพเดตสถานะสำหรับการจัดส่ง เช่น สินค้าอยู่ระหว่างการขนส่ง, จัดส่งแล้ว, ส่งมอบแล้ว หรือล่าช้า การอัพเดตสถานะที่ต้องให้ผู้ใช้ดำเนินการกับคำสั่งซื้อของผู้ใช้ เช่น บัตรเครดิตถูกปฏิเสธ สินค้าค้างส่ง หรือการอัพเดตคำสั่งซื้ออื่นๆ ที่ต้องให้ผู้ใช้ดำเนินการ
การใช้งานที่ไม่ได้รับอนุญาต (ตัวอย่างบางส่วน)เนื้อหาส่งเสริมการขาย รวมถึงแต่ไม่จำกัดเพียงดีล, โปรโมชั่น, คูปอง และส่วนลด ข้อความที่ขายพ่วงหรือต่อยอดการขายสินค้าหรือบริการ พร้อมท์ไปยังแบบสำรวจ โพลล์ หรือการรีวิวใดๆ ที่ไม่เกี่ยวข้องกับการโต้ตอบก่อนหน้านี้ใน Messenger
ไม่พร้อมใช้งานสำหรับ API การส่งข้อความของ Instagram |