Bu sayfada, bir webhook'u kullanarak eşzamansız mesajları bir Harici tetikleyiciler kullanan Chat alanı. Örneğin, şunları yapabilirsiniz: Nöbetçi personeli bilgilendirecek bir izleme uygulaması Sunucu kapandığında sohbet edin. Eşzamanlı mesaj göndermek için daha fazla bilgi için Mesaj gönderin.
Bu tür bir mimariyle webhook ile veya bağlı harici çünkü iletişim tek yönlüdür. Webhook'lar konuşmaya dayalı değildir. Kullanıcılardan gelen mesajlara yanıt veremez, Chat uygulama etkileşimi etkinlikleri. Mesajları yanıtlamak için: Chat uygulaması geliştirin kullanabilirsiniz.
Webhook, teknik olarak Chat uygulaması: Webhook'lar, uygulamaları standart HTTP istekleri. Bu sayfa, HTTP istekleri için daha basittir. Her webhook yalnızca kayıtlı olduğu anlamına gelir. Gelen webhook'lar doğrudan mesajlarda çalışır ancak tüm kullanıcılar Etkin Chat uygulamaları. Google Workspace Marketplace'te webhook'u yayınlayamazsınız.
Aşağıdaki şemada Sohbet:
Önceki şemada, Chat uygulamasında şunlar bulunur: bilgi akışı:
- Chat uygulaması mantığı, harici üçüncü taraf hizmetlerini (örneğin, bir proje yönetimi sistemi veya bilet işlemleri aracıdır.
- Chat uygulamasının mantığı bir bulutta veya kullanarak bir sunucuya webhook URL'si kullanarak mesaj gönderebilen şirket içi belirli bir Chat alanını kullanın.
- Kullanıcılar Chat uygulamasından mesaj alabilir. olduğunu ancak Chat uygulaması.
Ön koşullar
Python
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat. Google Workspace kuruluşunuz, kullanıcılara gelen webhook'ları ekleyin ve kullanın.
- Python 3.6 veya sonraki sürümler
- pip paket yönetim aracı
httplib2
kitaplığı. Kitaplığı yüklemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:pip install httplib2
Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Node.js
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat. Google Workspace kuruluşunuz, kullanıcılara gelen webhook'ları ekleyin ve kullanın.
- Node.js 14 veya sonraki sürümler
- npm paket yönetim aracı
- Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Java
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat. Google Workspace kuruluşunuz, kullanıcılara gelen webhook'ları ekleyin ve kullanın.
- Java 11 veya sonraki bir sürüm
- Maven paket yönetim aracı
- Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Apps Komut Dosyası
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat. Google Workspace kuruluşunuz, kullanıcılara gelen webhook'ları ekleyin ve kullanın.
- Bağımsız bir Apps Komut Dosyası projesi oluşturun, ve Gelişmiş Sohbet Hizmeti'ni etkinleştirin.
- Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Webhook oluşturma
Webhook oluşturmak için onu istediğiniz yerde Chat alanında kaydedin kullanabilir ve ardından mesaj gönderen bir komut dosyası yazabilirsiniz.
Gelen webhook'u kaydedin
- Tarayıcıda şu dosyayı açın: Sohbet. Webhook'lar, Chat mobil uygulamasından yapılandırılamaz.
- Webhook eklemek istediğiniz alana gidin.
- Alan başlığının yanındaki . diğer okunu genişletin ve ardından Uygulamalar ve entegrasyonları başlıklı makaleyi inceleyin.
Webhook ekle'yi tıklayın.
Name (Ad) alanına
Quickstart Webhook
girin.Avatar URL'si alanına şunu girin:
https://developers.google.com/chat/images/chat-product-icon.png
.Kaydet'i tıklayın.
Webhook URL'sini kopyalamak için
Diğer'i tıklayın, ardından şunu tıklayın: Bağlantıyı kopyala.
Webhook komut dosyasını yazma
Örnek webhook komut dosyası, webhook'un bulunduğu alana
Webhook URL'sine bir POST
isteği göndererek kaydedilir. İlgili içeriği oluşturmak için kullanılan
Chat API,
Message
.
Webhook komut dosyası oluşturmayı öğrenmek için bir dil seçin:
Python
Çalışma dizininizde
quickstart.py
adlı bir dosya oluşturun.quickstart.py
alanına aşağıdaki kodu yapıştırın:url
değişkeninin değerini, şu web kancasının URL'siyle değiştirin: Webhook'u kaydettirirken kopyaladığınızda bu işlemi yapabilirsiniz.
Node.js
Çalışma dizininizde
index.js
adlı bir dosya oluşturun.index.js
alanına aşağıdaki kodu yapıştırın:url
değişkeninin değerini, şu web kancasının URL'siyle değiştirin: Webhook'u kaydettirirken kopyaladığınızda bu işlemi yapabilirsiniz.
Java
Çalışma dizininizde
pom.xml
adlı bir dosya oluşturun.pom.xml
alanına aşağıdakileri kopyalayıp yapıştırın:Çalışma dizininizde aşağıdaki dizin yapısını oluşturun
src/main/java
src/main/java
dizinindeApp.java
adlı bir dosya oluşturun.App.java
alanına aşağıdaki kodu yapıştırın:URL
değişkeninin değerini, eklediğiniz webhook URL'siyle değiştirin , webhook'u kaydettiğinizde kopyalanacak.
Apps Komut Dosyası
Tarayıcıda şu adrese gidin: Apps Komut Dosyası.
Yeni Proje'yi tıklayın.
Aşağıdaki kodu yapıştırın:
url
değişkeninin değerini, eklediğiniz webhook URL'siyle değiştirin , webhook'u kaydettiğinizde kopyalanacak.
Webhook komut dosyasını çalıştırma
Bir KSA'da şu komut dosyasını çalıştırın:
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
Apps Komut Dosyası
- Çalıştır'ı tıklayın.
Kodu çalıştırdığınızda webhook, kullandığınız alana bir mesaj gönderir. tarafından kaydedilmiştir.
Bir mesaj dizisi başlatma veya yanıtlama
Belirtin:
spaces.messages.thread.threadKey
parçası olarak görüntüleyebilirsiniz. Bu işe başlıyorsanız bir ileti dizisini yanıtlamak istiyorsanızthreadKey
için aşağıdaki değerleri kullanın:İleti dizisi başlatıyorsanız
threadKey
değerini rastgele bir dizeye ayarlayın ancak ileti dizisine yanıt yayınlamak için bu değeri not edin.Bir ileti dizisini yanıtlıyorsanız
threadKey
ileti dizisi başlatıldı. Örneğin, ilk mesajMY-THREAD
kullanıldı,MY-THREAD
olarak ayarlandı.
Belirtilen
threadKey
bulunamazsa ileti dizisi davranışını tanımlayın:Bir mesaj dizisini yanıtlayın veya yeni bir mesaj dizisi başlatın. URL'yi
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
parametresini webhook URL'sini ekleyin. Bu URL parametresinin iletilmesi Chat'e neden olur kullanarak mevcut bir ileti dizisini arayın.threadKey
Eğer bulunursa ileti, bu ileti dizisine yanıt olarak yayınlanır. Hiçbiri ileti dizisine karşılık gelen yeni bir ileti dizisithreadKey
İleti dizisini yanıtlama veya hiçbir işlem yapma. URL'yi Webhook URL'sine
messageReplyOption=REPLY_MESSAGE_OR_FAIL
parametresini ekler. Bu URL parametresinin iletilmesi Chat'e neden olur kullanarak mevcut bir ileti dizisini arayın.threadKey
Eğer bulunursa ileti, bu ileti dizisine yanıt olarak yayınlanır. Hiçbiri ileti gönderilmez.
Daha fazla bilgi için
messageReplyOption
sayfasını inceleyin.
Aşağıdaki kod örneği bir ileti dizisini başlatır veya yanıt verir: