แอป Chat ของคุณจะแสดงตัวอย่างลิงก์ได้โดยแนบการ์ดไปกับข้อความเพื่อให้ข้อมูลเพิ่มเติมและให้ผู้ใช้ดำเนินการจาก Google Chat ได้โดยตรง เพื่อป้องกันไม่ให้ผู้ใช้เปลี่ยนบริบทเมื่อผู้ใช้แชร์ลิงก์ใน Google Chat
ตัวอย่างเช่น สมมติว่าพื้นที่ใน Google Chat ที่มีตัวแทนฝ่ายบริการลูกค้าทั้งหมดของบริษัทเข้ากับแอป Chat ชื่อ Case-y ตัวแทนมักแชร์ลิงก์เคสของฝ่ายบริการลูกค้าในพื้นที่ใน Chat และทุกครั้งที่เพื่อนร่วมงานต้องเปิดลิงก์เคสเพื่อดูรายละเอียด เช่น ผู้ได้รับมอบหมาย สถานะ และเรื่อง ในทำนองเดียวกัน หากผู้ใช้ต้องการเข้าเป็นเจ้าของเคสหรือเปลี่ยนสถานะ ผู้ใช้ก็จะต้องเปิดลิงก์
การแสดงตัวอย่างลิงก์จะทําให้ Case-y ซึ่งแอป Chat ที่ใช้งานอยู่ของพื้นที่ทำงานแนบการ์ดที่แสดงผู้ได้รับมอบหมาย สถานะ และเรื่องได้เมื่อมีคนแชร์ลิงก์เคส ปุ่มบนการ์ดช่วยให้ตัวแทนเข้าเป็นเจ้าของเคสและเปลี่ยนสถานะได้โดยตรงจากสตรีมแชท
วิธีการทํางานของการแสดงตัวอย่างลิงก์
เมื่อมีคนเพิ่มลิงก์ในข้อความ ชิปจะปรากฏขึ้นเพื่อแจ้งให้ทราบว่าแอป Chat อาจดูตัวอย่างลิงก์ดังกล่าว
หลังจากส่งข้อความแล้ว ระบบจะส่งลิงก์ไปยังแอป Chat ซึ่งจะสร้างและแนบการ์ดไว้ในข้อความของผู้ใช้
นอกจากลิงก์แล้ว การ์ดจะให้ข้อมูลเพิ่มเติมเกี่ยวกับลิงก์ ซึ่งรวมถึงองค์ประกอบแบบอินเทอร์แอกทีฟ เช่น ปุ่ม แอปใน Chat จะอัปเดตการ์ดที่แนบมาเพื่อตอบสนองต่อการโต้ตอบของผู้ใช้ได้ เช่น การคลิกปุ่ม
หากผู้ใช้ไม่ต้องการให้แอป Chat แสดงตัวอย่างลิงก์ของตนโดยการแนบการ์ดไปกับข้อความ ผู้ใช้ป้องกันไม่ให้แสดงตัวอย่างได้โดยคลิก
บนชิปตัวอย่าง ผู้ใช้สามารถนำการ์ดที่แนบมาออกได้ทุกเมื่อโดยคลิกนำตัวอย่างออกข้อกำหนดเบื้องต้น
Node.js
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟที่ใช้บริการ HTTP ให้ทำการเริ่มต้นอย่างรวดเร็วนี้ให้เสร็จสมบูรณ์
Apps Script
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟใน Apps Script โปรดกรอกข้อมูลในการเริ่มต้นอย่างรวดเร็วนี้
กำหนดค่าตัวอย่างลิงก์
ลงทะเบียนลิงก์ที่ต้องการ เช่น example.com
, support.example.com
และ support.example.com/cases/
เป็นรูปแบบ URL ในหน้าการกำหนดค่าของแอป Chat ในคอนโซล Google Cloud เพื่อให้แอป Chat แสดงตัวอย่างได้
- เปิดคอนโซล Google Cloud
- ข้าง "Google Cloud" คลิกลูกศรลง แล้วเปิดโปรเจ็กต์ของแอป Chat
- ในช่องค้นหา ให้พิมพ์
Google Chat API
แล้วคลิก Google Chat API - คลิกจัดการ > การกำหนดค่า
- เพิ่มหรือแก้ไขรูปแบบ URL ในส่วนตัวอย่างลิงก์
- หากต้องการกำหนดค่าตัวอย่างลิงก์สำหรับรูปแบบ URL ใหม่ ให้คลิกเพิ่มรูปแบบ URL
- หากต้องการแก้ไขการกำหนดค่าสำหรับรูปแบบ URL ที่มีอยู่ ให้คลิกลูกศรลง
ในช่องรูปแบบโฮสต์ ให้ป้อนโดเมนของรูปแบบ URL แอป Chat จะแสดงตัวอย่างลิงก์ไปยังโดเมนนี้
หากต้องการให้มีลิงก์แสดงตัวอย่างแอปใน Chat สำหรับโดเมนย่อยที่เฉพาะเจาะจง เช่น
subdomain.example.com
ให้ใส่โดเมนย่อยดังกล่าวด้วยหากต้องการให้ลิงก์แสดงตัวอย่างแอป Chat สำหรับทั้งโดเมน ให้ระบุอักขระไวลด์การ์ดที่มีเครื่องหมายดอกจัน (*) เป็นโดเมนย่อย เช่น
*.example.com
ตรงกับsubdomain.example.com
และany.number.of.subdomains.example.com
ในช่องคำนำหน้าเส้นทาง ให้ป้อนเส้นทางที่ต้องการเพิ่มต่อท้ายโดเมนรูปแบบของโฮสต์
หากต้องการจับคู่ URL ทั้งหมดในโดเมนรูปแบบโฮสต์ ให้เว้นคำนำหน้าเส้นทางว่างไว้
ตัวอย่างเช่น หากรูปแบบโฮสต์คือ
support.example.com
เพื่อจับคู่ URL สำหรับกรณีที่โฮสต์ที่support.example.com/cases/
ให้ป้อนcases/
คลิกเสร็จสิ้น
คลิกบันทึก
จากนั้น เมื่อใดก็ตามที่ผู้ใช้มีลิงก์ที่ตรงกับรูปแบบ URL ของตัวอย่างลิงก์ไปยังข้อความในพื้นที่ใน Chat ที่มีแอป Chat ของคุณ แอปจะแสดงตัวอย่างลิงก์นั้น
ดูตัวอย่างลิงก์
หลังจากคุณกำหนดค่าการแสดงตัวอย่างลิงก์สำหรับลิงก์ที่กำหนด แอป Chat จะจดจำและดูตัวอย่างลิงก์ได้โดย เราแนบข้อมูลเพิ่มเติมมาให้ด้วย
พื้นที่ Inside Chat ที่มี
แอป Chat เมื่อข้อความของผู้ใช้มีลิงก์ที่
ตรงกับรูปแบบ URL ของตัวอย่างลิงก์ในแอป Chat
ได้รับ
เหตุการณ์การโต้ตอบ MESSAGE
เหตุการณ์ JSON
เพย์โหลดสำหรับเหตุการณ์การโต้ตอบมีช่อง matchedUrl
:
JSON
"message": {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
ตรวจหาการมีอยู่ของช่อง matchedUrl
ในเหตุการณ์ MESSAGE
เพย์โหลด แอป Chat สามารถเพิ่มข้อมูลลงใน
พร้อมลิงก์ที่แสดงตัวอย่าง แอป Chat ของคุณสามารถทำสิ่งต่อไปนี้
ตอบกลับด้วยข้อความธรรมดาหรือแนบการ์ดก็ได้
ตอบกลับด้วยข้อความ
แอป Chat จะแสดงตัวอย่างลิงก์สำหรับคำตอบแบบง่ายได้ โดยการตอบกลับด้วยข้อความง่ายๆ ไปยังลิงก์ ตัวอย่างนี้แนบข้อความที่กล่าวซ้ำถึง URL ของลิงก์ที่ ตรงกับรูปแบบ URL ของตัวอย่างลิงก์
Node.js
Apps Script
แนบบัตร
วิธีแนบการ์ดกับลิงก์ที่แสดงตัวอย่าง
ส่งคืน
ActionResponse
ประเภท UPDATE_USER_MESSAGE_CARDS
ตัวอย่างนี้มีการแนบการ์ดแบบง่าย
Node.js
Apps Script
ตัวอย่างนี้ส่งข้อความการ์ดโดยการส่งคืน JSON ของการ์ด คุณยังสามารถใช้ บริการการ์ด Apps Script
อัปเดตบัตร
หากต้องการอัปเดตการ์ดที่แนบมากับลิงก์ที่แสดงตัวอย่าง ให้คืนค่า
ActionResponse
ประเภท UPDATE_USER_MESSAGE_CARDS
แอปแชทจะอัปเดตได้เท่านั้น
การ์ดที่แสดงตัวอย่างลิงก์เป็นการตอบกลับ
เหตุการณ์การโต้ตอบของแอป Chat
แอปแชทจะอัปเดตการ์ดเหล่านี้ด้วยการเรียกใช้ Chat API ไม่ได้
แบบไม่พร้อมกัน
การแสดงตัวอย่างลิงก์ไม่รองรับการส่งกลับ ActionResponse
ประเภท UPDATE_MESSAGE
เนื่องจาก UPDATE_MESSAGE
จะอัปเดตทั้งข้อความแทนที่จะอัปเดตเฉพาะการ์ด จึงทำงานได้ก็ต่อเมื่อแอป Chat สร้างข้อความต้นฉบับไว้เท่านั้น การแสดงตัวอย่างลิงก์จะแนบการ์ดไปกับข้อความที่ผู้ใช้สร้างขึ้น แอป Chat จึงไม่มีสิทธิ์อัปเดตการ์ด
หากต้องการให้ฟังก์ชันอัปเดตทั้งการ์ดที่ผู้ใช้สร้างขึ้นและที่แอปสร้างขึ้นในสตรีม Chat ให้ตั้งค่า ActionResponse
แบบไดนามิกโดยขึ้นอยู่กับว่าแอปใน Chat หรือผู้ใช้สร้างข้อความ
- หากผู้ใช้สร้างข้อความ ให้ตั้งค่า
ActionResponse
เป็นUPDATE_USER_MESSAGE_CARDS
- หากแอป Chat สร้างข้อความขึ้น ให้ตั้งค่า
ActionResponse
เป็นUPDATE_MESSAGE
ซึ่งทําได้ 2 วิธี ได้แก่ การระบุและตรวจสอบ actionMethodName
ที่กําหนดเองในฐานะส่วนหนึ่งของพร็อพเพอร์ตี้ onclick
ของการ์ดที่แนบมา (ซึ่งระบุข้อความเป็นที่ผู้ใช้สร้าง) หรือตรวจสอบว่าข้อความสร้างขึ้นโดยผู้ใช้หรือไม่
ตัวเลือกที่ 1: ตรวจหา actionMethodName
หากต้องการใช้ actionMethodName
เพื่อจัดการเหตุการณ์การโต้ตอบ CARD_CLICKED
รายการในการ์ดที่แสดงตัวอย่างอย่างเหมาะสม ให้ตั้งค่า actionMethodName
ที่กำหนดเองเป็นส่วนหนึ่งของพร็อพเพอร์ตี้ onclick
ของการ์ดที่แนบมา ดังนี้
JSON
. . . // Preview card details
{
"textButton": {
"text": "ASSIGN TO ME",
"onClick": {
// actionMethodName identifies the button to help determine the
// appropriate ActionResponse.
"action": {
"actionMethodName": "assign",
}
}
}
}
. . . // Preview card details
เมื่อ "actionMethodName": "assign"
ระบุปุ่มเป็นส่วนหนึ่งของตัวอย่างลิงก์ คุณจะแสดง ActionResponse
ที่ถูกต้องแบบไดนามิกได้โดยการตรวจสอบ actionMethodName
ที่ตรงกัน ดังนี้
Node.js
Apps Script
ตัวอย่างนี้ส่งข้อความการ์ดโดยการส่งคืน JSON ของการ์ด คุณยังสามารถใช้ บริการการ์ด Apps Script
ตัวเลือกที่ 2: ตรวจสอบประเภทผู้ส่ง
ตรวจสอบว่าmessage.sender.type
คือHUMAN
หรือBOT
หากเป็น HUMAN
ให้ตั้งค่า ActionResponse
เป็น UPDATE_USER_MESSAGE_CARDS
หรือตั้งค่า ActionResponse
เป็น UPDATE_MESSAGE
โดยทำดังนี้
Node.js
Apps Script
ตัวอย่างนี้ส่งข้อความการ์ดโดยการส่งคืน JSON ของการ์ด คุณยังสามารถใช้ บริการการ์ด Apps Script
เหตุผลทั่วไปในการอัปเดตการ์ดคือการตอบสนองเมื่อมีการคลิกปุ่ม เรียกคืนปุ่มมอบหมายให้ฉันจากส่วนก่อนหน้านี้ แนบบัตร ตัวอย่างที่สมบูรณ์ต่อไปนี้จะอัปเดตการ์ดให้มีข้อความว่า "คุณ" ได้รับการมอบหมายให้กับ "คุณ" หลังจากที่ผู้ใช้คลิกมอบหมายให้กับฉัน ตัวอย่างนี้จะกำหนด ActionResponse
แบบไดนามิกโดยการตรวจสอบประเภทผู้ส่ง
ตัวอย่างที่สมบูรณ์: กรณี y แอป Chat สำหรับการบริการลูกค้า
โค้ดที่สมบูรณ์ของ Case-y ซึ่งเป็นแอปใน Chat ที่แสดงตัวอย่างลิงก์ไปยังเคสที่แชร์ในพื้นที่ใน Chat ที่ตัวแทนฝ่ายบริการลูกค้าทำงานร่วมกันมีดังนี้
Node.js
Apps Script
ตัวอย่างนี้ส่งข้อความการ์ดโดยการส่งคืน JSON ของการ์ด คุณยังสามารถใช้ บริการการ์ด Apps Script
ข้อจำกัดและข้อควรพิจารณา
โปรดคํานึงถึงขีดจํากัดและข้อควรพิจารณาต่อไปนี้เมื่อกําหนดค่าตัวอย่างลิงก์สําหรับแอป Chat
- แอป Chat แต่ละแอปรองรับการแสดงตัวอย่างลิงก์สําหรับรูปแบบ URL สูงสุด 5 รูปแบบ
- ตัวอย่างแอป Chat จะแสดง 1 ลิงก์ต่อข้อความ หากมีลิงก์ที่สามารถดูตัวอย่างได้หลายลิงก์ในหนึ่งข้อความ จะมีเพียงการแสดงตัวอย่างลิงก์ที่ดูตัวอย่างได้รายการแรกเท่านั้น
- แอปแชทจะแสดงตัวอย่างลิงก์ที่ขึ้นต้นด้วย
https://
เท่านั้น เช่น แสดงตัวอย่างhttps://support.example.com/cases/
แต่support.example.com/cases/
ไม่แสดงตัวอย่าง - หากข้อความไม่มีข้อมูลอื่นๆ ที่ส่งไปยังแอป Chat เช่น คำสั่งเครื่องหมายทับ ระบบจะส่งเฉพาะ URL ของลิงก์ไปยังแอป Chat ด้วยการแสดงตัวอย่างลิงก์
- การ์ดที่แนบมากับลิงก์ตัวอย่างรองรับเฉพาะ
ActionResponse
ประเภทUPDATE_USER_MESSAGE_CARDS
และตอบสนองต่อเหตุการณ์การโต้ตอบของแอป Chat เท่านั้น ตัวอย่างลิงก์ไม่รองรับคำขอUPDATE_MESSAGE
หรือคําขออัปเดตการ์ดแบบไม่พร้อมกันซึ่งแนบไปกับลิงก์ที่แสดงตัวอย่างผ่าน Chat API ดูข้อมูลเพิ่มเติมได้ที่อัปเดตบัตร - แอปแชทต้องแสดงตัวอย่างลิงก์สำหรับทุกคนในพื้นที่ทำงาน
ข้อความต้องไม่มี
privateMessageViewer
ด้วย
แก้ไขข้อบกพร่องในตัวอย่างลิงก์
เมื่อใช้การแสดงตัวอย่างลิงก์ คุณอาจต้องแก้ไขข้อบกพร่องของแอป Chat โดยการอ่านบันทึกของแอป หากต้องการอ่านบันทึก ให้ไปที่ Logs Explorer บนคอนโซล Google Cloud