Kullanıcı etkileşimlerini alın ve yanıtlayın

Bu sayfada, Google Chat uygulamanızın Google Chat uygulaması etkileşim etkinlikleri olarak da bilinen kullanıcı etkileşimlerini nasıl alabileceği ve bunlara nasıl yanıt verebileceği açıklanmaktadır.

Bu sayfada aşağıdakilerin nasıl yapılacağı açıklanmaktadır:

• Chat uygulamanızı, etkileşim etkinliklerini alacak şekilde yapılandırın.
• Etkileşim etkinliğini altyapınızda işleyin.
• Uygun durumlarda etkileşim etkinliklerine yanıt verin.

Ön koşullar

Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Etkileşimli bir Chat uygulaması oluşturmak için, kullanmak istediğiniz uygulama mimarisine bağlı olarak aşağıdaki hızlı başlangıç adımlarından birini tamamlayın:

• Google Cloud Functions ile HTTP hizmeti
• Google Apps Komut Dosyası
• Google Cloud Dialogflow CX
• Google Cloud Pub/Sub

Etkileşim etkinliği türleri

Google Chat uygulaması etkileşim etkinliği, kullanıcının bir Chat uygulamasını çağırmak veya uygulamayla etkileşimde bulunmak için gerçekleştirdiği herhangi bir işlemi (ör. bir Chat uygulamasından @bahsetme veya uygulamayı bir alana ekleme) temsil eder.

Kullanıcılar bir Chat uygulamasıyla etkileşime geçtiğinde Google Chat, Chat API'de Event türü olarak temsil edilen bir etkileşim etkinliği gönderir. Chat uygulaması, etkileşimi işlemek için etkinliği kullanabilir ve isteğe bağlı olarak bir mesajla yanıt verebilir.

Google Chat, her kullanıcı etkileşimi türü için farklı bir etkileşim etkinliği gönderir. Bu, Chat uygulamanızın her etkinlik türünü uygun şekilde işlemesine yardımcı olur. Etkileşim etkinliğinin türü, eventType nesnesi kullanılarak temsil edilir.

Örneğin Google Chat, kullanıcının Chat uygulamasını bir alana eklediği her etkileşim için ADDED_TO_SPACE etkinlik türünü kullanır. Böylece Chat uygulaması hemen alanda bir karşılama mesajıyla yanıt verebilir.

Aşağıdaki tabloda, yaygın kullanıcı etkileşimleri, Chat uygulamalarının aldığı etkileşim etkinliği türü ve Chat uygulamalarının genellikle nasıl yanıt verdiği gösterilmektedir:

Desteklenen tüm etkileşim etkinliklerini görmek için EventType referans dokümanlarını inceleyin.

İletişim kutularındaki etkileşim etkinlikleri

Chat uygulamanız iletişim kutuları açıyorsa etkileşim etkinliği, yanıtı işlemek için kullanabileceğiniz aşağıdaki ek bilgileri içerir:

• isDialogEvent true olarak ayarlandı.
• DialogEventType, etkileşimin bir iletişim kutusunu açma, iletişim kutusunu açma, bir iletişim kutusundan bilgi gönderme veya iletişim kutusunu kapatma işlemlerini tetikleyip tetiklemediğini netleştirir.

Aşağıdaki tabloda, iletişim kutularıyla yapılan yaygın etkileşimler, ilgili iletişim kutusu etkinlik türleri ve sohbet uygulamalarının genellikle nasıl yanıt verdiği açıklanmaktadır:

Daha fazla bilgi için Etkileşimli iletişim kutularını açma başlıklı makaleye bakın.

Chat uygulaması etkileşim etkinliklerini alma

Bu bölümde, Chat uygulamanız için etkileşim etkinliklerinin nasıl alınacağı ve işleneceği açıklanmaktadır.

Chat uygulamanızı etkileşim etkinliklerini alacak şekilde yapılandırma

Tüm Chat uygulamaları etkileşimli değildir. Örneğin, gelen webhook'lar yalnızca giden mesajlar gönderebilir ve kullanıcılara yanıt veremez. Etkileşimli bir Chat uygulaması oluşturuyorsanız Chat uygulamanızın etkileşim etkinliklerini almasına, işlemesine ve yanıtlamasına olanak tanıyan bir uç nokta seçmeniz gerekir. Chat uygulamanızı tasarlama hakkında daha fazla bilgi edinmek için Chat uygulamaları uygulama yapıları başlıklı makaleyi inceleyin.

