Azure İletişim Sohbeti
Azure İletişim Hizmetleri Sohbet özelliklerini kullanmak için bağlayıcı.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | 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 | Premium | 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 | Premium | 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://azure.microsoft.com/services/communication-services |
| E-posta | acssolutions@microsoft.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Microsoft |
| Web sitesi | https://azure.microsoft.com/services/communication-services |
| Gizlilik ilkesi | https://privacy.microsoft.com |
| Kategoriler | Communication |
Azure İletişim Hizmetleri Sohbeti, platformlar arası uygulamalara gerçek zamanlı metin iletişimi eklemeye yardımcı olur.
Önkoşullar
Devam etmek için aşağıdakilere ihtiyacınız olacaktır:
- Özel bağlayıcı özelliğine sahip bir Microsoft Power Apps veya Power Automate planı
- Azure aboneliği
- Azure İletişim Hizmetleri kaynağı
Kimlik bilgilerini alma
1 Azure İletişim Hizmetleri kaynağı ayarlama
2 Bağlantı Dizesi Kimlik Doğrulaması
- Azure İletişim Hizmetleri kaynak uç noktası URL'sini kullanarak yeni bir bağlantı oluşturabilirsiniz.
Bağlayıcınızı kullanmaya başlama
Azure İletişim Hizmetleri kaynağını ayarladıktan sonra bir kullanıcı erişim belirteci oluşturun. Bağlayıcı eylemleri için bu belirteci kullanın.
Bilinen sorunlar ve sınırlamalar
Bu noktada bilinen bir sorun veya sınırlama yoktur.
FAQ
- Nasıl erişim belirteci oluşturabilirim?
- Azure İletişim Hizmetleri Kimlik Bağlayıcısı'nı kullanarak yeni bir kullanıcı kimliği oluşturabilir ve bir kullanıcı için erişim belirteçlerini yenileyebilirsiniz. Ayrıca test için portal aracılığıyla el ile de yapabilirsiniz.
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
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.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Uç Nokta URL'si | securestring | Azure İletişim Hizmetleri uç nokta URL'si. | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Sohbet yazışma iletilerini listeleme |
Sohbet yazışmasından iletileri listeleme. |
| Sohbet yazışmalarını listeleme |
Sohbet yazışmalarını listeleyin. |
| Sohbet yazışmalarını silme |
Sohbet yazışması silin. |
| Sohbet yazışması katılımcıları ekleme |
Sohbet yazışmasına katılımcı ekleyin. |
| Sohbet yazışması katılımcılarını listeleme |
Sohbet yazışmasında katılımcıları listeleyin. |
| Sohbet yazışması katılımcısını kaldırma |
Katılımcıyı sohbet yazışmasından kaldırın. |
| Sohbet yazışması oluşturma |
Sohbet yazışması oluşturun. |
| Sohbet yazışması özelliklerini alma |
Sohbet yazışmasının özelliklerini alın. |
| Sohbet yazışması özelliklerini güncelleştirme |
Sohbet yazışmasının özelliklerini güncelleştirin. |
| Sohbet yazışmasına ileti gönderme |
Sohbet yazışmasına ileti gönderme. |
Sohbet yazışma iletilerini listeleme
Sohbet yazışmasından iletileri listeleme.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Başlangıç Saati
|
startTime | string |
İletileri almak için başlangıç saati RFC3339 biçiminde (yyyy-MM-ddTHH:mm:ssZ). |
|
|
En Büyük Sayfa Boyutu
|
maxPageSize | string |
Sayfa başına döndürülecek ileti sayısı üst sınırı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Listesi
|
value | array of object |
Sohbet iletilerinin koleksiyonu. |
|
Kimlik
|
value.id | string |
Sohbet iletisinin kimliği. Bu kimlik, sunucu tarafından oluşturulur. |
|
Türü
|
value.type | string |
Sohbet iletisi türü. |
|
Sürüm
|
value.version | string |
Sohbet iletisinin sürümü. |
|
Sıra Kimliği
|
value.sequenceId | string |
Konuşmadaki sohbet iletisinin sırası. |
|
message
|
value.content.message | string |
Sohbet iletisi içeriği. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
İletişim tanımlayıcısı. |
|
Konu
|
value.content.topic | string |
Konu başlığı türünde iletiler için sohbet iletisi içeriğiGüncelleştirilmiş. |
|
Katılımcılar
|
value.content.participants | array of object |
participantAdded veya participantRemoved türlerinde iletiler için sohbet iletisi içeriği. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
İletişim tanımlayıcısı. |
|
Gönderen Görünen Adı
|
value.senderDisplayName | string |
Sohbet iletisini gönderenin görünen adı. Bu özellik, anında iletme bildirimleri için gönderen adını doldurmak için kullanılır. |
|
Oluşturulma Tarihi
|
value.createdOn | string |
Sohbet iletisi sunucuya ulaştığında RFC3339 biçimde (yyyy-MM-ddTHH:mm:ssZ) zaman damgası. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
İletişim tanımlayıcısı. |
|
Sonraki Bağlantı
|
nextLink | string |
Alınabilecek daha fazla sohbet iletisi varsa, sonraki bağlantı doldurulur. |
Sohbet yazışmalarını listeleme
Sohbet yazışmalarını listeleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
Başlangıç Saati
|
startTime | string |
Sohbet yazışmalarını almak için başlangıç saati RFC3339 biçimde (yyyy-MM-ddTHH:mm:ssZ). |
|
|
En Büyük Sayfa Boyutu
|
maxPageSize | integer |
Sayfa başına döndürülen en fazla sohbet yazışması sayısı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Sohbet Yazışmaları
|
value | array of object |
Sohbet yazışmaları koleksiyonu. |
|
Kimlik
|
value.id | string |
Sohbet yazışması kimliği. |
|
Konu
|
value.topic | string |
Sohbet yazışması konusu. |
|
Alınan Son İleti
|
value.lastMessageReceivedOn | string |
Son ileti sunucuya ulaştığında RFC3339 biçimde (yyyy-MM-ddTHH:mm:ssZ) zaman damgası. |
|
Silinme Tarihi
|
value.deletedOn | string |
Sohbet yazışması silindiğinde RFC3339 biçimde (yyyy-MM-ddTHH:mm:ssZ) zaman damgası. |
|
Sonraki Bağlantı
|
nextLink | string |
Alınabilecek daha fazla sohbet yazışması varsa, sonraki bağlantı doldurulur. |
Sohbet yazışmalarını silme
Sohbet yazışması silin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
Sohbet yazışması katılımcıları ekleme
Sohbet yazışmasına katılımcı ekleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Kullanıcı kimliği
|
id | string | ||
|
Görüntü adı
|
displayName | string |
Sohbet katılımcısının görünen adı. |
|
|
Time
|
shareHistoryTime | string |
Sohbet geçmişinin paylaşıldığı RFC3339 biçimdeki (yyyy-MM-ddTHH:mm:ssZ) süre. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Geçersiz katılımcı listesi. |
|
Target
|
invalidParticipants.target | string |
Hedef Kimliği. |
|
Kod
|
invalidParticipants.code | string |
Hata kodu. |
|
Message
|
invalidParticipants.message | string |
Hata mesajı. |
Sohbet yazışması katılımcılarını listeleme
Sohbet yazışmasında katılımcıları listeleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Atacak katılımcı sayısı
|
skip | string |
Katılımcıları yanıt olarak belirtilen konuma atlar. |
|
|
Sayfa Başına En Fazla Katılımcı Sayısı
|
maxPageSize | string |
Sayfa başına döndürülecek en fazla katılımcı sayısı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
value
|
value | array of object |
Sohbet katılımcıları. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
İletişim tanımlayıcısı. |
|
İsim
|
value.displayName | string |
Sohbet katılımcısının görünen adı. |
|
Time
|
value.shareHistoryTime | string |
Sohbet geçmişinin paylaşıldığı RFC3339 biçimdeki (yyyy-MM-ddTHH:mm:ssZ) süre. |
|
Sonraki Bağlantı
|
nextLink | string |
Alınabilecek daha fazla sohbet katılımcısı varsa, sonraki bağlantı doldurulur. |
Sohbet yazışması katılımcısını kaldırma
Katılımcıyı sohbet yazışmasından kaldırın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Kullanıcı kimliği
|
id | string |
Sohbet yazışması oluşturma
Sohbet yazışması oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
Sohbet Yazışması Konusu
|
topic | True | string |
Sohbet yazışması konusu. |
|
Kullanıcı kimliği
|
id | string | ||
|
İsim
|
displayName | string |
Sohbet katılımcısının görünen adı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
chatThread.id | string |
Sohbet Yazışması Kimliği |
|
Konu
|
chatThread.topic | string |
Sohbet Yazışması Konusu |
|
Oluşturulma Tarihi
|
chatThread.createdOn | date-time |
Sohbet Oluşturma Zamanı |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
İletişim tanımlayıcısı. |
Sohbet yazışması özelliklerini alma
Sohbet yazışmasının özelliklerini alın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | string |
Sohbet yazışması kimliği. |
|
Konu
|
topic | string |
Sohbet yazışması konusu. |
|
Oluşturulma Tarihi
|
createdOn | string |
İş parçacığının oluşturulduğu zaman. |
|
Silinme Tarihi
|
deletedOn | string |
İş parçacığının silindiği zaman. |
|
Ham Kimlik
|
createdByCommunicationIdentifier.rawId | string |
Tanımlayıcının ham kimliği. |
|
Kimlik
|
createdByCommunicationIdentifier.communicationUser.id | string |
İletişim kullanıcısının kimliği. |
Sohbet yazışması özelliklerini güncelleştirme
Sohbet yazışmasının özelliklerini güncelleştirin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Sohbet Yazışması Konusu
|
topic | string |
Sohbet yazışması konusu. |
Sohbet yazışmasına ileti gönderme
Sohbet yazışmasına ileti gönderme.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Erişim Belirteci
|
Access-Token | True | string |
Kullanıcı erişim belirteci. |
|
İş Parçacığı Kimliği
|
chatThreadId | True | string |
Sohbet Yazışması Kimliği. |
|
Content
|
content | True | string |
İleti içeriği. |
|
İsim
|
senderDisplayName | True | string |
İletiyi gönderenin görünen adı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
kimlik
|
id | string |
kimlik |
Tanımlar
CommunicationIdentifier
İletişim tanımlayıcısı.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kullanıcı kimliği
|
communicationUser.id | string |