Google Chat uygulamanızla etkileşimleri alma ve yanıtlama

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

Google Chat uygulaması etkileşim etkinliği, kullanıcının bir Chat uygulamasını çağırmak veya uygulamayla etkileşim kurmak için gerçekleştirdiği herhangi bir işlemi (ör. bir Chat uygulamasından @bahsetmek veya uygulamayı bir alana eklemek) temsil eder. Kullanıcılar bir Chat uygulamasıyla etkileşimde bulunduğunda, Google Chat, Chat uygulamasına bir etkileşim etkinliği gönderir. Chat uygulaması, etkileşimi işlemek ve bir yanıt oluşturmak için etkinliği kullanabilir.

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

Etkileşim etkinliği örneği Chat uygulamasından tipik yanıt
Kullanıcı, Chat uygulamasını @bahsederek veya eğik çizgi komutu kullanarak çağırır. Chat uygulaması, mesaj oluşturmak için mesajda söylenenleri işler. Örneğin, bir Chat uygulaması /about komutuna, Chat uygulamasının yapabileceği görevleri açıklayan bir mesajla yanıt verir.
Kullanıcı, bir alana Chat uygulaması ekler. Chat uygulaması, uygulamanın ne işe yaradığını ve alandaki kullanıcıların uygulamayla nasıl etkileşim kurabileceğini açıklayan bir ilk katılım mesajı gönderir.
Kullanıcı, alandan Chat uygulamasını kaldırır. Chat uygulaması, alan için yapılandırılmış tüm gelen bildirimleri kaldırır (ör. webhook'u silme) ve dahili depolama alanını boşaltır.
Kullanıcı, Chat uygulaması tarafından gönderilen bir karttaki veya iletişim kutusundaki bir düğmeyi tıklar. Chat uygulaması, kullanıcının gönderdiği tüm verileri işleyip depolar 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ürde bir etkileşim etkinliği gönderir. Örneğin, kullanıcının bir mesajda Chat uygulamasını çağırdığı her etkileşim için Google Chat MESSAGE etkinlik türünü kullanır. Ayrıntılı bilgi için Google Chat uygulaması etkileşim etkinliği türleri başlıklı makaleyi inceleyin.

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

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

Chat uygulaması etkileşim etkinliklerini alma

Bu bölümde, Chat uygulamanız için etkileşim etkinliklerini nasıl alacağınız ve işleyebileceğiniz 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 mesaj 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ıt vermesine olanak tanıyan bir uç nokta seçmeniz gerekir. Chat uygulamanızı tasarlama hakkında daha fazla bilgi edinmek için Chat uygulamaları uygulama mimarileri başlıklı makaleyi inceleyin.

Etkileşimli bir Chat uygulaması oluşturduysanız Google Chat'in size etkileşim etkinlikleri gönderebilmesi için Google Chat API'yi yapılandırmanız gerekir:

  1. Google Cloud Console'da Google Chat API sayfasını açın:

    Google Chat API sayfasına gidin

  2. Configuration (Yapılandırma) sekmesini tıklayın.
  3. Etkileşimli özellikler bölümünde, Etkileşimli özellikleri etkinleştir düğmesini tıklayarak açık konuma getirin.
  4. İşlevler bölümünde aşağıdaki onay kutularının birini veya her ikisini seçin:
    1. Bire bir mesaj alma: Kullanıcıların doğrudan mesaj (DM) alanlarında Chat uygulamanızla etkileşim kurmasına olanak tanır. Bir kullanıcı DM alanında her mesaj gönderdiğinde Chat uygulamanız etkileşim etkinliği alır.
    2. Alanlara ve grup görüşmelerine katılma: Kullanıcıların birden fazla kişinin bulunduğu alanlara Chat uygulamanızı eklemesine ve kaldırmasına olanak tanır. Chat uygulamanız, alana eklendiğinde veya alana çıkarıldığında ve kullanıcılar alanda @bahsettiğinde ya da alanda eğik çizgi komutu kullandığında etkileşim etkinlikleri alır.
  5. Bağlantı ayarları bölümünde, Google Chat'in Chat uygulaması etkileşim etkinliklerini nereye göndereceğini belirtin.
  6. İsteğe bağlı: Eğik çizgi komutları alanına bir veya daha fazla eğik çizgi komutu ekleyin ve yapılandırın. Daha fazla bilgi için Eğik çizgi komutları ayarlama başlıklı makaleyi inceleyin.
  7. İsteğe bağlı: Bağlantı önizlemeleri bölümünde, Chat uygulamanızın önizlediği bir veya daha fazla URL kalıbı ekleyin ve yapılandırın. Daha fazla bilgi için Önizleme bağlantıları başlıklı makaleyi inceleyin.
  8. Kaydet'i tıklayın.

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 yönelik bir HTTPS isteği başarısız olursa (zaman aşımı, geçici ağ hatası veya 2xx olmayan HTTPS durum kodu gibi) Google Chat birkaç dakika içinde yayınlamayı birkaç kez yeniden deneyebilir (ancak bu garanti edilmez). Sonuç olarak, bir 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şleyip yanıt verebileceği açıklanmaktadır.

Chat uygulamanız, Google Chat'ten bir etkileşim etkinliği aldıktan sonra, uygulamanıza farklı şekillerde yanıt verebilir. Çoğu durumda, etkileşimli Chat uygulamaları kullanıcıya bir mesajla yanıt verir. Google Chat uygulaması ayrıca bir veri kaynağından bazı bilgileri arayabilir, etkileşim etkinliği bilgilerini kaydedebilir veya hemen hemen başka her şeyi yapabilir. Bu işleme davranışı, temelde Google Chat uygulamasını tanımlar.

Her etkileşim etkinliği için Chat uygulamaları bir istek gövdesi alır. Bu, etkinliği temsil eden JSON yüküdür. Yanıtları işlemek için bu bilgileri kullanabilirsiniz. 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 farklı etkileşim etkinliklerini genellikle nasıl işlediği veya yanıtladığı gösterilmektedir:

Google Chat uygulamalarının etkileşim etkinliklerini işleme biçiminin mimarisi.

Anlık olarak yanıtla

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

Etkileşim etkinliklerine yönelik eşzamanlı yanıtlar oluşturmak için aşağıdaki kılavuzlara bakın:

Eşzamanlı yanıt vermek için Chat uygulamasının 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.

Eşzamansız olarak yanıt ver

Chat uygulamalarının bazen 30 saniye sonra bir etkileşim etkinliğine yanıt vermesi veya etkileşim etkinliğinin oluşturulduğu alanın dışında görevler gerçekleştirmesi gerekir. Örneğin, bir Chat uygulamasının uzun süreli 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. Ek Chat API yöntemlerini kullanmayla ilgili kılavuzlar için Chat API'ye genel bakış sayfasını inceleyin.