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

คุณสามารถใช้โหนด messages เพื่อส่งข้อความตัวอักษรถึงลูกค้าได้

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

คุณต้องปฏิบัติตามข้อกำหนดเบื้องต้นที่ระบุไว้ในส่วน "ก่อนเริ่มต้น" ของเอกสารประกอบเกี่ยวกับข้อความให้ครบถ้วน

ข้อจำกัด:

• ข้อความตัวอักษรมีจำนวนอักขระได้สูงสุด 4,096 ตัว

ขั้นตอนที่ 1: ส่งคำขอ POST ไปยัง /messages

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

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ที่หัวข้อต่อไปนี้

• พารามิเตอร์ที่พบบ่อยสำหรับคำขอส่งข้อความทั้งหมด
• พารามิเตอร์สำหรับข้อความตัวอักษร

หากคุณต้องการจัดรูปแบบข้อความ โปรดดูที่การจัดรูปแบบข้อความตัวอักษร

การส่ง URL ในข้อความตัวอักษร

แอพพลิเคชั่น WhatsApp บนมือถือจะจำแนก URL และทำให้ URL คลิกได้ หากต้องการใส่พรีวิว URL ให้ใส่ "preview_url": true ในเนื้อความของข้อความและตรวจสอบให้แน่ใจว่า URL ขึ้นต้นด้วย http:// หรือ https:// โดยต้องระบุชื่อโฮสต์ เนื่องจากที่อยู่ IP ไม่ตรงกัน

โปรดทราบว่าการใช้ preview_url ในจุดนี้จะต่างจาก API ระบบคลาวด์ โปรดดูเอกสารประกอบของ API ระบบคลาวด์ในส่วนข้อความ

ตัวอย่าง

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

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

ระบบจะแสดงพรีวิว URL หลังจากที่เกิดเหตุการณ์ใดเหตุการณ์หนึ่งต่อไปนี้เท่านั้น

1. ธุรกิจได้ส่งเทมเพลตข้อความให้แก่ผู้ใช้
2. ผู้ใช้เริ่มต้นการสนทนาด้วยลิงก์ "คลิกเพื่อแชท"
3. ผู้ใช้เพิ่มหมายเลขโทรศัพท์ของธุรกิจลงในสมุดรายชื่อของตน และเริ่มต้นการสนทนา

ขั้นตอนที่ 2: ตรวจสอบการตอบกลับของคุณ

การตอบกลับที่สำเร็จจะมีอ็อบเจ็กต์ messages พร้อม ID สำหรับข้อความที่เพิ่งสร้างขึ้นใหม่

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

การตอบกลับที่ไม่สำเร็จจะมีข้อความแสดงข้อผิดพลาด โปรดดูข้อมูลเพิ่มเติมที่รหัสข้อผิดพลาดและรหัสสถานะ