Google Chat arayüzleri oluşturma

Bu sayfada, Google Chat'i genişleten Google Workspace eklentileri için kullanıcı arayüzlerinin (UA) nasıl oluşturulacağına dair genel bilgiler verilmektedir.

Google Chat'te eklentiler kullanıcılara Google Chat uygulamaları olarak görünür. Daha fazla bilgi edinmek için Google Chat'i genişletme başlıklı makaleyi inceleyin.

Chat uygulamaları için arayüz oluşturmak üzere aşağıdaki eklenti bileşenlerini kullanırsınız:

  • Tetikleyiciler: Google Chat kullanıcılarının bir Chat uygulamasını çağırabileceği yöntemler (ör. bir alana ekleme veya mesaj gönderme).
  • Etkinlik nesneleri: Chat uygulamalarının tetikleyicilerden veya kullanıcı arayüzü etkileşimlerinden aldığı veriler.
  • İşlemler: Sohbet uygulamalarının etkileşimlere yanıt verebileceği yöntemler (ör. mesaj gönderme veya kart tabanlı kullanıcı arayüzü döndürme).
Chat uygulaması, alana eklendi tetikleyicisinden bir etkinlik nesnesi alır
Şekil 1: Bir kullanıcı bir alana Chat uygulaması eklediğinde, Alana eklendi tetikleyicisi etkinleştirilir ve bir etkinlik nesnesi gönderilir. Chat uygulaması, mesajla yanıt vermek için etkinlik nesnesini işler ve mesajı oluşturan bir işlem döndürür.

Chat uygulamaları aşağıdaki arayüzlerde kart oluşturabilir ve gösterebilir:

  • Metin, statik veya etkileşimli kartlar ve düğmeler içerebilen mesajlar.
  • Yeni bir pencerede açılan ve genellikle kullanıcılardan bilgi göndermelerini isteyen kartlar olan iletişim kutuları.
  • Harici bir hizmetle ilgili bilgileri önizleyen kartlar olan bağlantı önizlemeleri.

Tetikleyiciler

Bu bölümde, Google Workspace eklentilerinin Chat'te kullandığı tetikleyiciler açıklanmaktadır.

Tetikleyiciler, kullanıcıların Chat kullanıcı arayüzünü kullanarak Chat uygulamasını çağırma yöntemleridir (ör. @bahsetmeler veya uygulama komutları).

Aşağıdaki tabloda Chat tetikleyicileri, açıklamaları ve Chat uygulamalarının genellikle nasıl yanıt verdiği gösterilmektedir:

Tetikleyici Açıklama Tipik yanıt
Alana eklendi

Bir kullanıcı Chat uygulamasını bir alana ekler veya bir Google Workspace yöneticisi, Chat uygulamasını kuruluşundaki kullanıcılar için doğrudan mesaj alanlarına yükler. Yöneticiler tarafından yüklenen Chat uygulamaları hakkında bilgi edinmek için Google Workspace Yönetici Yardım dokümanlarında Marketplace uygulamalarını alanınıza yükleme başlıklı makaleyi inceleyin.

 Chat uygulaması, ne işe yaradığını ve alandaki kullanıcıların nasıl etkileşime geçebileceğini açıklayan bir ilk katılım mesajı gönderir.
Mesaj

Kullanıcı, mesajda Chat uygulamasıyla aşağıdaki yöntemlerden biriyle etkileşim kurar:

  • Chat uygulamasıyla doğrudan mesaj (DM) alanında mesaj gönderir.
  • @, her tür alanda Chat uygulamasını belirtir.
  • Bağlantı önizlemeleri için URL kalıplarıyla eşleşen bir bağlantı içeren bir mesaj gönderilir.
  • Bir selectionInput widget'ının çoklu seçim menüsüne metin yazar.
 Chat uygulaması, mesajın içeriğine göre yanıt verir. Örneğin, bir Chat uygulaması, eğik çizgi komutunu /about, Chat uygulamasının yapabileceği görevleri açıklayan bir mesajla yanıtlar.
Alandan kaldırıldı

Bir kullanıcı Chat uygulamasını alandan kaldırır veya bir Google Workspace yöneticisi, kuruluşundaki bir kullanıcının Chat uygulamasını kaldırır.

