หน้านี้จะอธิบายวิธีตั้งค่าเว็บฮุคให้ส่งข้อความแบบไม่พร้อมกันไปยัง พื้นที่ใน Chat ที่ใช้ทริกเกอร์ภายนอก ตัวอย่างเช่น คุณสามารถ กำหนดค่าแอปพลิเคชันการตรวจสอบเพื่อแจ้งเจ้าหน้าที่ที่โทรคุย แชทเมื่อเซิร์ฟเวอร์ขัดข้อง หากต้องการส่งข้อความพร้อมกัน เมื่อใช้แอป Chat โปรดดู ส่งข้อความ
ด้วยสถาปัตยกรรมประเภทนี้ ผู้ใช้จะโต้ตอบกับเว็บฮุคหรือภายนอกที่เชื่อมต่อไม่ได้ เนื่องจากการสื่อสารทางเดียว เว็บฮุคไม่ใช่การสนทนา ผู้ใช้จะไม่สามารถตอบหรือรับข้อความจากผู้ใช้ หรือ เหตุการณ์การโต้ตอบกับแอป Chat หากต้องการตอบกลับข้อความ สร้างแอปใน Chat แทนเว็บฮุค
แม้ว่าในทางเทคนิคแล้วเว็บฮุค แอป Chat - เว็บฮุคจะเชื่อมต่อแอปพลิเคชันโดยใช้มาตรฐาน คำขอ HTTP หน้านี้หมายถึงแอป Chat สำหรับ การลดความซับซ้อน เว็บฮุคแต่ละรายการใช้งานได้เฉพาะในพื้นที่ใน Chat ของ ที่ได้จดทะเบียนไว้ เว็บฮุคขาเข้าจะทำงานกับข้อความส่วนตัว แต่เฉพาะเมื่อ ผู้ใช้ทุกคนมี เปิดใช้แอป Chat คุณเผยแพร่เว็บฮุคไปยัง Google Workspace Marketplace ไม่ได้
แผนภาพต่อไปนี้แสดงสถาปัตยกรรมของเว็บฮุคที่เชื่อมต่อกับ แชท:
ในแผนภาพก่อนหน้านี้ แอป Chat มีคุณสมบัติดังต่อไปนี้ การรับส่งข้อมูล:
- ตรรกะของแอป Chat จะได้รับข้อมูลจาก บริการของบุคคลที่สามภายนอก เช่น ระบบการจัดการโครงการ ที่จำหน่ายตั๋วโดยอัตโนมัติ
- ตรรกะของแอป Chat โฮสต์อยู่ในระบบคลาวด์หรือ ระบบภายในองค์กรที่สามารถส่งข้อความโดยใช้ URL ของเว็บฮุคไปยัง พื้นที่ใน Chat ที่ต้องการ
- ผู้ใช้สามารถรับข้อความจากแอป Chat ได้ใน พื้นที่ใน Chat ที่ระบุ แต่ไม่สามารถโต้ตอบกับ แอป Chat
ข้อกำหนดเบื้องต้น
Python
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat องค์กร Google Workspace ต้องอนุญาตให้ผู้ใช้ เพิ่มและใช้เว็บฮุคขาเข้า
- Python 3.6 ขึ้นไป
- เครื่องมือจัดการแพ็กเกจ pip
ไลบรารี
httplib2
หากต้องการติดตั้งไลบรารี ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่งpip install httplib2
พื้นที่ใน Google Chat หากต้องการสร้างแชทโดยใช้ Google Chat API โปรดดู สร้างพื้นที่ทำงาน วิธีสร้างใน Chat โปรดไปที่ เอกสารในศูนย์ช่วยเหลือ
Node.js
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat องค์กร Google Workspace ต้องอนุญาตให้ผู้ใช้ เพิ่มและใช้เว็บฮุคขาเข้า
- Node.js 14 ขึ้นไป
- npm เครื่องมือจัดการแพ็กเกจ
- พื้นที่ใน Google Chat หากต้องการสร้างแชทโดยใช้ Google Chat API โปรดดู สร้างพื้นที่ทำงาน วิธีสร้างใน Chat โปรดไปที่ เอกสารในศูนย์ช่วยเหลือ
Java
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat องค์กร Google Workspace ต้องอนุญาตให้ผู้ใช้ เพิ่มและใช้เว็บฮุคขาเข้า
- Java 11 หรือสูงกว่า
- เครื่องมือจัดการแพ็กเกจ Maven
- พื้นที่ใน Google Chat หากต้องการสร้างแชทโดยใช้ Google Chat API โปรดดู สร้างพื้นที่ทำงาน วิธีสร้างใน Chat โปรดไปที่ เอกสารในศูนย์ช่วยเหลือ
Apps Script
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat องค์กร Google Workspace ต้องอนุญาตให้ผู้ใช้ เพิ่มและใช้เว็บฮุคขาเข้า
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน แล้วเปิดบริการ Chat ขั้นสูง
- พื้นที่ใน Google Chat หากต้องการสร้างแชทโดยใช้ Google Chat API โปรดดู สร้างพื้นที่ทำงาน วิธีสร้างใน Chat โปรดไปที่ เอกสารในศูนย์ช่วยเหลือ
สร้างเว็บฮุค
หากต้องการสร้างเว็บฮุค ให้ลงทะเบียนเว็บฮุคในพื้นที่ใน Chat ที่ต้องการ เพื่อรับข้อความ จากนั้นเขียนสคริปต์ที่ส่งข้อความ
ลงทะเบียนเว็บฮุคขาเข้า
- ในเบราว์เซอร์ ให้เปิด แชท คุณจะกำหนดค่าเว็บฮุคจากแอป Chat บนอุปกรณ์เคลื่อนที่ไม่ได้
- ไปยังพื้นที่ทำงานที่ต้องการเพิ่มเว็บฮุค
- ข้างชื่อพื้นที่ทำงาน ให้คลิก ขยายลูกศรเพิ่มเติม แล้วคลิก แอปและ การผสานรวม
คลิก
เพิ่มเว็บฮุคในช่อง Name ให้ป้อน
Quickstart Webhook
ในช่อง URL รูปโปรไฟล์ ให้ป้อน
https://developers.google.com/chat/images/chat-product-icon.png
คลิกบันทึก
หากต้องการคัดลอก URL ของเว็บฮุค ให้คลิก
เพิ่มเติม จากนั้นคลิก คัดลอกลิงก์
เขียนสคริปต์เว็บฮุค
ตัวอย่างสคริปต์เว็บฮุคจะส่งข้อความไปยังพื้นที่ทำงานที่เว็บฮุคอยู่
ลงทะเบียนแล้วโดยส่งคำขอ POST
ไปยัง URL ของเว็บฮุค
Chat API ตอบสนองด้วยอินสแตนซ์
Message
เลือกภาษาเพื่อดูวิธีสร้างสคริปต์เว็บฮุค
Python
สร้างไฟล์ชื่อ
quickstart.py
ในไดเรกทอรีการทำงานใน
quickstart.py
ให้วางโค้ดต่อไปนี้แทนที่ค่าตัวแปร
url
ด้วย URL ของเว็บฮุคที่ ที่คุณคัดลอกเมื่อลงทะเบียนเว็บฮุค
Node.js
สร้างไฟล์ชื่อ
index.js
ในไดเรกทอรีการทำงานใน
index.js
ให้วางโค้ดต่อไปนี้แทนที่ค่าตัวแปร
url
ด้วย URL ของเว็บฮุคที่ ที่คุณคัดลอกเมื่อลงทะเบียนเว็บฮุค
Java
สร้างไฟล์ชื่อ
pom.xml
ในไดเรกทอรีการทำงานคัดลอกและวางข้อมูลต่อไปนี้ใน
pom.xml
ในไดเรกทอรีที่ใช้งานอยู่ ให้สร้างโครงสร้างไดเรกทอรีต่อไปนี้
src/main/java
ในไดเรกทอรี
src/main/java
ให้สร้างไฟล์ชื่อApp.java
ใน
App.java
ให้วางโค้ดต่อไปนี้แทนที่ค่าตัวแปร
URL
ด้วย URL ของเว็บฮุคที่คุณ คัดลอกเมื่อลงทะเบียนเว็บฮุค
Apps Script
ในเบราว์เซอร์ ให้ไปที่ Apps Script
คลิกโปรเจ็กต์ใหม่
วางโค้ดต่อไปนี้
แทนที่ค่าตัวแปร
url
ด้วย URL ของเว็บฮุคที่คุณ คัดลอกเมื่อลงทะเบียนเว็บฮุค
เรียกใช้สคริปต์เว็บฮุค
เรียกใช้สคริปต์ใน CLI ด้วยคำสั่งต่อไปนี้
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
Apps Script
- คลิกเรียกใช้
เมื่อเรียกใช้โค้ด เว็บฮุคจะส่งข้อความไปยังพื้นที่ทำงานที่คุณ ลงทะเบียนไว้แล้ว
เริ่มหรือตอบกลับชุดข้อความ
ระบุ
spaces.messages.thread.threadKey
เป็นส่วนหนึ่งของเนื้อหาคำขอส่งข้อความ ขึ้นอยู่กับว่าคุณเริ่มต้นหรือ การตอบกลับชุดข้อความ ให้ใช้ค่าต่อไปนี้สำหรับthreadKey
หากเริ่มชุดข้อความ ให้ตั้งค่า
threadKey
เป็นสตริงที่กําหนดเอง จดค่านี้ไว้เพื่อโพสต์ตอบชุดข้อความหากตอบกลับชุดข้อความ ให้ระบุ
threadKey
ที่ตั้งค่าไว้เมื่อ เริ่มชุดข้อความแล้ว ตัวอย่างเช่น เพื่อโพสต์การตอบกลับชุดข้อความที่มี ข้อความเริ่มต้นที่ใช้MY-THREAD
ตั้งค่าMY-THREAD
กำหนดลักษณะการทำงานของชุดข้อความหากไม่พบ
threadKey
ที่ระบุ ดังนี้ตอบกลับชุดข้อความหรือเริ่มชุดข้อความใหม่ เพิ่ม
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
พารามิเตอร์ไปยัง URL ของเว็บฮุค การส่งผ่านพารามิเตอร์ของ URL นี้จะทําให้ Chat เพื่อค้นหาชุดข้อความที่มีอยู่โดยใช้threadKey
ที่ระบุ หากมี ข้อความจะโพสต์เป็นการตอบกลับชุดข้อความนั้น หากไม่มีคือ พบข้อความแล้ว ข้อความจะเริ่มชุดข้อความใหม่ที่สอดคล้องกับthreadKey
ตอบกลับชุดข้อความหรือไม่ดำเนินการใดๆ เพิ่ม
messageReplyOption=REPLY_MESSAGE_OR_FAIL
ไปยัง URL ของเว็บฮุค การส่งผ่านพารามิเตอร์ของ URL นี้จะทําให้ Chat เพื่อค้นหาชุดข้อความที่มีอยู่โดยใช้threadKey
ที่ระบุ หากมี ข้อความจะโพสต์เป็นการตอบกลับชุดข้อความนั้น หากไม่มีคือ พบแล้ว ข้อความก็จะไม่ถูกส่ง
ดูข้อมูลเพิ่มเติมได้ที่
messageReplyOption
ตัวอย่างโค้ดต่อไปนี้จะเริ่มหรือตอบกลับชุดข้อความ