เริ่มต้นใช้งาน

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

กระบวนการเริ่มต้นใช้งาน API นี้แบ่งได้เป็น 3 ส่วนดังนี้:

  1. เตรียมองค์ประกอบ - ก่อนเริ่มต้น คุณต้องตั้งค่าองค์ประกอบที่จำเป็นในการดำเนินการผสานการทำงานของ API ให้เสร็จสมบูรณ์ ซึ่งรวมถึงบัญชี WhatsApp Business
  2. ติดตั้งไคลเอ็นต์ API ภายในองค์กร - ติดตั้งไคลเอ็นต์ เมื่อไคลเอ็นต์ของคุณทำงาน คุณจะสามารถอัพเดตการตั้งค่าแอพพลิเคชั่นของคุณได้
  3. เริ่มต้นใช้งานไคลเอ็นต์ - ลงทะเบียนหมายเลขโทรศัพท์ของคุณด้วยการเรียกใช้ API ไปยัง /account และส่งข้อความทดสอบด้วยการเรียกใช้ไปยัง /messages

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

คุณจำเป็นต้องมีสิ่งต่อไปนี้

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

การตั้งค่าบัญชี WhatsApp ของคุณ

ใส่หมายเลขโทรศัพท์และชื่อที่แสดงในบัญชี WhatsApp Business ของคุณ การดำเนินการนี้จะส่งชื่อที่แสดงเพื่อรับการตรวจสอบ

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

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

ตรวจสอบข้อมูลการเรียกเก็บเงินและการกำหนดราคา

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

ซอฟต์แวร์ เวอร์ชั่น รายละเอียด

API ภายในองค์กร

ตรวจสอบบันทึกการเปลี่ยนแปลง

ตรวจสอบบันทึกการเปลี่ยนแปลง

API ภายในองค์กรสำหรับ AWS

ตรวจสอบบันทึกการเปลี่ยนแปลง


เวอร์ชั่นเทมเพลต: v3.0.1

ตรวจสอบบันทึกการเปลี่ยนแปลง

MySQL

5.7.xx และ 8.0.xx

โปรดทราบว่าฐานข้อมูลที่ย้ายไปยัง MySQL 8 จะไม่สามารถย้อนรุ่นกลับไปใช้ MySQL 5 ได้ ดังนั้นจึงต้องสำรองข้อมูลในฐานข้อมูลก่อนการย้าย

PostgreSQL

13.8

รองรับ 13.x, 12.x และ 11.x

Docker

18.04 ขึ้นไป ยกเว้นเวอร์ชั่น 19.03.7

ต้องใช้เวอร์ชั่น 18.04 สำหรับ v2.33 ขึ้นไป


ตรวจสอบให้แน่ใจว่าการเรียกใช้ระบบ statx อยู่ในรายการการเรียกใช้ระบบที่ได้รับอนุญาตสำหรับ Docker

Postman

เวอร์ชั่นใดก็ได้ที่เป็นเวอร์ชั่นล่าสุด

libseccomp

2.3.3

รองรับเฉพาะ 2.3.3

glibc

2.28

รองรับเฉพาะ 2.28 ขึ้นไป

ระบบปฏิบัติการ (OS)

เวอร์ชั่นล่าสุด

ใช้ Kernel เวอร์ชั่น 4.11 เป็นอย่างน้อย

ขั้นตอนที่ 1: ติดตั้งไคลเอ็นต์ API ภายในองค์กร

สภาพแวดล้อม

ไคลเอ็นต์ 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 วิธี ดังนี้

  • การติดตั้งภายในองค์กร - คุณสามารถตั้งค่าคอนเทนเนอร์ Docker ด้วยตนเองโดยใช้คู่มือการติดตั้ง เราขอแนะนำให้เริ่มต้นจากการตั้งค่าสำหรับผู้พัฒนา 1 รายการเพื่อทำความคุ้นเคยกับขั้นตอนการตั้งค่าและการส่งข้อความ โซลูชั่นภายในองค์กรนี้สามารถใช้งานบนคอมพิวเตอร์ของคุณได้ก่อนจะย้ายไปยังสภาพแวดล้อมการใช้งานจริง
  • Amazon Web Services (AWS): หากคุณใช้ AWS หรือต้องการโซลูชั่นแบบสแตนด์อโลนมากขึ้น โปรดดูคู่มือสำหรับ AWS โซลูชั่น AWS จะตั้งค่าโซลูชั่น API ภายในองค์กรทั้งระบบ พร้อมด้วยการสำรองข้อมูล การกู้คืนข้อมูล และอื่นๆ บนคลาวด์ของ AWS ที่คุณจัดการและเป็นเจ้าของ

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

อัพเดตการตั้งค่า

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

  • การตั้งค่าแอพพลิเคชั่นเป็นการตั้งค่าเกี่ยวกับวิธีการทำงานของไคลเอ็นต์ ได้แก่ การตั้งค่าการเรียกกลับ, Webhooks, เพจเจอร์สำหรับรับการแจ้งเตือน, สถานะการส่ง, รูปแบบการดาวน์โหลดสื่อ ฯลฯ หมายเหตุ: ขอแนะนำเป็นอย่างยิ่งให้คุณตั้งค่า URL ของ Webhook เพื่อรับการแจ้งเตือนเกี่ยวกับข้อความขาเข้าหรือข้อผิดพลาด
  • การตั้งค่าโปรไฟล์ธุรกิจและการตั้งค่าโปรไฟล์จะครอบคลุมข้อมูลของธุรกิจของคุณ เช่น ที่อยู่, อีเมล, เว็บไซต์, อุตสาหกรรม, ข้อมูล "เกี่ยวกับ" และรูปโปรไฟล์

ขั้นตอนที่ 2: เริ่มต้นใช้งานไคลเอ็นต์

การลงทะเบียน

เมื่อไคลเอ็นต์ 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

ใช้หมายเลขโทรศัพท์หลายๆ หมายเลขสำหรับการพัฒนา การทดสอบ และการใช้งานจริง

ตรวจดูคำถามที่พบบ่อยก่อนที่จะเปิดบัตรคำร้องขอรับความช่วยเหลือโดยตรง

ให้คำติชมผลิตภัณฑ์ ความช่วยเหลือโดยตรงคือช่องทางที่ดีที่สุดสำหรับการดำเนินการดังกล่าว

ระบุรายละเอียดเพื่อจำลองปัญหาต่างๆ ของคุณ เช่น บันทึก, ข้อมูลสนับสนุนจากโหนด health และ support, ข้อมูล WADebug, การเรียกใช้ API เพื่อจำลองปัญหา ฯลฯ

สิ่งที่ไม่ควรทำ

ส่งการแจ้งเตือนซ้ำไปยังหลายช่องทาง

ส่งสแปม

ใช้หมายเลข 1-800 สำหรับการทดสอบ

สร้างตัวจัดการธุรกิจสำหรับการผสานการทำงานกับ WhatsApp เท่านั้น ให้ใช้ตัวจัดการธุรกิจที่มีอยู่ หากมี

หากเราตรวจพบว่าคุณละเมิดแนวทางหรือนโยบายใดๆ ของเรา เราขอสงวนสิทธิ์ในการจำกัดหรือยกเลิกสิทธิ์การเข้าถึง WhatsApp ของคุณ