สื่อ

/v1/media

ใช้โหนด media เพื่ออัพโหลด เรียกใช้ หรือลบสื่อ

จุดเชื่อมโยง

จุดเชื่อมโยงต่อไปนี้เชื่อมต่อกับโหนดนี้

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

เมื่อส่งข้อความสื่อแล้ว ระบบจะจัดเก็บสื่อไว้บนเซิร์ฟเวอร์ของ WhatsApp เป็นเวลา 14 วัน หากผู้ใช้ส่งคำขอเพื่อดาวน์โหลดสื่อหลังจากผ่านไปแล้ว 14 วัน เซิร์ฟเวอร์ของ WhatsApp จะส่งคำขอรับไฟล์สื่อเดียวกันนี้จากไคลเอ็นต์ WhatsApp Business ภายในองค์กร หากมีการลบสื่อออกไปแล้ว ผู้ใช้จะได้รับการแจ้งเตือนว่าไม่สามารถใช้งานสื่อได้

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

ข้อจำกัด

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

  • การส่งสื่อโดยกระแสไบต์
  • การส่งข้อความที่มีสติกเกอร์ภาพเคลื่อนไหว

การอัพโหลด

ส่งคำขอ POST ไปยัง /v1/media เพื่ออัพโหลดสื่อ เนื้อความของคำขอภายในองค์กรต้องมีข้อมูลไบนารีของสื่อ และต้องกำหนดส่วนหัว Content-Type ให้เป็นประเภทของสื่อที่จะอัพโหลด โปรดดูตัวเลือกที่รองรับในส่วนประเภทเนื้อหาที่รองรับ

การส่งข้อมูลไบนารีในคำขอ POST HTTP เป็นวิธีมาตรฐานในการอัพโหลดข้อมูลไบนารี หากคุณต้องการอัพโหลดรูปภาพ คุณสามารถออกคำขอ POST พร้อมไบต์รูปภาพจริงในเพย์โหลดได้ เป็นต้น หรือคุณสามารถใช้ --data-binary หากคุณต้องการให้ cURL อ่านและใช้ไฟล์ดังกล่าวในแบบไบนารีตามที่ได้รับมาได้

ตัวอย่าง

การอัพโหลดสื่อ:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

การอัพโหลดสื่อด้วย cURL:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

ในทั้งสองกรณี การตอบกลับที่สำเร็จจะส่งคืนช่อง id ซึ่งคุณจะต้องใช้สำหรับการเรียกใช้สื่อหรือการส่งข้อความสื่อให้กับลูกค้าของคุณ

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

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

ประเภทเนื้อหาที่รองรับ

ขนาดสื่อหลังผ่านการประมวลผล

ต่อไปนี้คือขนาดสูงสุดที่ใช้ได้ของไฟล์สื่อหลังจากบีบอัดและเข้ารหัส

คำถามที่พบบ่อย

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

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

• หลักปฏิบัติที่ดีที่สุด
• ข้อความ
• ข้อมูลอ้างอิง