เช่นเดียวกับ Enterprise-grade อื่น ๆ Zoom ก็มี API ให้เราพัฒนาโน่นนี่ได้ บทความนี้จะมาแนะนำวิธีการ Webhook เพื่อรายงาน ผ่าน LINE Notify เมื่อมีคนเข้ามาในห้อง เช่นใช้เพื่อแจ้งคนบน Host ว่า มีคนเข้ามาแล้วนะ เป็นต้น
แต่ก่อนอื่น ต้องเข้าใจว่า Zoom Account มี หลายรูปแบบ โดยเข้าไปที่เว็บ
https://zoom.us/profile
Basic Account อันนี้ หลายคนคงจะใช้อยู่ ที่ถูกลิมิต ไม่ให้ใช้งานเกิน 40 นาที — อันนี้ จะเห็นคำว่า BASIC อยู่ในหน้า Profile ดังรูปที่ 1
รูปที่ 1. Basic Account
2. LICENSED Account แบบนี้ สร้างเอง จ่ายตังค์เอง นักเลงพอ ก็จะประชุมได้ไม่จำกัดเวลา คนเข้าได้พร้อมกัน 100 คน จะมีคำว่า LICENSED ดังรูปที่ 2
รูปที่ 2. Licensed Account
3. แต่มีอีกแบบ ไฮโซกว่า คือแบบ Corporate (มั้ง) แบบว่า ในองค์กรซื้อ ข้อแตกต่างกับแบบที่ 2 คือ ประชุมไม่จำกัดเวลา และ ผู้เข้าร่วมได้สูงสุด 300 คน ดังรูปที่ 3
รูปที่ 3. Corporate Licensed Account
คราวนี้ เชื่อว่าหลายคนอาจจะยังไม่ทราบว่า เราสามารถเขียนโปรแกรมเพื่อจัดการงานต่าง ๆ กับ Zoom ได้ โดยไปที่เว็บ
https://marketplace.zoom.us/develop/create
สำหรับ Basic Account เค้าให้เราเป็น Admin จึงสร้างได้ครบทุกชนิด ดังรูปที่ 4
รูปที่ 4. Basic Account สร้างได้หมดทุกอย่าง
สำหรับ Licensed Account แบบจ่ายตังค์เอง เค้าให้เราเป็น Admin จึงสร้างได้ครบทุกชนิด ดังรูปที่ 5
รูปที่ 5. Licensed Account สร้างได้หมดทุกอย่าง
ส่วน Corporate Licensed Account … ก็น่าเสียดาย ที่ Admin เค้าให้เราเป็นแค่ Member จึงไม่สามารถใช้งานได้ครบถ้วนได้ เสียดายตังค์ เอ๊ย เสียดายจัง ดังรูปที่ 6
รูปที่ 6. Corporate Licensed Account สร้างได้เฉพาะ OAuth กับ Chatbot เพราะเค้าให้เราเป็นแค่ Member
ก็ … แล้วแต่นะ
มาสร้าง Zoom Webhook กันเถอะ
Requirement คือ เราเป็น Host เปิดห้อง Zoom เอาไว้ ซึ่งจะเริ่มประชุมเวลา 10:00 แต่ต้องการทราบว่า มีใครเข้ามาก่อนเวลา ให้ ส่ง Line Notify ไปแจ้ง Host ให้ทราบ
Zoom Webhook จะทำหน้าที่เฝ้าห้องให้ แล้วเมื่อเกิด Event ที่กำหนด ก็จะส่ง POST request ไปยัง URL ที่กำหนดไว้ ดังนั้น สิ่งแรกคือ เราจะมาสร้าง Google Cloud Function ด้วยภาษา Python เพื่อรับ POST Request นั้น
(Prerequisite: ท่านสามารถใช้ Google Cloud Platform และ LINE Notify ได้แล้ว)
Google Cloud Function
ไปที่ https://console.cloud.google.com/functions/add จะได้หน้าตาประมาณนี้ (รูปที่ 7) กรอก Function name, Region (แนะนำให้ใช้ Singapore), ให้ Trigger ด้วย HTTP Protocol และ Allow unauthenticated invocation. จากนั้นคลิก Save แล้วก็ Next
รูปที่ 7. สร้าง Google Cloud Function
เลือก Runtime เป็นภาษา programming ที่ต้องการ ในที่นี้จะเลือก Python แล้วคลิกที่ปุ่ม Enable API ตามรูปที่ 8.
รูปที่ 8. เลือก Python แล้ว Enable API (สำหรับการใช้งานครั้งแรก)
ใส่ Code ดัง รูปที่ 9 (สามารถ Copy จาก gist : https://gist.github.com/nagarindkx/fe36a26bd867d1ae627ad0d69f6e6b4d )
ในบรรทัดที่ 3: เดี๋ยวเราจะเอากลับมาใส่ในภายหลัง
ในบรรทัดที่ 4: ต้องไปสร้าง LINE Notify Token ก่อน สามารถทำตามวิธีการนี้ได้ วิธีแจ้งเตือนจาก Google Forms เข้า LINE
ในบรรทัดที่ 7 และ 8: เราจะกลับมาสลับ Comment ในภายหลัง
รูปที่ 9. Python code สำหรับรับการ Alert จากฝั่ง Zoom Webhook
สุดท้าย แก้ไขไฟล์ requirements.txt เพิ่มบรรทัดใหม่ แล้วเขียนคำว่า
requests
เข้าไป ตรงนี้จะเป็น packages ไว้ใช้ติดต่อเพื่อส่ง LINE Notify ดังรูปที่ 10.
จากนั้นคลิกปุ่ม DEPLOY
รูปที่ 10. แก้ไขไฟล์ requirements.txt เพิ่ม requests package เข้าไปด้วย เพื่อให้สามารถเรียก LINE Notify API ได้
ก่อนจะทำขั้นตอนถัดไป ให้คลิกที่ Tab TRIGGER แล้ว copy Trigger URL ไว้ ดัง รูปที่ 11
รูปที่ 11. copy Trigger URL เก็บไว้ก่อน
Zoom Webhook Only
ต่อไป กลับมาที่ Zoom App Marketplace (https://marketplace.zoom.us/develop/create )
คลิกที่ ปุ่ม Create ใน Webhook Only
ระบบจะเด้งให้ตั้งชื่อ App Name ดังรูปที่ 12.
ให้ตั้งชื่อตามสมควร แล้วคลิกปุ่ม Create
รูปที่ 12. ตั้งชื่อ App Name
ตั้งค่าต่าง ๆ ดังรูปที่ 13. แล้วคลิกปุ่ม Continue
รูปที่ 13. กรอข้อมูลต่าง ๆ
ต่อไป เป็นขั้นตอนการเฝ้า Event หรือ Event Subscriptions
คลิก Switch
คลิกปุ่ม Add new event subscription
กรอกข้อมูล Subscription Name
แล้วเอา Trigger URL จาก รูปที่ 11. ใส่ใน Event notification endpoint URL
ดังรูปที่ 14.
รูปที่ 14. ระบุ Subscription Name และ Event notification endpoint URL
จากนั้น คลิกปุ่ม Add events
เลือก Event types ที่ต้องการ ในที่นี้ เป็น Participant joined meeting before host ดังรูปที่ 15
จากนั้น คลิกปุ่ม Done แล้ว Save
รูปที่ 15. เลือก Participant joined meeting before host
จากนั้น ระบบจะให้ Verification Token มา ให้ copy เก็บไว้ เพื่อเอาไปใส่ใน Google Cloud Function ต่อไป ดังรูปที่ 16.
จากนั้นคลิกปุ่ม Continue เป็นอันเรียบร้อย
รูปที่ 16. Verification Token เพื่อเอาไปใส่ใน Google Cloud Function
สุดท้าย กลับไปที่ Google Cloud Function
กลับเอา Verification Token ไปใส่ใน zoom_verification_token เอา LINE Notify Token ของจริง ไปใส่ใน access_token Uncomment บรรทัดที่ 7 Comment บรรทัดที่ 8
แล้วคลิก Deploy
ทดสอบใช้งาน
สร้างห้อง Zoom แบบไม่ต้องมี Waiting Room ลองให้คนอื่นเข้าไปในห้องก่อน Host
Zoom Webhook จะส่ง HTTP POST ไปยัง Google Cloud Function โดยจะใส่ค่าลงไปใน Header “authorization”
ถ้า ค่าดังกล่าว ตรงกับ zoom_verification_token ระบบก็จะส่ง LINE Notify ออกไป
หวังว่าจะเป็นประโยชน์ครับ