Começar a usar pessoas e espaços com uma integração útil

Integre pessoas e espaços ao seu app de chat com uma mensagem de boas-vindas que detalha o que o app faz e como as pessoas podem trabalhar melhor com ele. A mensagem de integração é a primeira que muitas pessoas recebem no Google Chat do seu app, e você recebe apenas uma primeira impressão.

Escreva mensagens de integração eficazes

Uma mensagem de integração eficaz informa aos usuários o que o app faz, como eles podem trabalhar com o app e como podem saber mais sobre ele ou receber ajuda.

Uma mensagem de integração eficaz é estruturada assim:

• Diga olá. Se você estiver enviando uma mensagem para uma pessoa pela primeira vez, provavelmente comece com "olá".
• Descrever o que o app Chat faz em uma ou duas frases Apresente o app de chat dizendo às pessoas o que elas podem fazer. As pessoas podem usar seu app em outros lugares, como em um app para dispositivos móveis ou Web, e talvez seja a primeira vez que o veem no Google Chat. Ou talvez seja a primeira vez que eles veem seu app. Portanto, inclua uma descrição detalhada.
• Diga às pessoas como começar. Por exemplo, sugira um ou dois comandos comuns. Agora que as pessoas sabem o que o app faz, diga a eles como trabalhar. Se o app exigir configuração ou autorização, esse é um bom lugar para pedir que as pessoas concluam o processo de configuração.
• Explicar como receber ajuda e enviar feedback Encerre a mensagem informando às pessoas como elas podem receber ajuda ou enviar feedback. Isso pode ser simples como botões com o rótulo "Ajuda" e "Feedback", mas você pode indicar como eles podem receber ajuda se precisarem no futuro, por exemplo, usando um comando de barra /help.

O que deve ser evitado

Há algumas coisas que as mensagens de integração nunca devem fazer:

• Não mencione todo mundo em um espaço. Se o app Chat mencionar todas as pessoas em um espaço, elas vão ser irritantes, e ele vai perceber que o app é spam.
• Não escreva mensagens de integração longas. As pessoas não leem mensagens muito longas. Se você escrever uma mensagem de integração muito longa, considere mover os detalhes para um comando de ajuda.
• Não presuma que as pessoas sabem o que o app faz. Apresente aos usuários a funcionalidade do app de chat como se esta fosse a primeira vez que eles trabalham com seu app.

Exemplo de mensagem de integração: app Scheduler

A mensagem de integração do app programador prepara os usuários para o sucesso. Ele é amigável, descreve o que o app Scheduler pode fazer e diz a ele como saber mais ou receber ajuda.

Enviar uma mensagem de integração

Para enviar uma mensagem de integração, o app responde ao evento ADDED_TO_SPACE da API Chat, que é recebido sempre que ele é adicionado a um espaço do Chat.

O exemplo de JSON a seguir mostra o corpo da solicitação para um evento 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": "[e-mail]"
  }
}

Responda ao evento ADDED_TO_SPACE com uma mensagem de integração eficaz:

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`.'
  }
}