ส่งข้อความ

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

องค์ประกอบของข้อความ

คำขอ API การส่งทั้งหมดจากแอพของคุณในการส่งข้อความนั้นจะต้องมีสิ่งต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับองค์ประกอบของข้อความที่ข้อมูลอ้างอิงเกี่ยวกับ API การส่ง

ช่วงเวลาการส่งข้อความมาตรฐาน

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

ข้อความที่ส่งภายในช่วงเวลา 24 ชั่วโมงนี้อาจมีเนื้อหาส่งเสริมการขายได้

การดำเนินการของผู้ใช้ที่เป็นการเริ่มนับช่วงเวลาการส่งข้อความมาตรฐาน

ระบบจะเริ่มนับช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมงเมื่อผู้ใช้ดำเนินการดังต่อไปนี้

• ผู้ใช้ส่งข้อความถึงเพจหรือบัญชีมืออาชีพบน Instagram ของคุณ
• ผู้ใช้คลิกปุ่มกระตุ้นให้ดำเนินการ เช่น "เริ่มต้นใช้งาน" ภายในการสนทนา
• ผู้ใช้คลิกโฆษณาแบบคลิกไปยัง Messenger แล้วส่งข้อความถึงเพจหรือบัญชีมืออาชีพบน Instagram ของคุณ
• ผู้ใช้ส่งข้อความถึงเพจผ่านปลั๊กอิน เช่น ปลั๊กอิน "ส่งไปยัง Messenger" หรือปลั๊กอินกล่องกาเครื่องหมาย
• ผู้ใช้คลิกลิงก์ m.me ซึ่งนำไปยังการสนทนาที่มีอยู่ระหว่างผู้ใช้รายนั้นๆ กับเพจ
• ผู้ใช้คลิกลิงก์ ig.me ซึ่งนำไปยังการสนทนาที่มีอยู่ระหว่างผู้ใช้รายนั้นๆ กับบัญชีมืออาชีพบน Instagram
• ผู้ใช้แสดงความรู้สึกต่อข้อความ เช่น ข้อความทางการตลาด
• ผู้ใช้แสดงความคิดเห็นต่อโพสต์บนเพจหรือบัญชีมืออาชีพบน Instagram ของคุณ
• ผู้ใช้เผยแพร่โพสต์ของผู้เข้าชมบนเพจของคุณ

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

ID ผู้รับ

ID ของผู้ใช้ที่รับข้อความจะได้รับการตั้งค่าในพารามิเตอร์อ็อบเจ็กต์ recipient และอาจเป็น ID ประเภทใดประเภทหนึ่งดังต่อไปนี้

• ID ในเพจ (PSID) – ID ที่กำหนดให้กับผู้ใช้ในครั้งแรกที่ผู้ใช้รายนั้นส่งข้อความถึงเพจของคุณ โดย ID ที่ไม่ซ้ำกันนี้จะแสดงถึงการโต้ตอบระหว่างเพจของคุณกับผู้ใช้รายดังกล่าว

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

• ID โพสต์หรือความคิดเห็น: ID ที่กำหนดให้กับผู้ใช้ที่เผยแพร่โพสต์บนเพจของคุณหรือแสดงความคิดเห็นต่อโพสต์ โดยจะใช้เพื่อส่งข้อความตอบกลับแบบส่วนตัวให้กับผู้ใช้รายดังกล่าว

โปรดทราบว่า ID ผู้ใช้จากการผสานการทำงานการเข้าสู่ระบบด้วย Facebook จะเป็น ID ในแอพ และจะไม่สามารถใช้ได้กับแพลตฟอร์ม Messenger

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

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

ระบบรองรับข้อความประเภทต่างๆ ดังนี้

• การตอบกลับ – ข้อความที่คุณกำลังส่งนั้นเป็นการตอบกลับข้อความที่ได้รับมา ข้อความดังกล่าวจะมีเนื้อหาส่งเสริมการขายและเนื้อหาที่ไม่ใช่การส่งเสริมการขายได้ แต่จะต้องส่งภายในช่วงเวลาการส่งข้อความมาตรฐาน

• ข้อมูลอัพเดต – ข้อความที่คุณกำลังส่งนั้นได้รับการส่งในเชิงรุก และไม่ใช่การตอบกลับข้อความที่ได้รับมา ข้อความดังกล่าวจะมีเนื้อหาส่งเสริมการขายและเนื้อหาที่ไม่ใช่การส่งเสริมการขายได้ แต่จะต้องส่งภายในช่วงเวลาการส่งข้อความมาตรฐาน

• ข้อความที่ได้รับการแท็ก – ข้อความที่คุณกำลังส่งนั้นมีการส่งนอกช่วงเวลาการส่งข้อความมาตรฐาน ข้อความนี้จะต้องมีแท็กข้อความที่ตรงกับกรณีการใช้งานที่อนุญาตสำหรับแท็กนั้นๆ และมีเนื้อหาที่ไม่ใช่การส่งเสริมการขาย

แท็กข้อความ

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

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

ธุรกิจที่ใช้แพลตฟอร์ม Messenger และต้องการส่งข้อความส่งเสริมการขายนอกช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมงควรใช้ข้อความที่ได้รับการสนับสนุนหรือการแจ้งเตือนแบบครั้งเดียว

ประเภทเนื้อหา

ข้อความที่คุณส่งสามารถมีเนื้อหาประเภทต่างๆ ได้ดังนี้

ส่งข้อความพื้นฐาน

