เชื่อมต่อแอป Chat กับบริการและเครื่องมืออื่นๆ

หน้านี้จะอธิบายวิธีเชื่อมต่อแอป Google Chat กับบริการ หรือเครื่องมือที่อยู่นอก Google Chat แม้ว่าแอป Chat แต่มีประสิทธิภาพในตัวเอง มักจะทำงานร่วมกับระบบอื่นๆ และต้องใช้ แอปพลิเคชันที่ใช้ร่วมกันเพื่อเชื่อมต่อบัญชี ให้สิทธิ์การเข้าถึงข้อมูล การแสดงผล ข้อมูลเพิ่มเติม หรือกำหนดค่ากำหนดของผู้ใช้

ข้อกำหนดเบื้องต้น

แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟ ทำตามการเริ่มต้นใช้งานอย่างรวดเร็วต่อไปนี้ เกี่ยวกับสถาปัตยกรรมแอปที่คุณต้องการใช้

ขอการกําหนดค่าแอปใน Chat จากผู้ใช้

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

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

การดำเนินการนี้จะบอกให้ Google Chat แสดงข้อความแจ้งส่วนตัวแก่ผู้ใช้ CONFIGURATION_URL เป็นลิงก์ เพื่อให้ผู้ใช้เข้าชมเพื่อตรวจสอบสิทธิ์เพิ่มเติม ให้สิทธิ์ หรือ การกำหนดค่า การตอบกลับ REQUEST_CONFIG แยกออกจากกัน ข้อความตอบกลับ โดยระบบจะไม่สนใจข้อความ การ์ด หรือแอตทริบิวต์อื่นๆ

ดำเนินการตามคำขอกำหนดค่าให้เสร็จสมบูรณ์

ทุก เหตุการณ์การโต้ตอบ MESSAGE เหตุการณ์ ที่แอป Chat ได้รับจะรวมฟิลด์ configCompleteRedirectUrl คุณต้องเข้ารหัส URL นี้ใน URL การกำหนดค่าที่จะใช้เมื่อเสร็จสิ้นกระบวนการ กำลังเปลี่ยนเส้นทาง URL ส่งสัญญาณให้ Google Chat ทราบว่ามีการดำเนินการตามคำขอการกำหนดค่าแล้ว

เมื่อแอป Chat เริ่มทำงาน ขั้นตอนจะขึ้นอยู่กับ ได้รับข้อความที่ระบุ ในการตอบกลับข้อความ เช่น @app help แอป Chat ควรตอบกลับด้วยข้อความโดยไม่มี ต้องมีการกำหนดค่าเพิ่มเติม

เมื่อระบบเปลี่ยนเส้นทางผู้ใช้ไปยัง configCompleteRedirectUrl เรียบร้อยแล้ว ที่ระบุไว้ในข้อความต้นฉบับ Google Chat จะดําเนินการตามขั้นตอนต่อไปนี้

  1. ลบข้อความแจ้งที่แสดงต่อผู้ใช้ที่เริ่มดำเนินการ
  2. แปลงข้อความต้นฉบับให้เป็นสาธารณะ เพื่อให้สมาชิกคนอื่นๆ มองเห็น พื้นที่ทำงาน
  3. ส่งข้อความต้นฉบับไปยังแอป Chat เดียวกัน เป็นครั้งที่ 2

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

เมื่อมีการส่งเหตุการณ์การโต้ตอบ MESSAGE ซ้ำในลักษณะนี้ เหตุการณ์ดังกล่าวควรจะเหมือนกัน กับกิจกรรมเดิม แต่ก็มีบางสถานการณ์ที่ MESSAGE เหตุการณ์การโต้ตอบอาจแตกต่างกัน ตัวอย่างเช่น เมื่อข้อความกล่าวถึง แอปแชท ก. และแอปแชท ข. ผู้ใช้จะแก้ไขข้อความได้หากแอป Chat A ตอบกลับด้วยข้อความปกติก่อนตรวจสอบสิทธิ์กับ แอปแชท ข ในกรณีนี้ แอปแชท B ได้รับข้อความที่แก้ไขแล้วหลังจาก ผู้ใช้ตรวจสอบสิทธิ์และกำหนดค่าเรียบร้อยแล้ว

ตรวจสอบสิทธิ์ของผู้ใช้ Chat ภายนอก Chat

ในบางกรณี เช่น การขอสิทธิ์ OAuth สำหรับ API แอปของคุณต้องใช้ เพื่อลิงก์ไปยัง URL นอก Chat ขณะที่ยังคงรักษาผู้ใช้ไว้ ตัวตน วิธีที่ดีที่สุดในการระบุผู้ใช้ในกรณีเหล่านี้คือการป้องกัน แอปปลายทางที่มี Google Sign-in

ใช้เมนู โทเค็นข้อมูลประจำตัว ออกระหว่างการลงชื่อเข้าใช้เพื่อรับรหัสผู้ใช้ การอ้างสิทธิ์ sub มีข้อมูล และเชื่อมโยงกับ User-ID จาก Google Chat ได้

แม้ว่ารหัสทั้งสองจะไม่ได้เหมือนกันทุกประการ แต่ก็สามารถปรับเปลี่ยนได้ ถึง เปลี่ยนค่าของการอ้างสิทธิ์ sub ให้เป็นusers/{user}ใน Google Chat เพิ่ม ค่าที่มี users/ เช่น ค่าการอ้างสิทธิ์ 123 เทียบเท่ากับ ชื่อผู้ใช้ users/123 ในข้อความถึง แอป Chat