Chat uygulamasını diğer hizmetlere ve araçlara bağlama

Bu sayfada, bir Google Chat uygulamasını Google Chat dışındaki bir hizmete veya araca nasıl bağlayacağınız açıklanmaktadır. Chat uygulamaları kendi başlarına güçlü olsa da genellikle diğer sistemlerle uyumlu şekilde çalışır ve hesapları bağlamak, veri erişimini yetkilendirmek, ek verileri görüntülemek veya kullanıcı tercihlerini yapılandırmak için tamamlayıcı uygulamalar gerektirir.

Bir kullanıcıdan Chat uygulaması yapılandırmasını isteme

İsteğin tamamlanması, doğrudan Chat uygulamasında tamamlayılamayan ek yapılandırmalar gerektiriyorsa, normal bir yanıtın parçası olarak kullanıcıya yapılandırma URL'sini döndürün veya aşağıdaki formu kullanarak URL'yi gizli olarak sunun:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

Bu işlem, Google Chat'e kullanıcıya gizli bir istem sunmasını söyler. Burada CONFIGURATION_URL, kullanıcının ek kimlik doğrulama, yetkilendirme veya yapılandırma için ziyaret edebileceği bir bağlantıdır. REQUEST_CONFIG yanıtı, normal yanıt mesajıyla birlikte kullanılamaz. Metinler, kartlar veya diğer özellikler yoksayılır.

Yapılandırma isteğini tamamlayın

Chat uygulamanızın aldığı her MESSAGE etkileşim etkinliği de bir configCompleteRedirectUrl parametresi içerir. Bu URL, işlemin tamamlandığında kullanılmak üzere yapılandırma URL'nizde kodlanmalıdır. Bu URL'ye yönlendirme, Google Chat'e yapılandırma isteğinin yerine getirildiğini bildirir.

Chat uygulamanız başladığında, akış alınan mesaja göre değişir. Chat uygulaması, @app help gibi bir mesaja ek yapılandırma gerekmeden bir mesajla yanıt vermelidir.

Kullanıcı, orijinal mesajda sağlanan configCompleteRedirectUrl adresine başarıyla yönlendirildiğinde Google Chat aşağıdaki adımları gerçekleştirir:

  1. Programı başlatan kullanıcıya görüntülenen istemi silin.
  2. Orijinal mesajı herkese açık hâle getirerek alanın diğer üyelerinin görmesini sağlayabilirsiniz.
  3. Orijinal mesajı aynı Chat uygulamasına ikinci kez göndermek.

Bir configCompleteRedirectUrl adresinin ziyaret edilmesi yalnızca tek bir kullanıcı mesajını etkiler. Bir kullanıcı bir Chat uygulamasına birden fazla kez mesaj göndermeye çalıştıysa ve bunun sonucunda birden fazla istem aldıysa belirli bir istemin tıklanması ve kimlik doğrulama ve yapılandırma işleminin tamamlanması yalnızca söz konusu mesajı etkiler. Diğer mesajlar değişmez.

Bir MESSAGE etkileşim etkinliği bu şekilde yeniden gönderildiğinde orijinal etkinlikle aynı olmalıdır. Ancak MESSAGE etkileşim etkinliklerinin farklılık gösterebileceği bazı durumlar vardır. Örneğin, bir mesajda hem Chat uygulaması A hem de Chat uygulaması B'den bahsedildiğinde Chat uygulaması A, Chat uygulaması B ile kimlik doğrulaması yapmadan önce normal bir mesajla yanıt veriyorsa kullanıcı mesajı düzenleyebilir. Bu durumda, kullanıcı kimlik doğrulama ve yapılandırmayı tamamladıktan sonra Chat uygulaması B, düzenlenen mesaj metnini alır.

Chat kullanıcısının kimliğini Chat dışında doğrulayın

Bir API için OAuth yetkilendirmesi istemek gibi bazı durumlarda, uygulamanızın kullanıcı kimliğini korurken Chat dışındaki bir URL'ye bağlantı oluşturması gerekir. Bu durumlarda kullanıcıyı tanımlamanın en iyi yolu Google ile Oturum Açma özelliğiyle hedef uygulamayı korumaktır.

User-ID'yi almak için oturum açma sırasında verilen kimlik jetonunu kullanın. sub hak talebi, kullanıcının benzersiz kimliğini içerir ve Google Chat'teki kullanıcı kimliğiyle ilişkilendirilebilir.

İki kimlik tam olarak aynı olmasa da zorlanabilirler. Google Chat users/{user} için sub hak talebinin değerini güçlendirmek için değerin başına users/ ekleyin. Örneğin, 123 hak talebi değeri, Chat uygulamanıza gönderilen mesajlardaki users/123 kullanıcı adına eşdeğerdir.