Oluşturmak istediğiniz her etkileşimli özellik için Chat API'deki yapılandırmanızı güncellemeniz gerekir. Böylece Google Chat, ilgili etkileşim etkinliklerini Chat uygulamanıza gönderebilir:

1. Google Cloud Console'da Chat API sayfasına gidin ve Yapılandırma sayfasını tıklayın:

   Chat API Yapılandırması sayfasına gidin

2. Etkileşimli özellikler bölümünde ayarları inceleyin ve oluşturmak istediğiniz özelliklere göre güncelleyin:

   Alan	Açıklama
   İşlevsellik	Zorunlu. Chat uygulamasının kullanıcılarla nasıl etkileşime geçebileceğini belirleyen bir alan grubu: Bire bir mesaj alma: Kullanıcılar Chat uygulamasını doğrudan Google Chat'te bulup mesaj gönderebilir. Alanlara ve grup görüşmelerine katılma: Kullanıcılar Chat uygulamasını alanlara ve grup görüşmelerine ekleyebilir.
   Bağlantı ayarları	Zorunlu. Chat uygulamasının uç noktası. Aşağıdakilerden biri olmalıdır: HTTP uç noktası URL'si: Chat uygulaması uygulamasını barındıran bir HTTPS uç noktası. Apps Komut Dosyası: Bir Chat uygulamasını uygulayan Apps Komut Dosyası projesinin dağıtım kimliği. Cloud Pub/Sub konu adı: Chat uygulamasının uç nokta olarak abone olduğu bir Pub/Sub konusu. Dialogflow: Chat uygulamasını Dialogflow entegrasyonuyla kaydeder. Daha fazla bilgi için Doğal dili anlayan bir Dialogflow Google Chat uygulaması derleme başlıklı makaleyi inceleyin.
   Slash komutları	İsteğe bağlı. Google Chat'te kullanıcılara gösterilebilecek komutlar. Kullanıcıların Google Chat'te Chat uygulamanızın temel işlemlerini görmesine ve etkileşimde bulunmak istedikleri belirli bir işlemi seçmesine olanak tanır. Daha fazla bilgi için Eğik çizgi komutlarına Chat uygulaması olarak yanıt verme başlıklı makaleyi inceleyin.
   Bağlantı önizlemeleri	İsteğe bağlı. Kullanıcılar bağlantı gönderdiğinde Chat uygulamasının tanıdığı ve ek içerik sağladığı URL kalıpları. Daha fazla bilgi için Önizleme bağlantıları konusuna bakın.
   Görünürlük	İsteğe bağlı. Chat uygulamanızı görüntüleyip yükleyebilecek en fazla beş kullanıcı veya bir veya daha fazla Google grubu. Chat uygulamanızı test etmek ya da ekibinizle paylaşmak için bu alanı kullanın. Daha fazla bilgi için Etkileşimli özellikleri test etme konusuna bakın.

3. Kaydet'i tıklayın. Chat uygulaması yapılandırmasını kaydettiğinizde Chat uygulamanız, Google Workspace kuruluşunuzdaki belirtilen kullanıcılar tarafından kullanılabilir.

Chat uygulamanız artık Google Chat'ten etkileşim etkinlikleri alacak şekilde yapılandırılmıştır.

Hizmetinize yapılan HTTP çağrısı yeniden denemelerini işleme

Hizmetinize gönderilen bir HTTPS isteği başarısız olursa (ör. zaman aşımı, geçici ağ hatası veya 2xx olmayan bir HTTPS durum kodu) Google Chat, sunmayı birkaç dakika içinde birkaç kez yeniden deneyebilir (ancak bu garanti edilmez). Sonuç olarak, Chat uygulaması belirli durumlarda aynı mesajı birkaç kez alabilir. İstek başarıyla tamamlanır ancak geçersiz bir mesaj yükü döndürürse Google Chat, isteği yeniden denemez.

Etkileşim etkinliklerini işleme veya yanıtlama

Bu bölümde, Google Chat uygulamalarının etkileşim etkinliklerini nasıl işleyebileceği ve bunlara nasıl yanıt verebileceği açıklanmaktadır.

