หากไม่ต้องการให้ผู้ใช้เปลี่ยนบริบทเมื่อแชร์ลิงก์ใน Google Chat แอป Chat จะแสดงตัวอย่างลิงก์ได้โดยแนบการ์ดไปกับข้อความ ซึ่งจะให้ข้อมูลเพิ่มเติมและช่วยให้ผู้ใช้ดำเนินการต่างๆ ได้โดยตรงจาก Google Chat
ตัวอย่างเช่น สมมติว่าพื้นที่ทำงาน Google Chat มีตัวแทนฝ่ายบริการลูกค้าทั้งหมดของบริษัท รวมถึงแอป Chat ที่ชื่อ Case-y ตัวแทนมักจะแชร์ลิงก์ไปยังเคสบริการลูกค้าในพื้นที่ทำงานของ Chat และทุกครั้งที่แชร์ เพื่อนร่วมงานจะต้องเปิดลิงก์เคสเพื่อดูรายละเอียดต่างๆ เช่น ผู้ได้รับมอบหมาย สถานะ และเรื่อง ในทำนองเดียวกัน หากต้องการรับความเป็นเจ้าของเคสหรือเปลี่ยนสถานะ บุคคลนั้นจะต้องเปิดลิงก์
การแสดงตัวอย่างลิงก์ช่วยให้แอป Case-y ซึ่งเป็นแอป Chat ที่อยู่ในพื้นที่ทำงานสามารถแนบการ์ดที่แสดงผู้ได้รับมอบหมาย สถานะ และเรื่องทุกครั้งที่มีคนแชร์ลิงก์เคส ปุ่มบนการ์ดช่วยให้ตัวแทนสามารถรับความเป็นเจ้าของเคสและเปลี่ยนสถานะจากสตรีมแชทได้โดยตรง
วิธีการทำงานของการแสดงตัวอย่างลิงก์
เมื่อมีคนเพิ่มลิงก์ลงในข้อความ ชิปจะปรากฏขึ้นเพื่อแจ้งให้ผู้ใช้ทราบว่าแอป Chat อาจแสดงตัวอย่างลิงก์
หลังจากส่งข้อความแล้ว ระบบจะส่งลิงก์ไปยังแอปแชท จากนั้นแอปจะสร้างและแนบการ์ดไปกับข้อความของผู้ใช้
การ์ดจะแสดงข้อมูลเพิ่มเติมเกี่ยวกับลิงก์ควบคู่ไปกับลิงก์นั้น รวมถึงองค์ประกอบแบบอินเทอร์แอกทีฟ เช่น ปุ่ม แอปแชทจะอัปเดตการ์ดที่แนบมาเพื่อตอบสนองต่อการโต้ตอบของผู้ใช้ เช่น การคลิกปุ่ม
หากไม่ต้องการให้แอป Chat แสดงตัวอย่างลิงก์โดยแนบการ์ดไปกับข้อความ ผู้ใช้สามารถป้องกันการแสดงตัวอย่างได้โดยคลิก
บนชิปแสดงตัวอย่าง ผู้ใช้จะนำการ์ดที่แนบมาออกได้ทุกเมื่อโดยคลิกนำตัวอย่างออกข้อกำหนดเบื้องต้น
Node.js
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ หากต้องการสร้างแอป Chat แบบอินเทอร์แอกทีฟโดยใช้บริการ HTTP ให้ทําตามการเริ่มต้นใช้งานอย่างรวดเร็วนี้
Python
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ หากต้องการสร้างแอป Chat แบบอินเทอร์แอกทีฟโดยใช้บริการ HTTP ให้ทําตามการเริ่มต้นใช้งานอย่างรวดเร็วนี้
Java
แอป 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
ให้ป้อนcases/
เพื่อจับคู่ URL ของเคสที่โฮสต์ที่support.example.com/cases/
คลิกเสร็จสิ้น
คลิกบันทึก
จากนั้นเมื่อมีผู้ใส่ลิงก์ที่ตรงกับรูปแบบ URL ตัวอย่างลิงก์ในข้อความในพื้นที่ใน Chat ที่มีแอป Chat ของคุณ แอปจะแสดงตัวอย่างลิงก์นั้น
ดูตัวอย่างลิงก์
หลังจากกำหนดค่าการแสดงตัวอย่างลิงก์สำหรับลิงก์หนึ่งๆ แล้ว แอปแชทจะจดจำและแสดงตัวอย่างลิงก์ได้โดยแนบข้อมูลเพิ่มเติมไปกับลิงก์
ภายในพื้นที่ใน Chat ที่มีแอป Chat ของคุณ เมื่อข้อความของผู้อื่นมีลิงก์ที่ตรงกับรูปแบบ URL ของตัวอย่างลิงก์ แอป Chat ของคุณจะได้รับเหตุการณ์การโต้ตอบ MESSAGE
พูลข้อมูล JSON สำหรับเหตุการณ์การโต้ตอบมีช่อง matchedUrl
ดังนี้
JSON
message: {
matchedUrl: {
url: "https://support.example.com/cases/case123"
},
... // other message attributes redacted
}
การตรวจสอบว่ามีช่อง matchedUrl
ในเพย์โหลดเหตุการณ์ MESSAGE
หรือไม่จะช่วยให้แอปแชทเพิ่มข้อมูลลงในข้อความที่มีลิงก์ตัวอย่างได้ แอป Chat สามารถตอบกลับด้วยข้อความธรรมดาหรือแนบการ์ดก็ได้
ตอบกลับด้วย SMS
สําหรับคําตอบพื้นฐาน แอป Chat สามารถแสดงตัวอย่างลิงก์โดยตอบกลับด้วยข้อความธรรมดาไปยังลิงก์ ตัวอย่างนี้แนบข้อความที่ซ้ำ URL ของลิงก์ซึ่งตรงกับรูปแบบ URL ของตัวอย่างลิงก์
Node.js
Python
Java
Apps Script
แนบการ์ดที่แสดงตัวอย่างลิงก์
หากต้องการแนบการ์ดกับลิงก์ที่แสดงตัวอย่าง ให้แสดงผลActionResponse
ประเภท UPDATE_USER_MESSAGE_CARDS
ตัวอย่างนี้แนบการ์ดพื้นฐาน
Node.js
Python
Java
Apps Script
ตัวอย่างนี้จะส่งข้อความการ์ดโดยแสดงcard JSON นอกจากนี้ คุณยังใช้บริการการ์ด Apps Script ได้ด้วย
อัปเดตการ์ดตัวอย่างลิงก์
แอป Chat สามารถอัปเดตการ์ดตัวอย่างลิงก์เมื่อผู้ใช้โต้ตอบกับการ์ด เช่น คลิกปุ่มบนการ์ด
หากต้องการอัปเดตการ์ด แอป Chat ของคุณต้องจัดการเหตุการณ์การโต้ตอบ CARD_CLICKED
และแสดงผล actionResponse
โดยอิงตามผู้ส่งข้อความที่มีตัวอย่างลิงก์ ดังนี้
- หากผู้ใช้ส่งข้อความ ให้ตั้งค่า
actionResponse.type
เป็นUPDATE_USER_MESSAGE_CARDS
- หากแอป Chat ส่งข้อความ ให้ตั้งค่า
actionResponse.type
เป็นUPDATE_MESSAGE
หากต้องการระบุว่าใครส่งข้อความ ให้ใช้ช่อง message.sender.type
ของเหตุการณ์การโต้ตอบเพื่อดูว่าผู้ส่งเป็นผู้ใช้ HUMAN
หรือ BOT
ตัวอย่างต่อไปนี้แสดงวิธีที่แอป Chat อัปเดตตัวอย่างลิงก์ทุกครั้งที่ผู้ใช้คลิกปุ่มมอบหมายให้ฉันโดยการอัปเดตฟิลด์ผู้ได้รับมอบหมายของการ์ดและปิดใช้ปุ่ม
Node.js
Python
Java
Apps Script
ตัวอย่างนี้จะส่งข้อความการ์ดโดยแสดงcard JSON นอกจากนี้ คุณยังใช้บริการการ์ด Apps Script ได้ด้วย
ข้อจำกัดและข้อควรพิจารณา
เมื่อกำหนดค่าตัวอย่างลิงก์สำหรับแอป Chat โปรดคำนึงถึงข้อจำกัดและข้อควรพิจารณาต่อไปนี้
- แอป Chat แต่ละแอปรองรับการแสดงตัวอย่างลิงก์สำหรับรูปแบบ URL ได้สูงสุด 5 รูปแบบ
- แอป Chat จะแสดงตัวอย่างลิงก์ 1 รายการต่อข้อความ หากมีลิงก์ที่แสดงตัวอย่างได้หลายรายการในข้อความเดียว ระบบจะแสดงตัวอย่างเฉพาะลิงก์แรกที่แสดงตัวอย่างได้
- แอปแชทจะแสดงตัวอย่างเฉพาะลิงก์ที่ขึ้นต้นด้วย
https://
ดังนั้นhttps://support.example.com/cases/
จึงแสดงตัวอย่าง แต่support.example.com/cases/
จะไม่แสดง - เว้นแต่ข้อความจะมีข้อมูลอื่นๆ ที่ส่งไปยังแอป Chat เช่น คำสั่งเครื่องหมายทับ ระบบจะส่งเฉพาะ URL ของลิงก์ไปยังแอป Chat ผ่านตัวอย่างลิงก์
- หากผู้ใช้โพสต์ลิงก์ แอป Chat จะอัปเดตการ์ดตัวอย่างลิงก์ได้ก็ต่อเมื่อผู้ใช้โต้ตอบกับการ์ด เช่น คลิกปุ่ม คุณจะเรียกใช้เมธอด
update()
ของ Chat API ในแหล่งข้อมูลMessage
เพื่ออัปเดตข้อความของผู้ใช้แบบไม่พร้อมกันไม่ได้ - แอปแชทต้องแสดงตัวอย่างลิงก์ให้ทุกคนในพื้นที่ทำงานเห็น ดังนั้นข้อความต้องไม่มีช่อง
privateMessageViewer
แก้ไขข้อบกพร่องของตัวอย่างลิงก์
เมื่อใช้ตัวอย่างลิงก์ คุณอาจต้องแก้ไขข้อบกพร่องของแอปแชทโดยอ่านบันทึกของแอป หากต้องการอ่านบันทึก ให้ไปที่ Logs Explorer ในคอนโซล Google Cloud