Google Chat uygulaması olarak hızlı komutlara yanıt verme

Bu sayfada, Google Chat uygulamanız için hızlı komutları nasıl ayarlayacağınız ve bu komutlara nasıl yanıt vereceğiniz açıklanmaktadır.

Hızlı komut, kullanıcıların Chat uygulamasını çağırıp bu uygulamayla etkileşime geçmesinin bir yoludur. Hızlı komut kullanmak için bir Chat alanında veya görüşmede Google Workspace Araçları'nı tıklayarak entegrasyon menüsünü açın ve ardından adı eğik çizgiyle (/) başlamayan bir uygulama komutu seçin. Hızlı komut seçtiğinizde Chat uygulaması, kullanıcıdan başka giriş alınmadan doğrudan çağrılır ve kullanıcının hızlı bir şekilde etkileşim kurması sağlanır.

Kullanıcılar, Chat uygulamasını eğik çizgi komutu ile de çağırabilir. Adımlar için Eğik çizgi komutlarına yanıt verme başlıklı makaleyi inceleyin. Eğik çizgi komutlarına kıyasla hızlı komutlar, Chat kullanıcı arayüzünde daha kullanıcı dostu bir adla biçimlendirilir, seçildikten hemen sonra çağrılır ve kullanıcının eğik çizgi komutunun adını hatırlamasını veya yazmasını gerektirmez.

Hızlı komutlar içeren entegrasyon menüsü
Şekil 1: Chat uygulamasına yönelik hızlı komutları içeren entegrasyon menüsü.

Google Chat API'de hızlı komut oluşturma

Hızlı komut oluşturmak veya mevcut eğik çizgi komutlarını hızlı komutlarla güncellemek için Chat uygulamanızın Google Chat API yapılandırmasında komutla ilgili bilgileri belirtmeniz gerekir.

Google Chat API'de hızlı komut yapılandırmak için aşağıdaki adımları uygulayın:

  1. Google Cloud Console'da Menü > API'ler ve Hizmetler > Etkin API'ler ve Hizmetler > Google Chat API'yi tıklayın.

    Google Chat API sayfasına gidin

  2. Yapılandırma'yı tıklayın.

  3. Komutlar bölümünde Komut ekle'yi tıklayın.

  4. Komut için bir komut kimliği, ad, açıklama ve komut türü girin:

    • Komut kimliği: Chat uygulamanızın komutu tanıyıp yanıt döndürmek için kullandığı 1 ile 1.000 arasında bir sayı.
    • Ad: Komutun görünen adı. Adlar en fazla 50 karakter uzunluğunda olabilir ve özel karakterler içerebilir.
      • Komutların kullanıcı için net olmasını sağlamak amacıyla kısa, açıklayıcı ve uygulanabilir kelimeler veya kelime öbekleri kullanın. Örneğin, bir kişi kaydını değiştiren bir komut için Kişiyi güncelle'yi kullanın.
    • Açıklama: Komutun ne yaptığını açıklayan metin. Açıklamalar en fazla 50 karakter olabilir ve özel karakterler içerebilir.
      • Kullanıcıların komutu çağırdığında ne beklemeleri gerektiğini bilmesi için açıklamayı kısa ve net tutun.
      • Chat uygulamasının alandaki herkese mi yoksa komutu çağıran kullanıcıya özel olarak mı yanıt vereceğini kullanıcılara bildirin. Örneğin, Hakkında hızlı komutunu Bu uygulama hakkında bilgi edinin (Yalnızca size görünür) olarak tanımlayabilirsiniz.
    • Komut türü: Hızlı komut'u seçin.

  5. İsteğe bağlı: Chat uygulamanızın komuta iletişim kutusu ile yanıt vermesini istiyorsanız İletişim kutusu aç onay kutusunu işaretleyin.

  6. Kaydet'i tıklayın.

Hızlı komut artık Chat uygulaması için yapılandırılmıştır.

Hızlı komutlara yanıt verme

Kullanıcılar hızlı komut çağrığında Chat uygulamanız bir APP_COMMAND etkileşim etkinliği alır. Etkinlik yükü, uygun bir yanıt döndürebilmeniz için çağrılan komutla ilgili ayrıntıları (komut kimliği ve komut türü dahil) içeren appCommandMetadata nesnesini içerir.

Aşağıdaki kodda, APP_COMMAND etkileşim etkinliklerini işleyerek ve etkinlik yükündeki komut kimliğinin eşleşip eşleşmediğini tespit ederek Yardım komutuna yanıt veren bir Chat uygulaması örneği gösterilmektedir. Etkinlik yükü komut kimliğini içeriyorsa Chat uygulaması özel bir mesaj döndürür:

Apps Komut Dosyası 

// 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.'
      };
  }
}

HELP_COMMAND_ID değerini, Chat API'de hızlı komutu yapılandırırken belirttiğiniz komut kimliğiyle ayarlayın. Bu kodu test etmek için Google Chat uygulamaları için etkileşimli özellikleri test etme başlıklı makaleyi inceleyin. Chat'te hızlı komutları test etmek için Google Workspace Araçları'nı tıklayıp hızlı komutunuzu seçerek entegrasyon menüsünü açın.

Mevcut eğik çizgi komutlarını hızlı komutlara dönüştürme

Mevcut bir eğik çizgi komutunu hızlı komuta dönüştürmek için Google Chat API'de Komut türü'nü Eğik çizgi komutu yerine Hızlı komut olarak değiştirerek eğik çizgi komutunu düzenleyin.

Kullanıcılar hızlı komutu çağrdığında Chat uygulamanız, eğik çizgi komutları için gönderilen MESSAGE etkileşim etkinliği yerine APP_COMMAND etkileşim etkinliği alır. Çağrılan hızlı komutla ilgili ayrıntıları içeren appCommandMetadata nesnesini içeren etkinlik yükünü okuyarak Chat uygulamanızı bu etkileşim etkinliği türünü işleyecek şekilde güncelleyin. Hızlı komutlara yanıt verme başlıklı makaleyi inceleyin.