Chat uygulamanız Google Chat'ten bir etkileşim etkinliği aldıktan sonra birçok şekilde yanıt verebilir. Etkileşimli Chat uygulamaları çoğu durumda kullanıcıya bir mesajla yanıt verir. Google Chat uygulaması, bir veri kaynağından bazı bilgileri arayabilir, etkileşim etkinliği bilgilerini kaydedebilir veya başka herhangi bir şeyi yapabilir. Google Chat uygulamasının temelini bu işleme davranışı oluşturur.

Sohbet uygulamasının senkronize yanıt vermesi için 30 saniye içinde yanıt vermesi ve yanıtın etkileşimin gerçekleştiği alanda yayınlanması gerekir. Aksi takdirde Chat uygulaması eşzamansız olarak yanıt verebilir.

Sohbet uygulamaları, her etkileşim etkinliği için etkinliği temsil eden JSON yükü olan bir istekte bulunma gövdesi alır. Bu bilgileri kullanarak yanıtları işleyebilirsiniz. Etkinlik yükü örnekleri için Chat uygulaması etkileşim etkinliklerinin türleri bölümüne bakın.

Aşağıdaki şemada, Google Chat uygulamasının genellikle farklı etkileşim etkinliklerini nasıl işlediği veya bunlara nasıl yanıt verdiği gösterilmektedir:

Anlık olarak yanıtla

Etkileşim etkinlikleri, Chat uygulamalarının gerçek zamanlı olarak veya eş zamanlı olarak yanıt vermesine olanak tanır. Senkron yanıtlar için kimlik doğrulama gerekmez.

Gerçek zamanlı yanıt vermek için Chat uygulamasının bir Message nesnesi döndürmesi gerekir. Alanda mesajla yanıt vermek için Message nesnesi text, cardsV2 ve accessoryWidgets nesneleri içerebilir. Diğer yanıt türleriyle kullanmak için aşağıdaki kılavuzları inceleyin:

• Etkileşimli iletişim kutuları açma
• Bağlantıları önizleme
• Kullanıcılar tarafından gönderilen işlem bilgileri

Mesajla yanıtla

Bu örnekte, Chat uygulamanız bir alana eklendiğinde kısa mesaj oluşturup gönderir. Kullanıcıları uygulamanıza ilk katılımla ilgili en iyi uygulamalar hakkında bilgi edinmek için Kullanıcıların Chat uygulamanıza ilk katılımını sağlama başlıklı makaleyi inceleyin.

Bir kullanıcı Chat uygulamanızı bir alana eklediğinde kısa mesaj göndermek için Chat uygulamanız bir ADDED_TO_SPACE etkileşim etkinliğine yanıt verir. ADDED_TO_SPACE etkileşim etkinliklerine kısa mesajla yanıt vermek için aşağıdaki kodu kullanın:

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object 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, Cymbal 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`.'
    });
  }
};

/**
 * 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, Cymbal 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`.'
  }
}

Kod örneği aşağıdaki kısa mesajı döndürür:

Eşzamansız olarak yanıtla

Chat uygulamaları bazen 30 saniye sonra bir etkileşim etkinliğine yanıt vermelidir veya etkileşim etkinliğinin oluşturulduğu alanın dışında görevler yapmalıdır. Örneğin, bir sohbet uygulamasının uzun süren bir görevi tamamladıktan sonra kullanıcıya yanıt vermesi gerekebilir. Bu durumda Chat uygulamaları, Google Chat API'yi çağırarak eşzamansız olarak yanıt verebilir.

Chat API'yi kullanarak mesaj oluşturmak için Mesaj oluşturma başlıklı makaleyi inceleyin. Diğer Chat API yöntemlerinin kullanımıyla ilgili kılavuzlar için Chat API'ye genel bakış başlıklı makaleyi inceleyin.

İlgili konular

• Mesaj gönder
• Etkileşimli iletişim kutuları açma
• Bağlantıları önizleme
• Kullanıcıların kartlara girdiği form verilerini okuma
• Eğik çizgi komutlarına yanıt verme
• Chat uygulaması için ana sayfa oluşturma
• Chat'ten gelen istekleri doğrulama
• Google Chat uygulamaları için etkileşimli özellikleri test etme