Aracılığıyla paylaş


Viva Engage

Viva Engage, işletmelerin işlerini daha akıllı ve hızlı bir şekilde halletmeleri için önde gelen bir sosyal ağdır. Kuruluş ağınızdaki konuşmalara erişmek için Viva Engage'e bağlanın.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Standart Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Microsoft
URL https://microsoft.com
Bağlayıcı Meta Verileri
Publisher Microsoft
Web sitesi https://products.office.com/yammer/yammer-overview
Gizlilik ilkesi https://privacy.microsoft.com
Kategoriler Communication

Önemli

Yammer için OAuth2 kimlik doğrulaması (Viva Engage) yakında kullanımdan kaldırılacaktır.

  • Yeni bağlantıların 1 Eylül'den itibaren Entra Id kimlik doğrulaması kullanması gerekir.
  • Mevcut OAuth2 bağlantıları 15 Kasım 2025'e kadar çalışmaya devam edecektir.

Kesintileri önlemek için lütfen bağlantılarınızı 15 Kasım 2025'den önce Entra Id kimlik doğrulamasına geçirin.

Bilinen sorunlar ve sınırlamalar

Viva Engage REST API sınırlamaları nedeniyle aşağıdaki eylemler ve tetikleyiciler tüm iletileri döndürmeyi garanti etmemektedir:

  • Tüm iletileri alma
  • Gruba ileti alma
  • İletileri bir yazışmaya alma
  • takip edilen akışımdan iletileri alma
  • Grupta yeni bir ileti olduğunda
  • Takip edilen akışımda yeni bir ileti olduğunda

Viva Engage REST API sınırlamaları nedeniyle aşağıdaki eylem en fazla 100 grup döndürebilir:

  • Grupları alma

Uyarı

Viva Engage API'si döndürülen ileti sayısını kısıtlayabilir. Bu durumda, bu sınıra geçici bir çözüm için lütfen Microsoft Flow kullanarak yammer grubundaki tüm iletileri alma konusuna bakın. Viva Engage API sınırlarıyla ilgili daha fazla bilgi için lütfen Yammer API hız sınırları bölümünü ziyaret edin.

Ayrıca, Viva Engage REST API sınırlamaları nedeniyle aşağıdaki eylemler ve tetikleyiciler Tüm şirket grubuyla çalışmayabilir:

  • Gruba ileti alma
  • Gruba ileti alma (V2)
  • Grupta yeni bir ileti olduğunda

Üçüncü Taraf Uygulamalar özelliği Yammer yapılandırmasında etkinleştirilmelidir. "Yanıt JSON biçiminde değil" gibi bir eylem yanıtı genellikle özelliğin devre dışı bırakıldığını gösterir.

Aşağıdaki eylemler, ilgili Gelişmiş Parametreleri ayarladıktan sonra "Başlık" içeren bir "Duyuru" gönderisi oluşturmanıza olanak sağlar, ancak bu gönderi Viva Engage kullanıcı arabiriminde düzenlenemez. Viva Engage bu sorunun farkındadır ve bu sorunu gelecekteki bir güncelleştirmede ele alacaktır.

  • PostMessage
  • PostMessageV2

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Microsoft Entra Kimliği ile oturum açın Microsoft Entra Kimliği ile oturum açın Tüm bölgeler Paylaşılamaz
Varsayılan [KULLANIM DIŞI] Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır. Tüm bölgeler Paylaşılamaz

Microsoft Entra Kimliği ile oturum açın

Kimlik Doğrulama Kimliği: entraIDUserLogin

Geçerli: Tüm bölgeler

Microsoft Entra Kimliği ile oturum açın

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye
Tetikleyici yoklamalarının sıklığı 1 15 saniye

Eylemler

Ağlarımı alma

Kullanıcının ait olduğu tüm ağları alır.

Aşağıdaki akışımdan (V2) gelen iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Aşağıdaki akışımdan (V3) gelen iletileri al'ı kullanın.

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Aşağıdaki akışımdan iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Aşağıdaki akışımdan (V3) gelen iletileri al'ı kullanın.

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Bir gruba ileti alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Bir gruptaki iletileri al (V3) kullanın.

