Odpowiadanie na szybkie polecenia jako aplikacja Google Chat

Z tej strony dowiesz się, jak skonfigurować szybkie polecenia i odpowiadać na nie w aplikacji Google Chat.

Szybkie polecenie to sposób, w jaki użytkownicy mogą wywoływać aplikację Google Chat i wchodzić z nią w interakcję. Aby użyć szybkiego polecenia, otwórz menu integracji, klikając w pokoju lub rozmowie Google Chat, a następnie wybierz polecenie aplikacji, którego nazwa nie zaczyna się od ukośnika (/). Wybranie szybkiego polecenia powoduje bezpośrednie wywołanie aplikacji Google Chat bez konieczności dalszego wprowadzania danych przez użytkownika, co pozwala na szybkie interakcje.

Użytkownicy mogą też wywołać aplikację Google Chat za pomocą polecenia po ukośniku. Instrukcje znajdziesz w artykule Odpowiedzi na polecenia. W porównaniu z poleceniami po ukośniku szybkie polecenia mają w interfejsie Google Chat bardziej przyjazne użytkownikowi nazwy. Są one wywoływane natychmiast po wybraniu i nie wymagają od użytkownika zapamiętywania ani wpisywania nazwy polecenia po ukośniku.

Konfigurowanie szybkiego polecenia w interfejsie Google Chat API

Aby utworzyć szybkie polecenie lub zaktualizować istniejące polecenia po ukośniku, musisz podać informacje o tym poleceniu w konfiguracji aplikacji Google Chat dla interfejsu Google Chat API.

Aby skonfigurować szybkie polecenie w Google Chat API, wykonaj te czynności:

1. W konsoli Google Cloud kliknij Menu menu > Interfejsy API i usługi > Włączone interfejsy API i usługi > Interfejs Google Chat API

   Otwórz stronę interfejsu Google Chat API

2. Kliknij Konfiguracja.

3. W sekcji Polecenia kliknij Dodaj polecenie.

4. Wpisz identyfikator, nazwę, opis i typ polecenia:

   • Identyfikator polecenia: liczba z zakresu 1–1000, której używa aplikacja Google Chat do rozpoznawania polecenia i zwracania odpowiedzi.
   • Nazwa: wyświetlana nazwa polecenia. Nazwy mogą mieć maksymalnie 50 znaków i mogą zawierać znaki specjalne.
     • Używaj krótkich, opisowych i użytecznych słów lub wyrażeń, aby polecenia były zrozumiałe dla użytkownika. Na przykład polecenie Update contact (Zaktualizuj kontakt) służy do modyfikowania rekordu kontaktu.
   • Opis: tekst opisujący działanie polecenia. Opis może mieć maksymalnie 50 znaków i może zawierać znaki specjalne.
     • Opis powinien być krótki i jasny, aby użytkownicy wiedzieli, czego się spodziewać po wywołaniu polecenia.
     • Poinformuj użytkowników, czy aplikacja Google Chat ma odpowiadać wszystkim w pokoju czy tylko użytkownikowi, który wywołał polecenie. Na przykład w przypadku szybkiego polecenia Informacje możesz użyć opisu Dowiedz się więcej o tej aplikacji (widoczne tylko dla Ciebie).
   • Typ polecenia: wybierz Szybkie polecenie.

5. Opcjonalnie: jeśli chcesz, aby aplikacja Google Chat odpowiadała na polecenie za pomocą okna dialogowego, zaznacz pole wyboru Otwórz okno dialogowe.

6. Kliknij Zapisz.

Szybkie polecenie zostało skonfigurowane w aplikacji Google Chat.

Odpowiedź na szybkie polecenie

Gdy użytkownicy wywołują szybkie polecenie, aplikacja Google Chat otrzymuje zdarzenie interakcji APP_COMMAND. Ładunek wydarzenia zawiera obiekt appCommandMetadata z informacjami o wywołanym poleceniu (w tym identyfikator i typ polecenia), aby można było zwrócić odpowiednią odpowiedź.

Poniższy kod pokazuje przykład aplikacji czatu, która odpowiada na polecenie Pomoc, obsługując APP_COMMANDzdarzenia interakcji i wykrywanie, czy ładunek zdarzenia zawiera pasujący identyfikator polecenia. Jeśli dane zdarzenia zawierają identyfikator polecenia, aplikacja Google Chat zwróci wiadomość prywatną:

// Handle the APP_COMMAND event type.
function onAppCommand(event) {
  // Executes the command logic based on its ID.
  // Command IDs are set in the Google Chat API configuration.
  switch (event.appCommandMetadata.appCommandId) {
    case HELP_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

Ustaw HELP_COMMAND_ID za pomocą identyfikatora polecenia określonego podczas konfigurowania szybkiego polecenia w interfejsie Chat API. Aby przetestować ten kod, zapoznaj się z artykułem Testowanie interaktywnych funkcji aplikacji Google Chat. Aby przetestować szybkie polecenie w Google Chat, otwórz menu integracji, klikając Narzędzia Google Workspace add_circle, a następnie wybierz szybkie polecenie.

Przekształcanie dotychczasowych poleceń po ukośniku w szybkie polecenia

Aby zmienić istniejące polecenie po ukośniku na polecenie szybkie, w interfejsie Google Chat API zmień Typ polecenia z Polecenie po ukośniku na Polecenie szybkie.

Gdy użytkownicy wywołują szybkie polecenie, aplikacja Google Chat otrzymuje zdarzenie interakcji APP_COMMAND, a nie zdarzenie interakcji MESSAGE, które jest wysyłane w przypadku poleceń po ukośniku. Zaktualizuj aplikację Google Chat, aby obsługiwała ten typ zdarzenia interakcji, odczytując ładunek zdarzenia zawierający obiekt appCommandMetadata z informacjami o wywołanym poleceniu szybkim. Zobacz Odpowiedź na szybkie polecenie.

Powiązane artykuły

• Odpowiadanie na polecenia po ukośniku
• Wyślij wiadomość
• Wysyłanie wiadomości prywatnych
• Otwieranie interaktywnych dialogów