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

Bu sayfada, Google Chat uygulamanızın Google Chat uygulaması olarak da bilinen kullanıcı etkileşimlerine yanıt verme etkileşim etkinlikleri olarak da adlandırılır.

Bu sayfada, aşağıdakileri nasıl yapacağınız açıklanmaktadır:

  • Chat uygulamanızı etkileşim alacak şekilde yapılandırma etkinlikler.
  • 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ı. Bir aşağıdaki hızlı başlangıç kılavuzlarından birini kullanarak oluşturmak istediğiniz uygulama mimarisinde:

Etkileşim etkinliklerinin işleyiş şekli

Google Chat uygulaması etkileşim etkinliği, bir kullanıcının isteğine bağlı olarak bir Chat uygulamasını çağırmak veya onunla etkileşimde bulunmak için Bir Chat uygulamasından @bahsetmek veya boşluk oluşturur. Kullanıcılar bir Chat uygulamasıyla etkileşime geçtiğinde Google Chat, Chat uygulamasına bir etkileşim etkinliği gönderir. Chat uygulaması etkileşime geçip bir yanıt oluşturun.

Örneğin, Chat uygulamaları aşağıdakilerin herhangi birini yapmak için etkileşim etkinliklerini kullanır: takip etmek için:

Etkileşim etkinliği örneği Chat uygulamalarından alınan normal yanıt
Kullanıcı bir Chat uygulamasını başlatmak için @bahsetme veya eğik çizgi komutu kullanma. İlgili içeriği oluşturmak için kullanılan Chat uygulaması, mesajda belirtilenleri işler mesaj oluşturabilirsiniz. Örneğin, bir Chat uygulaması /about komutunun kullanılabilmesi için yapabiliyor.
Bir kullanıcı, bir alan. Chat uygulaması, ilk katılım işlemini mesajı görebilirsiniz. somut olarak ortaya koyar.
Bir kullanıcı, Bir alandaki Chat uygulaması. İlgili içeriği oluşturmak için kullanılan Chat uygulaması, gelen bildirimleri kaldırır yapılandırdığınızı (örneğin, bir webhook) ve tüm mevcut dahili depolama.
Kullanıcı, Google Ads tarafından gönderilen karttaki veya iletişim kutusundaki bir düğmeyi Chat uygulaması. Chat uygulaması, gönderilen tüm kullanıcının gönderdiği veriler veya başka bir kart ya da iletişim kutusu döndürür.

Google Chat, her kullanıcı etkileşimi türü için farklı türlerde ve Chat uygulamanızın her bir etkinlik türünü belirtecek. Örneğin, Google Chat ADDED_TO_SPACE Böylece, Chat uygulamasını bir alana Chat uygulaması, herkese açık kullanıcı adlarını ve alana hoş geldiniz mesajı gönderin. Desteklenen tüm etkileşim etkinliklerini görmek için EventType referansı dokümanlarına göz atın.

Chat uygulaması etkileşim etkinlikleri alma

Bu bölümde, hesabınızla ilişkili etkileşim etkinliklerini nasıl alıp işleyeceğinizi, Chat uygulaması.

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

Bazı Chat uygulamaları etkileşimli değildir. Örneğin, gelen webhook'lar yalnızca giden iletileri gönderebilir ve kullanıcılara yanıt veremez. Etkileşimli bir alan oluşturuyorsanız bir uç nokta seçmeniz gerekir. Chat uygulaması etkileşimi alma, işleme ve yanıtlama etkinlikler. Chat uygulamanızı tasarlama hakkında daha fazla bilgi edinmek için Chat uygulamaları uygulama mimarileri.

Geliştirmek istediğiniz etkileşimli özelliklerin her biri için yapılandırmanızı Chat API'sine göndermelisiniz. Böylece Google Chat, Chat uygulamanızla ilgili etkileşim etkinlikleri:

  1. Google Cloud konsolunda Chat API sayfasına gidin ve Yapılandırma sayfası:

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

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

    Alan Açıklama
    İşlevsellik Zorunlu. Chat uygulamasının kullanıcılarla nasıl etkileşim kurabileceğini belirleyen bir dizi alan:
    • Bire bir mesaj alma: Kullanıcılar, Chat uygulamasını doğrudan Google Chat'te bulabilir ve bu uygulamaya 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ı için uç nokta. Bu sınır aşağıdakilerden biridir:
    • Uygulama URL'si: Chat uygulamasının uygulamasını barındıran bir HTTPS uç noktası.
    • Apps Komut Dosyası projesi: 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şim kurmak 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üleyebilen ve yükleyebilen en fazla beş kişi veya bir ya da daha fazla Google Grubu. Chat uygulamanızı test etmek veya Chat uygulamasını 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ını kaydettiğinizde yapılandırmasında Chat uygulamanızı Google Workspace kuruluşunuzdaki belirtilen kullanıcılar.

