Giúp con người và không gian bắt đầu bằng cách làm quen với ứng dụng

Đưa mọi người và không gian vào ứng dụng Chat bằng tin nhắn chào mừng nêu chi tiết chức năng của ứng dụng Chat và cách mọi người có thể làm việc tốt nhất với ứng dụng đó. Tin nhắn giới thiệu là tin nhắn đầu tiên mà nhiều người trong Google Chat nhận được từ ứng dụng của bạn, và bạn chỉ nhận được một lượt hiển thị đầu tiên, vì vậy hãy tận dụng tính năng này!

Viết tin nhắn giới thiệu hiệu quả

Thông báo giới thiệu hiệu quả cho người dùng biết chức năng của ứng dụng, cách họ có thể làm việc với ứng dụng và cách họ có thể tìm hiểu thêm về ứng dụng hoặc nhận trợ giúp.

Một thông báo giới thiệu hiệu quả có cấu trúc như sau:

  • Xin chào. Nếu đây là lần đầu tiên nhắn tin cho một người, thì có thể bạn sẽ bắt đầu bằng lời chào "xin chào"!
  • Mô tả chức năng của ứng dụng Chat trong 1 đến 2 câu. Hãy giới thiệu ứng dụng Chat của bạn bằng cách cho mọi người biết ứng dụng này có thể giúp họ làm gì. Mọi người có thể sử dụng ứng dụng của bạn ở nơi khác, chẳng hạn như trên ứng dụng dành cho thiết bị di động hoặc web và đây có thể là lần đầu tiên họ thấy ứng dụng đó trong Google Chat. Hoặc đây có thể là lần đầu tiên họ xem ứng dụng của bạn. Vì vậy, hãy nhớ đưa ra nội dung mô tả đầy đủ.
  • Cho mọi người biết cách bắt đầu. Ví dụ: đề xuất một hoặc hai lệnh phổ biến. Giờ đây, khi người dùng đã biết ứng dụng của bạn làm gì, hãy hướng dẫn họ cách làm việc với ứng dụng. Nếu ứng dụng yêu cầu cấu hình hoặc uỷ quyền, thì đây là cách phù hợp để nhắc mọi người hoàn tất quá trình thiết lập.
  • Giải thích cách yêu cầu trợ giúp và cách gửi ý kiến phản hồi. Kết thúc thông báo bằng cách cho mọi người biết cách giúp đỡ hoặc đưa ra ý kiến phản hồi. Điều này có thể đơn giản như các nút có nhãn "Trợ giúp" và "Phản hồi", nhưng bạn có thể muốn cho biết cách họ có thể nhận trợ giúp nếu họ cần đến trong tương lai, chẳng hạn như thông qua lệnh dấu gạch chéo /help.

Những điều nên tránh

Có một số việc mà tin nhắn giới thiệu không bao giờ được làm:

  • Không đề cập đến mọi người trong không gian. Nếu ứng dụng Chat của bạn đề cập đến mọi người trong một không gian, thì họ sẽ làm phiền họ và họ sẽ xem ứng dụng của bạn là tin nhắn rác.
  • Không viết thông báo giới thiệu dài. Mọi người không đọc tin nhắn quá dài. Nếu bạn thấy mình viết thông báo giới thiệu rất dài, hãy cân nhắc di chuyển thông tin chi tiết vào lệnh trợ giúp.
  • Đừng cho rằng mọi người biết chức năng của ứng dụng. Giới thiệu cho người dùng chức năng của ứng dụng Chat như thể đây là lần đầu tiên họ làm việc với ứng dụng của bạn.

Ví dụ về thông báo giới thiệu: Ứng dụng trình lập lịch biểu

Thông báo giới thiệu ứng dụng Scheduler chuẩn bị cho người dùng thành công. Tính năng này thân thiện, mô tả những việc mà ứng dụng Scheduler có thể làm và cho trẻ biết cách tìm hiểu thêm hoặc được trợ giúp.

Ví dụ về thông báo giới thiệu.

Gửi tin nhắn giới thiệu

Để gửi tin nhắn giới thiệu, ứng dụng của bạn phản hồi sự kiện ADDED_TO_SPACE từ API Chat. Ứng dụng này nhận được mỗi khi được thêm vào phòng Chat.

Ví dụ JSON sau đây thể hiện nội dung yêu cầu cho một sự kiện ADDED_TO_SPACE:

JSON

{
  "type": "ADDED_TO_SPACE",
  "eventTime": "2017-03-02T19:02:59.910959Z",

  // "space" provides details about the chat space the app was added to.
  "space": {
    "name": "spaces/AAAAAAAAAAA",
    "displayName": "Customer Support Superstars",
    "type": "ROOM"
  },

  // "user" provides details about the user who added the app to the space.
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Izumi",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "izumi@example.com"
  }
}

Phản hồi sự kiện ADDED_TO_SPACE bằng thông báo giới thiệu hiệu quả:

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if(req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Scheduler at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat api.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Scheduler at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}