Kullanıcılar, yöneticileri tarafından yüklenen Chat uygulamalarını kaldıramaz. Kullanıcı daha önce Chat uygulamasını yüklediyse Google Workspace yöneticisinin kaldırmaya çalışıp çalışmadığından bağımsız olarak Chat uygulaması yüklü kalır.

 Chat uygulaması, alan için yapılandırılmış tüm gelen bildirimleri (ör. bir webhook'un silinmesi) kaldırır ve dahili depolama alanını temizler. Sohbet uygulamaları artık alanın üyesi olmadığı için bu tetikleyiciye mesajla yanıt veremez.
Uygulama komutu

Kullanıcı bir Chat uygulaması komutu kullanır.

 Chat uygulaması komuta yanıt verir. Örneğin, bir mesajla yanıt verir veya iletişim kutusu açar.

Diğer Google Workspace eklentilerinin aksine, bu tetikleyiciler için geri çağırma işlevlerini Google Chat API'yi kullanarak yapılandırmanız gerekir. Daha fazla bilgi için Google Chat uygulamasını yapılandırma başlıklı makaleyi inceleyin.

Tetikleyicilere yanıt vermek için aşağıdaki kılavuzları inceleyin:

Etkinlik nesneleri

Chat uygulamaları, bir Chat tetikleyicisi tetiklendiğinde veya Chat kullanıcıları Chat uygulamasındaki bir kullanıcı arayüzüyle etkileşime geçtiğinde (ör. bir düğmeyi tıkladığında) etkinlik nesneleri alır. Etkinlik nesnesi, Chat uygulamasının bir kullanıcı arayüzüne yanıt vermek veya kullanıcı arayüzünü güncellemek için kullanabileceği etkileşimle ilgili verileri içerir.

Etkinlik nesnelerini işleme hakkında bilgi edinmek için aşağıdaki kılavuzları inceleyin:

Chat ve diğer Google Workspace uygulamalarındaki eklenti etkinlik nesneleri hakkında bilgi edinmek için Etkinlik nesneleri başlıklı makaleyi inceleyin.

Sohbet işlemleri

Bu bölümde, Chat uygulamalarının kullanıcı etkileşimlerine yanıt vermek için ek eylemleri nasıl kullanabileceği açıklanmaktadır.

Eklenti işlemiyle yanıt vermek için sohbet 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ının kimlik doğrulamayı ayarlayıp yanıt vermek için Google Chat API'yi çağırması gerekir.

Sohbet uygulamaları, etkileşimleri birçok şekilde yönetebilir ve yanıtlayabilir. Chat uygulamaları çoğu durumda mesajla yanıt verir. Sohbet uygulamaları, bir veri kaynağından bazı bilgileri arayabilir, etkinlik nesnesi bilgilerini kaydedebilir veya başka herhangi bir şeyi yapabilir. Google Chat uygulamasının temelini bu işleme davranışı oluşturur.

Chat uygulamaları, kullanıcı etkileşimlerine yanıt vermek için ilgili etkinlik nesnesini işlemeli ve aşağıdaki JSON nesnelerinden birini döndürmelidir:

Chat uygulaması yanıtı İade için gerekli işlem
Mesaj gönderme veya güncelleme DataActions
İletişim kutularını açma, güncelleme veya kapatma. RenderActions
Bir karttan veya iletişim kutusunda bilgi toplamak için kullanıcıların çoklu seçim menüsüne yazdığına göre seçim öğeleri önerin. RenderActions
Chat kullanıcılarının bir alanda gönderdiği mesajlardaki bağlantılar DataActions

Google Chat API'yi kullanarak yanıt verme

Chat uygulamalarının, bir eklenti işlemi döndürmek yerine Google Chat API'yi kullanarak etkileşime yanıt vermesi gerekebilir. Örneğin, Chat uygulamalarının aşağıdakilerden herhangi birini yapması için Google Chat API'yi çağırması gerekir:

  • 30 saniye sonra bir etkileşime yanıt verin.
  • Etkileşimin gerçekleştiği alanın dışında görev gerçekleştirme.
  • Chat'te eklenti işlemi olarak kullanılamayan görevleri gerçekleştirebilirsiniz. Örneğin, bir kullanıcının veya Chat uygulamasının üyesi olduğu alanları listeleyebilir ya da alana kullanıcı ekleyebilirsiniz.
  • Chat kullanıcısı adına görevler gerçekleştirme (kullanıcı kimlik doğrulaması gerekir).

Chat API'nin kimliğini doğrulama ve çağırma hakkında bilgi edinmek için Chat API'ye genel bakış başlıklı makaleyi inceleyin.