Bu işlem, bir gruba gönderilen iletileri döndürür.

bir iş parçacığında ileti alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen İletileri iş parçacığında al (V3) kullanın.

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

Gruba ileti alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Bir gruptaki iletileri al (V3) kullanın.

Bu işlem, bir gruba gönderilen iletileri döndürür.

Gruba ileti alma (V3)

Bu işlem, bir gruba gönderilen iletileri döndürür.

Grupları alma

Tüm grupları alır. Benimki = 1 ise, yalnızca kullanıcının ait olduğu grupları alın

İleti gönderme (V2)

Bu işlem, Bir Gruba veya Tüm Şirket Akışına İleti göndermek için kullanılır. Grup kimliği sağlanırsa, ileti belirtilen gruba postalanır, aksi takdirde Tüm Şirket Akışı'na nakledilir.

İleti gönderme [KULLANIM DIŞI]

Bu işlem, Bir Gruba veya Tüm Şirket Akışına İleti göndermek için kullanılır. Grup kimliği sağlanırsa, ileti belirtilen gruba postalanır, aksi takdirde Tüm Şirket Akışı'na nakledilir.

İletileri bir iş parçacığında alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen İletileri iş parçacığında al (V3) kullanın.

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

İletileri iş parçacığında alma (V3)

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

İletiyi beğenme

Bu işlem belirtilen iletiyi beğenmek için kullanılır.

Kullanıcı ayrıntılarını alma

Bu işlem kullanıcı profili ayrıntılarını döndürür.

takip edilen akışımdan (V3) iletileri alma

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Tüm iletileri alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen Bunun yerine Tüm iletileri al (V3) kullanın.

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Viva Engage web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Tüm iletileri alma (V3)

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Viva Engage web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Tüm iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen Bunun yerine Tüm iletileri al (V3) kullanın.

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Yammer web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Ağlarımı alma

Kullanıcının ait olduğu tüm ağları alır.

Döndürülenler

response
array of Network

Aşağıdaki akışımdan (V2) gelen iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Aşağıdaki akışımdan (V3) gelen iletileri al'ı kullanın.

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageList

Aşağıdaki akışımdan iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Aşağıdaki akışımdan (V3) gelen iletileri al'ı kullanın.

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Sayfa
page integer

Belirtilen sayfayı alın. Döndürülen veriler sınırdan büyükse, sonraki sayfalara erişmek için bu alanı kullanabilirsiniz

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

Bir gruba ileti alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Bir gruptaki iletileri al (V3) kullanın.

Bu işlem, bir gruba gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Grup Kimliği
group_id True integer

Grubun benzersiz tanımlayıcısı.

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Sayfa
page integer

Belirtilen sayfayı alın. Döndürülen veriler sınırdan büyükse, sonraki sayfalara erişmek için bu alanı kullanabilirsiniz

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

bir iş parçacığında ileti alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen İletileri iş parçacığında al (V3) kullanın.

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İş Parçacığı Kimliği
thread_id True integer

İş parçacığının benzersiz tanımlayıcısı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageList

Gruba ileti alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Bir gruptaki iletileri al (V3) kullanın.

Bu işlem, bir gruba gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Grup Kimliği
group_id True integer

Grubun benzersiz tanımlayıcısı.

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageList

Gruba ileti alma (V3)

Bu işlem, bir gruba gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Grup Kimliği
group_id True integer

Grubun benzersiz tanımlayıcısı.

Daha eski
older_than integer

İş parçacığının en son iletisinin belirtilen ileti kimliğinden daha eski olduğu iş parçacıklarındaki iletileri döndürür. Belirtilen kimlikten daha yeni veya buna eşit en son ileti kimliğine sahip herhangi bir iş parçacığında bu sorgu tarafından döndürülen iletilerden hiçbiri olmaz.

Daha yeni
newer_than integer