หากต้องการส่งข้อความพื้นฐานให้กับผู้ใช้ที่ส่งข้อความถึงเพจของคุณ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages โดยตั้งค่า id ของคีย์ Literal สำหรับอ็อบเจ็กต์ recipient เป็น ID ในเพจ (PSID) ของผู้ใช้ ตั้งค่าพารามิเตอร์ message_type เป็น RESPONSE และตั้งค่าอ็อบเจ็กต์ text ของพารามิเตอร์ message เป็นเนื้อความของข้อความนั้นๆ

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"{PSID}"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v24.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

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

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

ส่งไฟล์แนบที่เป็นสื่อ

หากต้องการส่งข้อความพร้อมสื่อ เช่น GIF หรือรูปภาพ หรือเทมเพลต คุณจะเพิ่มเนื้อหาลงในคำขอ API ในอ็อบเจ็กต์ไฟล์แนบของข้อความแบบ JSON

หากต้องการส่งข้อความพร้อมรูปภาพให้กับผู้ใช้ที่ส่งข้อความถึงเพจของคุณ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages โดยตั้งค่า id ของคีย์ Literal สำหรับอ็อบเจ็กต์ recipient เป็น ID ในเพจ (PSID) ของผู้ใช้ ตั้งค่าพารามิเตอร์ message_type เป็น RESPONSE และตั้งค่าคีย์ type สำหรับอ็อบเจ็กต์ attachment ของพารามิเตอร์ message เป็น image รวมถึงตั้งค่าคีย์ url สำหรับอ็อบเจ็กต์ payload เป็น URL สำหรับรูปภาพนั้นๆ

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

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

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

การส่งเสียง วิดีโอ หรือไฟล์จาก URL จะใช้รูปแบบเดียวกันนี้

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

ส่งไฟล์แนบที่เป็นสื่อหลายไฟล์

หากต้องการส่งข้อความพร้อมรูปภาพหลายไฟล์ ให้คุณเพิ่มเนื้อหาในคำขอ API ในอาร์เรย์ไฟล์แนบของข้อความแบบ JSON สื่อประเภทเดียวที่อนุญาตให้ใช้ได้คือรูปภาพ และจำกัดให้ส่งพร้อมกันได้คราวละ 30 รูปภาพ

หากต้องการส่งข้อความพร้อมรูปภาพหลายไฟล์ให้กับผู้ใช้ที่ส่งข้อความถึงเพจของคุณ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages โดยตั้งค่า id ของคีย์ Literal สำหรับอ็อบเจ็กต์ recipient เป็น ID ในเพจ (PSID) ของผู้ใช้ ตั้งค่าพารามิเตอร์ message_type เป็น RESPONSE และให้พารามิเตอร์ message มีอาร์เรย์ attachments โดยที่ตั้งค่าคีย์ type สำหรับอ็อบเจ็กต์ไฟล์แนบแต่ละรายการให้เป็น image รวมถึงตั้งค่าคีย์ url สำหรับอ็อบเจ็กต์ payload เป็น URL สำหรับรูปภาพนั้นๆ

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

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

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

ส่งการตอบกลับไปยังข้อความ

หากต้องการส่งการตอบกลับไปยังข้อความในอดีตบางข้อความภายในแชท ให้ส่งคำขอ POST ไปที่ /PAGE-ID/messages โดยดำเนินการดังต่อไปนี้

• ตั้งค่า id ของคีย์ Literal สำหรับอ็อบเจ็กต์ recipient เป็น ID ในเพจ (PSID) ของผู้ใช้
• ตั้งค่า message_type เป็น RESPONSE
• รายละเอียดข้อความของคุณในอ็อบเจ็กต์พารามิเตอร์ข้อความ
• ตั้งค่า mid ของคีย์ Literal สำหรับอ็อบเจ็กต์ reply_to เป็น ID ข้อความของข้อความในแชทที่คุณต้องการตอบกลับ

โดยอาจเป็นข้อความที่เพจของคุณหรือผู้ใช้ส่งมาก็ได้

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "{PSID}",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

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

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

หลักปฏิบัติที่ดีที่สุด

ข้อความตัวอักษร

ไฟล์แนบ

ประเภทข้อความเพิ่มเติม

ข้อความทางการตลาด

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

การส่งข้อความข่าว (อยู่ระหว่างการพัฒนา)

การส่งข้อความข่าวจะพร้อมใช้งานสำหรับผู้เผยแพร่ข่าวที่ลงทะเบียนแล้วเท่านั้น ซึ่งลงทะเบียนไว้กับดัชนีเพจข่าวบน Facebook (NPI) การส่งข้อความข่าวจะช่วยให้ผู้เผยแพร่ข่าวสามารถส่งข้อความข่าวที่ไม่เป็นการส่งเสริมการขายให้กับผู้ใช้ที่ได้สมัครรับข้อความเหล่านี้ไว้ได้

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

การแจ้งเตือนแบบครั้งเดียว

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

การแจ้งเตือนแบบครั้งเดียวไม่พร้อมใช้งานสำหรับ API การส่งข้อความบน Instagram

ข้อความตอบกลับแบบส่วนตัว

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

ข้อความที่ได้รับการสนับสนุน

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

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

ข้อความยูทิลิตี้

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

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

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

เรียนรู้เพิ่มเติม

เรียนรู้เพิ่มเติมเกี่ยวกับการส่งข้อความโดยใช้แพลตฟอร์ม Messenger

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