เริ่มต้นใช้งาน
คู่มือนี้จะช่วยคุณในการรับส่งข้อความแรกโดยใช้ Cloud API และคุณยังจะได้เรียนรู้วิธีกำหนดค่า Webhooks สำหรับใช้กับแอพตัวอย่าง
คู่มือนี้มีไว้สำหรับผู้ใช้ที่พัฒนาแอพพลิเคชั่นของตนเองหรือองค์กรของตน หากคุณกำลังพัฒนาแอพพลิเคชั่นให้ธุรกิจอื่นๆ ใช้ โปรดดูที่ผู้ให้บริการโซลูชั่น
ก่อนเริ่มต้น
คุณจำเป็นต้องมีสิ่งต่อไปนี้
- บัญชีผู้พัฒนา Meta — เรียนรู้เพิ่มเติมเกี่ยวกับการลงทะเบียนเป็นผู้พัฒนา Meta
- แอพทางธุรกิจ — เรียนรู้เพิ่มเติมเกี่ยวกับการสร้างแอพ หากคุณไม่เห็นตัวเลือกในการสร้างแอพทางธุรกิจ ให้เลือก อื่นๆ > ถัดไป > ธุรกิจในระหว่างการสร้างแอพ)
ขั้นตอนที่ 1: เพิ่มผลิตภัณฑ์ WhatsApp ไปยังแอพของคุณ
ในขั้นตอนนี้ หากคุณสร้างแอพใหม่ คุณจะเห็นข้อความแจ้งให้เพิ่มผลิตภัณฑ์ไปยังแอพของคุณ เลื่อนลงไปจนถึงส่วน WhatsApp แล้วเลือกตั้งค่า มิฉะนั้น ให้เลือกแอพของคุณจากหน้าจอแอพของฉัน และคุณสามารถทำตามขั้นตอนเดียวกันนี้อีกครั้งเพื่อเพิ่มผลิตภัณฑ์ WhatsApp ไปยังแอพของคุณ
หากคุณมีบัญชีธุรกิจ Meta (MBA) ระบบจะแจ้งให้คุณระบุไปด้วยเมื่อเพิ่มผลิตภัณฑ์ WhatsApp ไปยังแอพของคุณ หากคุณไม่มี MBA คุณจะเห็นข้อความแจ้งที่จะช่วยคุณสร้างบัญชีขึ้นมา เมื่อระบุ MBA ไปกับแอพพลิเคชั่นของคุณแล้ว คุณก็พร้อมจะเริ่มทดสอบ
การเพิ่มผลิตภัณฑ์ WhatsApp ไปยังแอพของคุณจะทำให้เกิดการดำเนินการต่อไปนี้
- แจ้งให้คุณสร้างบัญชีธุรกิจ Meta หากยังไม่มี
- สร้างบัญชี WhatsApp Business สำหรับทดสอบให้คุณโดยอัตโนมัติ บัญชีนี้มีข้อจำกัดต่างๆ และมีไว้เพื่อวัตถุประสงค์ในการทดสอบและพัฒนาเท่านั้น เนื่องจากคุณไม่ได้ชำระเงินในการรับส่งข้อความ
- สร้างหมายเลขโทรศัพท์ธุรกิจสำหรับทดสอบที่เชื่อมโยงกับบัญชี WhatsApp Business ของคุณ คุณสามารถใช้หมายเลขนี้เพื่อส่งข้อความฟรีไปยังหมายเลขโทรศัพท์ของผู้รับได้สูงสุด 5 หมายเลข
- สร้างชุดเทมเพลตข้อความที่ได้รับอนุมัติล่วงหน้า
ขั้นตอนที่ 2: เพิ่มหมายเลขโทรศัพท์ของผู้รับ
เพิ่มหมายเลขโทรศัพท์ WhatsApp ที่ใช้งานได้ ซึ่งคุณสามารถส่งข้อความทดสอบไปได้
ในเมนูทางด้านซ้ายของแดชบอร์ดของแอพ ให้ไปที่ WhatsApp > การตั้งค่า API ในส่วนส่งและรับข้อความ ให้เลือกช่องถึง และเลือกจัดการรายการหมายเลขโทรศัพท์
คุณสามารถเพิ่มหมายเลขโทรศัพท์ WhatsApp ที่ใช้งานได้เป็นผู้รับ หมายเลขโทรศัพท์ของผู้รับจะได้รับรหัสยืนยันใน WhatsApp ที่สามารถใช้ตรวจสอบยืนยันหมายเลขโทรศัพท์นั้นได้
เมื่อคุณตรวจสอบยืนยันหมายเลขโทรศัพท์ของผู้รับแล้ว ระบบจะเลือกหมายเลขนั้นไว้ในช่องถึง ทำตามขั้นตอนนี้ซ้ำหากคุณต้องการเพิ่มผู้รับอีกราย โดยเพิ่มได้สูงสุดรวม 5 ราย
ขั้นตอนที่ 3: ส่งข้อความทดสอบ
ส่งข้อความเทมเพลต hello_world ที่ได้รับอนุมัติล่วงหน้าไปยังหมายเลขโทรศัพท์ของผู้รับที่คุณเลือก
ในแผง WhatsApp > การตั้งค่า API ให้ดำเนินการดังนี้
- ตรวจสอบว่าได้เลือกหมายเลขโทรศัพท์ธุรกิจสำหรับทดสอบของคุณในช่อง "จาก"
- ตรวจสอบว่าคุณได้เลือกหมายเลขโทรศัพท์ของผู้รับที่ต้องการส่งข้อความถึงในช่อง "ถึง" หากคุณเพิ่มหลายหมายเลข คุณสามารถส่งหลายข้อความพร้อมกันได้
- ในแผงส่งข้อความด้วย API ให้คลิกปุ่มส่งข้อความ
หรือคุณสามารถคัดลอกคำสั่ง cURL ไปวางในหน้าต่างเทอร์มินัลใหม่แล้วเรียกใช้
สังเกตว่าโค้ดจะระบุว่าคุณกำลังส่งข้อความเทมเพลต (”type”:”template”) และระบุเทมเพลตเฉพาะเจาะจงที่จะใช้ (”name”:”hello_world”)
ขั้นตอนที่ 4: โคลนแอพตัวอย่างและกำหนดค่า Webhooks
Webhooks ช่วยให้คุณได้รับการแจ้งเตือน HTTP แบบเรียลไทม์เมื่อมีการเปลี่ยนแปลงเกิดขึ้นกับอ็อบเจ็กต์ที่เฉพาะเจาะจง Webhooks ใน WhatsApp สามารถแจ้งเตือนหลายเหตุการณ์ในแอพของคุณได้ เช่น การนำส่งข้อความและการแจ้งเตือนการอ่าน หรือแม้แต่การเปลี่ยนบัญชี
เพิ่ม URL การเรียกกลับเพื่อดูเนื้อหาของ Webhooks ทำตามขั้นตอนในคู่มือทดสอบตัวอย่าง URL การเรียกกลับสำหรับ Webhooks เพื่อโคลนแอพตัวอย่างของเรา ซึ่งจะยอมรับการแจ้งเตือนของ Webhooks และแสดงเพย์โหลด JSON บนหน้าจอ
เมื่อตั้งค่า Webhook เรียบร้อยแล้ว ให้ส่งข้อความเทมเพลตอีกครั้งแล้วตอบกลับ คุณควรจะเห็นการแจ้งเตือนของ Webhook แยกกัน 4 รายการ ได้แก่ การแจ้งเตือนถึงการส่งข้อความ ข้อความถึงผู้รับแล้ว และข้อความถูกอ่านแล้ว รวมถึงเนื้อหาของข้อความที่ส่งเข้ามา
ขั้นตอนที่ 5: (ไม่บังคับ) เพิ่มหมายเลขธุรกิจตามจริง
คุณสามารถเริ่มต้นพัฒนาแอพพลิเคชั่นได้ด้วยหมายเลขธุรกิจสำหรับทดสอบและบัญชี WhatsApp Business สำหรับทดสอบ เมื่อใช้องค์ประกอบการทดสอบเหล่านี้ คุณจะไม่ต้องชำระเงินในการส่งข้อความขณะกำลังพัฒนาแอพ
เมื่อคุณพร้อมจะเริ่มส่งข้อความหาลูกค้าแล้ว คุณสามารถเพิ่มหมายเลขโทรศัพท์ธุรกิจจริงในแผงการตั้งค่า API และสร้างบัญชี WhatsApp Business จริง