İş parçacığının en son iletisinin belirtilen ileti kimliğinden daha yeni olduğu iş parçacıklarındaki iletileri döndürür. Belirtilen kimlikten daha eski veya buna eşit en son ileti kimliğine sahip herhangi bir iş parçacığında bu sorgu tarafından döndürülen iletilerden hiçbiri olmaz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageListV2

Grupları alma

Tüm grupları alır. Benimki = 1 ise, yalnızca kullanıcının ait olduğu grupları alın

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağ Kimliği

maden
mine integer

Kullanıcının parçası olduğu grupları almak için kullanılır

Tüm Şirket Grubunu Göster
showAllCompanyGroup integer

Tüm Şirket Grubunu göstermek için kullanılır

Döndürülenler

İleti gönderme (V2)

Bu işlem, Bir Gruba veya Tüm Şirket Akışına İleti göndermek için kullanılır. Grup kimliği sağlanırsa, ileti belirtilen gruba postalanır, aksi takdirde Tüm Şirket Akışı'na nakledilir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz kimliği.

Grup Kimliği
group_id True integer

(0 = Tüm Şirket/Ağ) adresine ileti göndermek için grup.

İleti Metni
body True string

Ağınıza gönderilecek iletiniz.

Yanıtlanan Kimlik
replied_to_id integer

Bu iletinin yanıtta olduğu ileti kimliği.

Doğrudan Kimlik
direct_to_id integer

Ayarlanırsa, kullanıcıya belirtilen kimlikle doğrudan özel bir ileti gönderilir.

Yayın
broadcast boolean

İletiyi bir gruptaki tüm kullanıcılara duyuru olarak gönderin.

Başlık
title string

Gönderilecek iletinin başlığı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageListV2

İleti gönderme [KULLANIM DIŞI]

Bu işlem, Bir Gruba veya Tüm Şirket Akışına İleti göndermek için kullanılır. Grup kimliği sağlanırsa, ileti belirtilen gruba postalanır, aksi takdirde Tüm Şirket Akışı'na nakledilir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz kimliği.

Grup Kimliği
group_id True integer

(0 = Tüm Şirket/Ağ) adresine ileti göndermek için grup.

İleti Metni
body True string

Ağınıza gönderilecek iletiniz.

Yanıtlanan Kimlik
replied_to_id integer

Bu iletinin yanıtta olduğu ileti kimliği.

Doğrudan Kimlik
direct_to_id integer

Ayarlanırsa, kullanıcıya belirtilen kimlikle doğrudan özel bir ileti gönderilir.

Yayın
broadcast boolean

İletiyi bir gruptaki tüm kullanıcılara duyuru olarak gönderin.

Başlık
title string

Gönderilecek iletinin başlığı.

Konu 1
topic1 string

İletiye uygulanacak konu.

Konu 2
topic2 string

İletiye uygulanacak konu

Konu 3
topic3 string

İletiye uygulanacak konu.

Konu 4
topic4 string

İletiye uygulanacak konu

Konu 5
topic5 string

İletiye uygulanacak konu.

Konu 6
topic6 string

İletiye uygulanacak konu.

Konu 7
topic7 string

İletiye uygulanacak konu

Konu 8
topic8 string

İletiye uygulanacak konu.

Konu 9
topic9 string

İletiye uygulanacak konu.

Konu 10
topic10 string

İletiye uygulanacak konu.

Konu 11
topic11 string

İletiye uygulanacak konu.

Konu 12
topic12 string

İletiye uygulanacak konu.

Konu 13
topic13 string

İletiye uygulanacak konu.

Konu 14
topic14 string

İletiye uygulanacak konu.

Konu 15
topic15 string

İletiye uygulanacak konu.

Konu 16
topic16 string

İletiye uygulanacak konu.

Konu 17
topic17 string

İletiye uygulanacak konu.

Konu 18
topic18 string

İletiye uygulanacak konu.

Konu 19
topic19 string

İletiye uygulanacak konu.

Konu 20
topic20 string

İletiye uygulanacak konu.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

İletileri bir iş parçacığında alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen İletileri iş parçacığında al (V3) kullanın.

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İş Parçacığı Kimliği
thread_id True integer