Chat uygulamanız artık etkileşim alacak şekilde yapılandırılmış Google Chat'teki etkinlikler.

Hizmetinize yönelik HTTP çağrısı yeniden denemelerini işleme

Hizmetinize yapılan bir HTTPS isteği başarısız olursa (zaman aşımı, geçici ağ gibi) hatası veya 2xx olmayan HTTPS durum kodu) içeriyorsa Google Chat, teslim sürecini birkaç dakika içinde tamamlanır (ancak bu garanti edilmez). Sonuç olarak, Chat uygulaması aynı mesajı şu sürede birkaç kez alabilir: durumlar olabilir. İstek başarıyla tamamlanır, ancak geçersiz bir Google Chat, isteği yeniden denemez.

Etkileşim etkinliklerini işleme veya yanıtlama

Bu bölümde, Google Chat uygulamalarının nasıl işleyeceği ve yanıt verebileceği açıklanmaktadır. etkinlikleri anlamına gelir.

Chat uygulamanız Google Chat'te birçok farklı şekilde yanıt verebilirler. Çoğu zaman, etkileşimli Chat uygulamaları, kullanıcıya mesajla yanıt verir. Google Chat uygulaması, verilerdeki bazı bilgileri de arayabilir. etkileşim etkinliği bilgilerini veya neredeyse her şeyi kaydedebilirsiniz. Bu işleme davranışı temel olarak Google Chat uygulaması.

Eşzamanlı yanıt vermek için bir Chat uygulamasının yanıt vermesi gerekir 30 saniye içinde olmalı ve yanıt, reklamın etkileşim gerçekleşti. Aksi takdirde Chat uygulaması eşzamansız şekilde yanıt verebilir.

Chat uygulamaları, her etkileşim etkinliği için bir istek gövdesi alır. Bu, etkinliği temsil eden JSON yüküdür. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için bilgi edinemez. Etkinlik yükü örnekleri için bkz. Chat uygulaması etkileşim etkinliklerinin türleri

Aşağıdaki şemada Google Chat uygulaması genellikle farklı türdeki etkileşim etkinlikleri:

Google Chat uygulamalarının etkileşim etkinliklerini nasıl işlediğine dair mimari.

Anlık olarak yanıtla

Etkileşim etkinlikleri, Chat uygulamalarının gerçek zamanlı olarak yanıt vermesine olanak tanır. eşzamanlı olarak güncelleyin. Eşzamanlı yanıtlarda gerek yoktur authentication ("kimlik doğrulaması")

Bir alana katılma yanıtı verme

Bu örnekte, Chat uygulamanız bir kısa mesaj oluşturup gönderir mesajı gösterilir. En iyi uygulamalar hakkında bilgi edinmek için daha fazla bilgi edinmek için Kullanıcıları Chat uygulamanızla tanıştırın.

Bir kullanıcı Chat uygulamanızı eklediğinde kısa mesaj göndermek için alana, Chat uygulamanıza ADDED_TO_SPACE için yanıt veriyor etkileşim etkinliği. Şu kullanıcıya yanıt vermek için: Kısa mesajla ADDED_TO_SPACE etkileşim etkinliği için aşağıdaki kodu kullanın:

Node.js

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

Apps Komut Dosyası

/**
 * 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:

Örnek ilk katılım mesajı.

Etkileşimlere yanıt vermeyle ilgili diğer örnekler

Etkileşim etkinliklerine eşzamanlı yanıtlar oluşturmak için aşağıdakilere bakın kılavuzlar:

Eşzamansız olarak yanıtla

Chat uygulamaları bazen etkileşim etkinliğine 30'dan sonra yanıt vermelidir saniyeler içinde gerçekleşen anlarda veya etkileşim etkinliğinin olduğu alanın dışında görevler gerçekleştirebilir. elde edilir. Örneğin, bir Chat uygulamasının kullanıcıya yanıt vermesidir. Böyle durumlarda Sohbet uygulamaları, Google Chat API'yi çağırarak eşzamansız şekilde yanıt verebilir.

Chat API'yi kullanarak mesaj oluşturmak için bkz. Bir mesaj oluşturun. diğer Chat API yöntemleri için Chat API'ye genel bakış.