บทแนะนำการใช้งานนี้จะกล่าวถึงวิธีการตั้งค่าไคลเอ็นต์ API ภายในองค์กร, การลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ, การอัพเดตการตั้งค่า และการส่งข้อความทดสอบ
กระบวนการเริ่มต้นใช้งาน API นี้แบ่งได้เป็น 3 ส่วนดังนี้:
/account
และส่งข้อความทดสอบด้วยการเรียกใช้ไปยัง /messages
คุณจำเป็นต้องมีสิ่งต่อไปนี้
หลังจากที่คุณตรวจสอบยืนยันธุรกิจแล้ว ระบบจะตรวจสอบว่าธุรกิจของคุณเป็นไปตามข้อกำหนดในการใช้บริการของ WhatsApp และนโยบายการค้าของ WhatsApp หรือไม่ ขั้นตอนนี้จะเริ่มต้นโดยอัตโนมัติ คุณสามารถตรวจสอบสถานะของการตรวจสอบยืนยันธุรกิจและการตรวจสอบธุรกิจได้ในแท็บการตั้งค่าของบัญชี WhatsApp Business ในตัวจัดการธุรกิจ โดยการตรวจสอบยืนยันธุรกิจจะแสดงว่าตรวจสอบยืนยันแล้ว และสถานะบัญชีจะแสดงว่าอนุมัติแล้วเมื่อได้รับการอนุมัติ
ใส่หมายเลขโทรศัพท์และชื่อที่แสดงในบัญชี WhatsApp Business ของคุณ การดำเนินการนี้จะส่งชื่อที่แสดงเพื่อรับการตรวจสอบ
หากคุณต้องการเปลี่ยนชื่อที่แสดง คุณจะทำกี่ครั้งก็ได้เท่าที่คุณต้องการจนกว่าคุณจะลงทะเบียนเสร็จสิ้น แต่หลังจากนั้น คุณจะต้องรอ 30 วันในการส่งคำขอเปลี่ยนชื่อที่แสดงแต่ละครั้ง
เมื่อการตรวจสอบทั้งหมดเสร็จสมบูรณ์ คุณสามารถดูและเข้าถึงใบรับรองที่เข้ารหัสแบบ Base64 ได้ ซึ่งจำเป็นสำหรับการลงทะเบียนไคลเอ็นต์ API ภายในองค์กรของคุณ เราขอแนะนำให้คุณลงทะเบียนด้วยชื่อที่แสดงที่ผ่านการอนุมัติแล้วเพื่อเริ่มการผสานการทำงานก่อนที่จะทำการเปลี่ยนแปลงเพิ่มเติมใดๆ กับชื่อที่แสดง คุณสามารถเปลี่ยนชื่อที่แสดงเมื่อใดก็ได้หลังการผสานการทำงาน
เมื่อธุรกิจของคุณเริ่มส่งข้อความผ่าน API ภายในองค์กร คุณจำเป็นต้องทำความเข้าใจกระบวนการเรียกเก็บเงิน เช่น วิธีและเวลาที่ระบบจะเรียกเก็บค่าบริการจากคุณ รวมถึงวิธีการดูและชำระใบเรียกเก็บเงินรายเดือนของคุณ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเกี่ยวกับการเรียกเก็บเงินสำหรับบัญชี WhatsApp Business ของคุณ และดูกฎการกำหนดราคาและต้นทุนต่อข้อความในหน้าการกำหนดราคาของเรา
ซอฟต์แวร์ | เวอร์ชั่น | รายละเอียด |
---|---|---|
API ภายในองค์กร | ||
API ภายในองค์กรสำหรับ AWS | เวอร์ชั่นเทมเพลต: | |
MySQL |
| โปรดทราบว่าฐานข้อมูลที่ย้ายไปยัง MySQL 8 จะไม่สามารถย้อนรุ่นกลับไปใช้ MySQL 5 ได้ ดังนั้นจึงต้องสำรองข้อมูลในฐานข้อมูลก่อนการย้าย |
PostgreSQL |
| รองรับ |
Docker |
| ต้องใช้เวอร์ชั่น ตรวจสอบให้แน่ใจว่าการเรียกใช้ระบบ statx อยู่ในรายการการเรียกใช้ระบบที่ได้รับอนุญาตสำหรับ Docker |
Postman | เวอร์ชั่นใดก็ได้ที่เป็นเวอร์ชั่นล่าสุด | |
libseccomp |
| รองรับเฉพาะ |
glibc |
| รองรับเฉพาะ |
ระบบปฏิบัติการ (OS) | เวอร์ชั่นล่าสุด | ใช้ Kernel เวอร์ชั่น |
ไคลเอ็นต์ API ภายในองค์กรจะทำงานบน Docker เป็นหลัก โปรดดูข้อมูลเกี่ยวกับแต่ละองค์ประกอบที่สถาปัตยกรรมไคลเอ็นต์
ขณะนี้ไคลเอ็นต์ API ภายในองค์กรไม่รองรับ Docker สำหรับ Windows หรือ Windows Subsystem for Linux หากจำเป็นต้องทำการพัฒนา ขอแนะนำให้ใช้เครื่องเสมือนบน Linux และเรียกใช้งาน Docker ภายในโซลูชั่นที่แนะนำนั้น สำหรับปริมาณงานในการใช้งานจริง ขอแนะนำให้ใช้เซิร์ฟเวอร์ Linux เพื่อหลีกเลี่ยงประเด็นปัญหาเกี่ยวกับความเข้ากันได้และประสิทธิภาพการทำงาน
ไคลเอ็นต์ API ภายในองค์กรจะทำงานบนเครื่องที่เชื่อมต่ออินเทอร์เน็ตที่สามารถเรียกใช้ Docker สำหรับ Linux ทั้งในเครื่องเสมือนหรือบนเซิร์ฟเวอร์ Linux โปรดดูข้อมูลเพิ่มเติมที่คำถามที่พบบ่อย ตัวอย่างเช่น สามารถทำการทดสอบทั่วไปบนแล็ปท็อปได้ สำหรับเซิร์ฟเวอร์ของสภาพแวดล้อมการใช้งานจริง เราขอแนะนำให้ใช้ 250 GB SSD, 16 GB RAM และ 4 core CPU เป็นอย่างน้อย ไม่แนะนำให้ใช้ HDD เนื่องจากความเร็ว I/O อาจก่อให้เกิดสภาวะติดขัดขณะโหลดข้อมูลได้
ในกรณีส่วนใหญ่ คุณควรใช้ฐานข้อมูลบนเซิร์ฟเวอร์แยกจากคอนเทนเนอร์ Coreapp และ Webapp เซิร์ฟเวอร์ของฐานข้อมูลควรมีเวลาแฝงจากเครื่องประมวลผลเพียงไม่กี่มิลลิวินาทีเท่านั้น
การเริ่มต้นใช้งาน API ภายในองค์กรมีอยู่ 2 วิธี ดังนี้
เมื่อไคลเอ็นต์ API ภายในองค์กรกำลังทำงาน คุณจะต้องเข้าสู่ระบบในฐานะ admin
เพื่อดำเนินการตามขั้นตอนการตั้งค่าส่วนที่เหลือ
คุณสามารถเปลี่ยนแปลงการตั้งค่าแอพพลิเคชั่นได้ เมื่อไคลเอ็นต์ API ภายในองค์กรทำงานแล้ว อย่างไรก็ตาม คุณจะไม่ได้รับสิทธิ์เข้าถึงการตั้งค่าโปรไฟล์ที่แตกต่างกันของไคลเอ็นต์ API ภายในองค์กรของคุณจนกว่าการลงทะเบียนจะเสร็จสิ้น
เมื่อไคลเอ็นต์ API ภายในองค์กรของคุณพร้อมและทำงานได้แล้ว คุณสามารถลงทะเบียนหมายเลขโทรศัพท์ของคุณได้โดยส่งการเรียกใช้ API ไปยังตำแหน่งข้อมูล account
คุณสามารถส่งข้อความทดสอบได้โดยใช้ตำแหน่งข้อมูล messages
ก่อนอื่น โปรดตรวจสอบสถานะของหมายเลขโทรศัพท์ที่คุณใช้สำหรับการทดสอบ คุณจะต้องส่งข้อความจากหมายเลขโทรศัพท์ทดสอบไปยังบัญชี WhatsApp ของคุณเพื่อเปิดใช้งานช่วงเวลาการบริการลูกค้า ซึ่งจะช่วยให้คุณสามารถส่งข้อความประเภทใดก็ได้ภายในช่วงเวลา 24 ชั่วโมง (โปรดดูรายละเอียดที่การควบคุมการตัดสิทธิ์) จากนั้น ให้ส่งข้อความ SMS ไปยังหมายเลขโทรศัพท์ทดสอบของคุณ หากได้รับข้อความ แสดงว่าการติดตั้งเสร็จเรียบร้อยแล้ว หากไม่ได้รับ โปรดตรวจสอบ Webhook ของคุณเพื่อดูการแจ้งเตือนที่อาจบ่งบอกถึงปัญหา
โปรดดูคู่มือการรักษาความปลอดภัยเพื่อศึกษาข้อมูลเกี่ยวกับรหัสผ่าน, การยืนยันตัวตน, การกำหนดค่า SSL, การแยกเครือข่าย, การสื่อสารแบบเข้ารหัส, ส่วนหัว HTTP และโปรโตคอล TLS สำหรับเว็บเซิร์ฟเวอร์ตามที่เกี่ยวข้องกับไคลเอ็นต์ API ภายในองค์กร
API ภายในองค์กรของ WhatsApp จะเข้าสู่กระบวนการเริ่มต้นเมื่อสร้างการเชื่อมต่อกับเซิร์ฟเวอร์ กระบวนการนี้มีความสำคัญเพื่อให้แน่ใจว่าวิธีการส่งและรับข้อความนั้นราบรื่นและเชื่อถือได้ ในระยะเริ่มต้นนี้ แอพพลิเคชั่นหลัก (Coreapp) กำลังรอการปฏิบัติตามข้อกำหนดเบื้องต้นหลายประการ ซึ่งประกอบไปด้วย
การโหลดข้อความเทมเพลต: API จะโหลดข้อความเทมเพลตจากเซิร์ฟเวอร์โดยเป็นส่วนหนึ่งของกระบวนการเริ่มต้น
การรับและการประมวลผลข้อความแบบออฟไลน์: นอกจากนี้ ระบบยังจัดการการรับและการประมวลผลข้อความแบบออฟไลน์ด้วย
หากมีการพยายามส่งข้อความในขณะที่ไม่เป็นไปตามข้อกำหนดเบื้องต้นเหล่านี้ แอพพลิเคชั่นหลักจะตอบกลับด้วยข้อความแสดงข้อผิดพลาดว่า "Coreapp ไม่พร้อม" และข้อมูลบันทึกจะแสดงข้อผิดพลาดว่า "บริการไม่พร้อม" สิ่งสำคัญที่คุณต้องทราบคือกระบวนการเริ่มต้นนี้จะดำเนินการทุกครั้งที่มีการเชื่อมต่อใหม่กับเซิร์ฟเวอร์ WhatsApp ด้วยเหตุนี้ หากแอพพลิเคชั่นหลักรีสตาร์ทหรือประสบปัญหาขาดการเชื่อมต่อ กระบวนการเริ่มต้นระบบจะเริ่มต้นอีกครั้งเพื่อตั้งค่าสถานะของ Coreapp เป็น "พร้อม" การดำเนินการนี้ทำให้มั่นใจได้ถึงความน่าเชื่อถือและความพร้อมของ API ภายในองค์กรของ WhatsApp สำหรับการสื่อสารด้วยข้อความ
เมื่อไม่พบข้อความแบบออฟไลน์ ก็จะไม่มีขั้นตอนการประมวลผลข้อความออฟไลน์ หรือพูดอีกอย่างคือ หากไม่มีข้อความรออยู่ในสถานะออฟไลน์ การจัดการข้อความในช่วงระยะนี้ก็จะถูกข้ามไป
เมื่ออยู่ภายใต้เงื่อนไขทั่วไป API ภายในองค์กรของ WhatsApp จะเป็นไปตามโปรโตคอลมาตรฐานสำหรับการจัดการข้อความแบบออฟไลน์ ซึ่งจะรอการรับและประมวลผลข้อความแบบออฟไลน์ทั้งหมด โดยมีระยะการหมดเวลาสูงสุดที่กำหนดไว้ล่วงหน้าอยู่ที่ 6 นาที เมื่อพ้นระยะเวลา 6 นาทีนี้แล้ว ขั้นตอนการประมวลผลข้อความแบบออฟไลน์จะถือว่าเสร็จสมบูรณ์
ข้อควรปฏิบัติเริ่มต้นส่งและรับข้อความกับพนักงานภายในก่อนเพื่อตรวจสอบว่าระบบทำงานได้ ตอบกลับลูกค้าทุกรายภายใน 24 ชั่วโมง ปฏิบัติตามนโยบายของเราที่ระบุไว้ในนโยบายของ WhatsApp Business และนโยบายการค้าของ WhatsApp ใช้หมายเลขโทรศัพท์หลายๆ หมายเลขสำหรับการพัฒนา การทดสอบ และการใช้งานจริง ตรวจดูคำถามที่พบบ่อยก่อนที่จะเปิดบัตรคำร้องขอรับความช่วยเหลือโดยตรง ให้คำติชมผลิตภัณฑ์ ความช่วยเหลือโดยตรงคือช่องทางที่ดีที่สุดสำหรับการดำเนินการดังกล่าว | สิ่งที่ไม่ควรทำส่งการแจ้งเตือนซ้ำไปยังหลายช่องทาง ส่งสแปม ใช้หมายเลข 1-800 สำหรับการทดสอบ สร้างตัวจัดการธุรกิจสำหรับการผสานการทำงานกับ WhatsApp เท่านั้น ให้ใช้ตัวจัดการธุรกิจที่มีอยู่ หากมี |
หากเราตรวจพบว่าคุณละเมิดแนวทางหรือนโยบายใดๆ ของเรา เราขอสงวนสิทธิ์ในการจำกัดหรือยกเลิกสิทธิ์การเข้าถึง WhatsApp ของคุณ