İş parçacığının benzersiz tanımlayıcısı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

İletileri iş parçacığında alma (V3)

Bu işlem, bir iş parçacığında gönderilen iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İş Parçacığı Kimliği
thread_id True integer

İş parçacığının benzersiz tanımlayıcısı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageListV2

İletiyi beğenme

Bu işlem belirtilen iletiyi beğenmek için kullanılır.

Parametreler

Name Anahtar Gerekli Tür Description
İleti Kimliği
message_id True string

İletinin benzersiz kimliği.

Kullanıcı ayrıntılarını alma

Bu işlem kullanıcı profili ayrıntılarını döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
user_id True integer

Kullanıcının benzersiz tanımlayıcısı.

Döndürülenler

Viva Engage kullanıcısının özellikleri.

User
User

takip edilen akışımdan (V3) iletileri alma

Bu işlem, takip edilen akıştan gelen ve kullanıcının takip ettiği kişileri, grupları ve konuları içeren konuşmaları içeren iletileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz tanımlayıcısı.

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageListV2

Tüm iletileri alma (V2) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen Bunun yerine Tüm iletileri al (V3) kullanın.

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Viva Engage web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağın benzersiz tanımlayıcısı
network_id string

Ağ Kimliği

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageList

Tüm iletileri alma (V3)

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Viva Engage web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağın benzersiz tanımlayıcısı
network_id string

Ağ Kimliği

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

İletilerin iş parçacığı türü
threaded string

Threaded=true, her iş parçacığı için yalnızca iş parçacığı başlatıcısını (ilk ileti) döndürür. Bu parametre, daraltılmış ileti iş parçacıklarını görüntülemesi gereken uygulamalara yöneliktir. threaded=extended, Viva Engage web arabiriminde varsayılan görünümde görüntülendiği için iş parçacığı başlangıç iletilerini ve etkinlik tarafından sıralanan en son iki iletiyi döndürür.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
PageableMessageListV2

Tüm iletileri alma [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen Bunun yerine Tüm iletileri al (V3) kullanın.

Bu işlem, oturum açmış kullanıcının Viva Engage ağında bulunan tüm genel iletileri döndürür. Yammer web arabirimindeki "Tümü" konuşmalarına karşılık gelir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağın benzersiz tanımlayıcısı
network_id string

Ağ Kimliği

Daha eski
older_than integer

Sayısal dize olarak belirtilen ileti kimliğinden eski iletileri döndürür. Bu, iletileri sayfalandırmak için kullanışlıdır. Örneğin, şu anda 20 ileti görüntülüyorsanız ve en eski 2912 ise, gördüklerinizden önceki 20 iletiyi alma isteğinize "?older_than=2912" ekleyebilirsiniz.

Daha yeni
newer_than integer

Sayısal dize olarak belirtilen ileti kimliğinden daha yeni iletiler döndürür. Bu, yeni iletileri yoklarken kullanılmalıdır. İletilere bakıyorsanız ve döndürülen en son ileti 3516 ise, zaten sayfanızda bulunan iletilerin yinelenen kopyalarını almadığınızdan emin olmak için "?newer_than=3516" parametresiyle bir istekte bulunabilirsiniz.

Sınır
limit integer

Yalnızca belirtilen sayıda ileti döndürür.

Sayfa
page integer

Belirtilen sayfayı alın. Döndürülen veriler sınırdan büyükse, sonraki sayfalara erişmek için bu alanı kullanabilirsiniz

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

Tetikleyiciler

[KULLANIM DIŞI] grubunda yeni bir ileti olduğunda

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Bir grupta yeni ileti olduğunda (V2) kullanın.

Bu işlem, gruba yeni bir ileti gönderildiğinde tetikler.

Grupta yeni bir ileti olduğunda (V2)

Bu işlem, gruba yeni bir ileti gönderildiğinde tetikler.

Takip edilen akışımda yeni bir ileti olduğunda (V2)

Bu işlem, ağdaki yeni bir iletinin ardından sizin tarafınızdan geldiğinde tetiklenir.

Takip edilen akışımda yeni bir ileti olduğunda [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen takip edilen akışımda (V2) yeni bir ileti olduğunda kullanın.

Bu işlem, ağdaki yeni bir iletinin ardından sizin tarafınızdan geldiğinde tetiklenir.

[KULLANIM DIŞI] grubunda yeni bir ileti olduğunda

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Bir grupta yeni ileti olduğunda (V2) kullanın.

Bu işlem, gruba yeni bir ileti gönderildiğinde tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz identifer'i.

Grup Kimliği
group_id True integer

Grubun benzersiz tanımlayıcısı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

Grupta yeni bir ileti olduğunda (V2)

Bu işlem, gruba yeni bir ileti gönderildiğinde tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Ağın benzersiz identifer'i.

Grup Kimliği
group_id True integer

Grubun benzersiz tanımlayıcısı.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageListV2

Takip edilen akışımda yeni bir ileti olduğunda (V2)

Bu işlem, ağdaki yeni bir iletinin ardından sizin tarafınızdan geldiğinde tetiklenir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Bir ağ seçin.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageListV2

Takip edilen akışımda yeni bir ileti olduğunda [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Lütfen takip edilen akışımda (V2) yeni bir ileti olduğunda kullanın.

Bu işlem, ağdaki yeni bir iletinin ardından sizin tarafınızdan geldiğinde tetiklenir.

Parametreler

Name Anahtar Gerekli Tür Description
Ağ Kimliği
network_id string

Bir ağ seçin.

Döndürülenler

Bir veya birden çok iletinin listesi.

İleti Listesi
MessageList

Tanımlar

User

Viva Engage kullanıcısının özellikleri.

Name Yol Tür Description
Kullanıcı adı
name string

Kullanıcı adı.

İş unvanı
job_title string

Kullanıcı işi başlığı.

Yer
location string

Kullanıcı konumu.

Adı ve soyadı
full_name string

Kullanıcı tam adı.

İsim
first_name string

Kullanıcı adı.

Soyadı
last_name string

Kullanıcı soyadı.

Profil url'si
web_url string

Kullanıcı profili URL'si.

E-posta
email string

Kullanıcı e-postası.

Doğum tarihi
birth_date string

Kullanıcı doğum tarihi.

Fotoğraf url'si
mugshot_url string

Kullanıcı fotoğrafı URL'si.

Message

Tek bir Viva Engage iletisinin özellikleri.

Name Yol Tür Description
Kimlik
id integer

Gönderiyle ilişkilendirilmiş kimlik.

Metin
content_excerpt string

Gönderinin Metin İçeriği.

Gönderen
sender_id integer

İletiyi gönderen kullanıcının benzersiz kimliği.

Yanıtlanan:
replied_to_id integer

Bu iletinin yanıt olduğu iletinin kimliği.

Oluşturma Tarihi
created_at string

İletinin oluşturulduğu saat.

network_id integer

Ağ iletisinin kimliği ile ilişkilendirildi.

Türü
message_type string

İleti türünün tanımlayıcısı.

Gönderen Türü
sender_type string

Gönderenin türünün açıklaması.

Bağlantı
url uri

Gönderinin API url'si.

Web Url'si
web_url uri

Gönderinin web url'si.

Grup Kimliği
group_id integer

İletiyi gönderen grubun benzersiz kimliği.

İleti Gövdesi
body MessageBody

Tek bir iletiyle ilişkili içerik.

İş Parçacığı Kimliği
thread_id integer

İş parçacığının benzersiz kimliği.

Doğrudan ileti
direct_message boolean

Gönderinin doğrudan ileti olup olmadığını belirtmek için bayrak ekleyin.

İstemci Kimliği
client_type string

İstemcinin türü.

İstemci URL'si
client_url uri

İstemcinin web bağlantısı.

Language
language string

İletide kullanılan dil.

Etiketli Kullanıcı
notified_user_ids array of integer

Kullanıcıların ayrıntıları bildirilir.

Gizlilik
privacy string

İletiyle ilişkili gizliliğin ayrıntıları.

liked_by
liked_by LikedBy

Beğenen

Sistem İletisi
system_message boolean

Gönderinin sistem tarafından oluşturulan bir ileti olup olmadığını belirtmek için bayrak ekleyin.

Konu başlıkları
topics array of Topic

Konu listesi.

MessageV2

Tek bir Viva Engage iletisinin özellikleri.

Name Yol Tür Description
Kimlik
id integer

Gönderiyle ilişkilendirilmiş kimlik.

Metin
content_excerpt string

Gönderinin Metin İçeriği.

Gönderen
sender_id integer

İletiyi gönderen kullanıcının benzersiz kimliği.

Yanıtlanan:
replied_to_id integer

Bu iletinin yanıt olduğu iletinin kimliği.

Oluşturma Tarihi
created_at string

İletinin oluşturulduğu saat.

network_id integer

Ağ iletisinin kimliği ile ilişkilendirildi.

Türü
message_type string

İleti türünün tanımlayıcısı.

Gönderen Türü
sender_type string

Gönderenin türünün açıklaması.

Bağlantı
url uri

Gönderinin API url'si.

Web Url'si
web_url uri

Gönderinin web url'si.

Grup Kimliği
group_id integer

İletiyi gönderen grubun benzersiz kimliği.

İleti Gövdesi
body MessageBody

Tek bir iletiyle ilişkili içerik.

İş Parçacığı Kimliği
thread_id integer

İş parçacığının benzersiz kimliği.

Doğrudan ileti
direct_message boolean

Gönderinin doğrudan ileti olup olmadığını belirtmek için bayrak ekleyin.

İstemci Kimliği
client_type string

İstemcinin türü.

İstemci URL'si
client_url uri

İstemcinin web bağlantısı.

Language
language string

İletide kullanılan dil.

Etiketli Kullanıcı
notified_user_ids array of integer

Kullanıcıların ayrıntıları bildirilir.

Gizlilik
privacy string

İletiyle ilişkili gizliliğin ayrıntıları.

liked_by
liked_by LikedBy

Beğenen

Sistem İletisi
system_message boolean

Gönderinin sistem tarafından oluşturulan bir ileti olup olmadığını belirtmek için bayrak ekleyin.

Konu

Tek bir konunun özellikleri.

Name Yol Tür Description
Kimlik
id integer

Konunun benzersiz tanımlayıcısı.

İsim
name string

Konunun adı.

PageableMessageList

Bir veya birden çok iletinin listesi.

Name Yol Tür Description
Messages
value array of Message

PageableMessageListV2

Bir veya birden çok iletinin listesi.

Name Yol Tür Description
Messages
value array of MessageV2

İleti Listesi

Bir veya birden çok iletinin listesi.

Name Yol Tür Description
Messages
messages array of Message

messages

MessageListV2

Bir veya birden çok iletinin listesi.

Name Yol Tür Description
Messages
messages array of MessageV2

messages

messagebody

Tek bir iletiyle ilişkili içerik.

Name Yol Tür Description
Metin
parsed string

Ayrıştırılmış metin biçimi.

Düz
plain string

Düz metin biçimi.

Zengin
rich string

Zengin metin biçimi.

LikedBy

Beğenen

Name Yol Tür Description
Sayı
count integer

Farklı beğenilerin sayısı.

Names
names array of object

Gönderiyi beğenen kişilerin listesi.

Adı ve Soyadı
names.full_name string

Gönderiyi beğenen kişinin tam adı.

Tek bir ağın özellikleri.

Name Yol Tür Description
Kimlik
id string

Ağın benzersiz tanımlayıcısı.

İsim
name string

Ağın özeti.

Link
permalink string

Ağ sayfasına web bağlantısı.

YammmerEntity

Tek bir Viva Engage varlığının özellikleri.

Name Yol Tür Description
Description
type string

Viva Engage varlığının ayrıntıları.

Grup Kimliği
id integer

Grubun benzersiz tanımlayıcısı.

Adı ve Soyadı
full_name string

Viva Engage varlığının adı.