Kanallar başvurusu
ŞUNLAR IÇIN GEÇERLIDIR: SDK v4
Bu makalede çeşitli Bot Framework özellikleri için kanal desteği özetlenmektedir:
- Her kanalın gönderebileceği veya alabileceği etkinlik türleri.
- Uyarlamalı Kartlar da dahil olmak üzere her kanalın görüntüleyebileceği kart türleri.
- Her kanalda kart eylemi ve önerilen eylem desteği.
- Farklı etkinlik türlerinin genel sınıflandırması.
Protokol düzeyinde etkinliklerin ve kartların yapısı hakkında ayrıntılı bilgi için bkz. Bot Framework etkinliği ve kart şemaları.
Uyarlamalı Kartlar ayrı bir teknolojidir. Daha fazla bilgi için bkz . adaptivecards.io.
Kanala göre etkinlik desteği
Aşağıdaki tabloda, belirli bir kanalın botunuza belirli bir etkinlik türü gönderip gönderemeyeceği gösterilir. Tabloda, aşağıdaki terimler aşağıdaki anlamlara sahiptir.
| Süre | Anlamı |
|---|---|
| Evet | Bot bu etkinliği kanaldan alabilir. |
| Hayır | Bot bu etkinliği kanaldan alamaz. |
| Belirsiz | Şu anda belirlenmemiş. |
| Kanal | kişi ilişkisi güncelleştirmesi | Konuşma güncelleştirmesi | Konuşma sonu | Olay | Yükleme güncelleştirmesi | Çağır | Mesaj | İleti tepkisi | İleti güncelleştirmesi | İleti silme | Yazım |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Alexa | Hayır | Hayı | Evet | Evet | Hayı | Hayı | Evet | Hayı | Hayı | Hayı | Hayır |
| Azure Communication Services Chat | No. | Evet | Hayı | Evet | Hayı | Hayı | Evet | Hayı | Evet | Evet | Evet |
| Direct Line | No. | Evet | Evet | Evet | Evet | Hayı | Evet | Hayı | Hayı | Hayı | Evet |
| Direct Line Speech | Evet | ||||||||||
| E-posta | Hayır | Hayı | Hayır | Belirsiz | Hayır | Hayı | Evet | Hayı | Hayı | Hayı | Hayır |
| No. | Evet | Hayı | Evet | Hayı | Hayı | Evet | Evet | Hayı | Hayı | Hayır | |
| GroupMe | No. | Evet | Hayır | Belirsiz | Hayır | Hayı | Evet | Hayı | Hayı | Hayı | Hayır |
| LINE | No. | Evet | Hayı | Evet | Hayı | Hayı | Evet | Hayı | Hayı | Hayı | Hayır |
| Microsoft Teams | No. | Evet | Hayır | Belirsiz | No. | Evet | Evet | Evet | Evet | Evet | Hayır |
| Çok yönlü kanal | Evet | ||||||||||
| Outlook (önizleme) | Evet | ||||||||||
| Arama (önizleme) | Evet | ||||||||||
| Slack | No. | Evet | Hayır | Belirsiz | Hayır | Hayı | Evet | Hayı | Evet | Evet | Hayır |
| Telegram | No. | Evet | Hayır | Belirsiz | Hayır | Hayı | Evet | Hayı | Evet | Belirsiz | Hayır |
| Twilio (SMS) | Hayır | Hayı | Hayır | Belirsiz | Hayır | Hayı | Evet | Hayı | Hayı | Hayı | Hayır |
| Web Sohbeti | No. | Evet | Evet | Evet | Evet | Hayı | Evet | Hayı | Hayı | Hayı | Evet |
ve invoke etkinlikleri için event destek, etkinliğin adına göre değişir ve kanala göre değişir.
Kanala göre kart desteği
Aşağıdaki tabloda, belirli bir kanalın belirli bir kart türünü işleyip işleyemeyeceği gösterilir. Kanal kart türünü işleyemese bile, kanal kart üzerindeki tüm özellikleri desteklemeyebilir. Botunuzu yayınlamadan önce botunuzun gönderebileceği her kartın davranışını test edin.
Tabloda, aşağıdaki terimler aşağıdaki anlamlara sahiptir.
| Süre | Anlamı |
|---|---|
| Evet | Kart bu kanalda desteklenir; ancak, belirli bir kanal yalnızca kart eylemlerinin bir alt kümesini destekleye veya her kartta izin verilen eylem sayısını sınırlayabilir. |
| Hayır | Kart bu kanalda desteklenmiyor. |
| Kısmi | Kısmi destek. Kart girişler veya düğmeler içeriyorsa bu kanal kartı görüntülemeyebilir. Destek düzeyi kanala göre değişir. |
| Görsel | Kart görüntüye dönüştürülür. |
| Metin | Kart biçimlendirilmemiş metne dönüştürülür. Bağlantılar tıklanabilir olmayabilir, resimler görüntülenmeyebilir ve medya oynatılamayabilir. Destek düzeyi kanala göre değişir. |
| Kanal | Uyarlamalı Kart | Animasyon kartı | Ses kartı | Hero kartı | Makbuz kartı | Oturum açma kartı | Küçük resim kartı | Ekran kartı |
|---|---|---|---|---|---|---|---|---|
| Alexa | Hayır | Hayı | Hayı | Evet | Hayı | Evet | Hayı | Hayır |
| Azure Communication Services Chat | Evet* | Evet | Evet | Evet | Evet | Evet | Evet | Evet |
| E-posta | Görsel | Metin | Metin | Evet | Evet | Evet | Evet | Metin |
| Resim, kısmi | Evet | Evet | Evet | Evet | Evet | Evet | Evet | |
| GroupMe | Görsel | Metin | Metin | Metin | Metin | Metin | Metin | Metin |
| LINE | Resim, kısmi | Evet | Metin | Evet | Evet | Evet | Evet | Metin |
| Microsoft Teams | Evet | Hayı | Hayı | Evet | Evet | Evet | Evet | Hayır |
| Çok yönlü kanal | ||||||||
| Outlook (önizleme) | ||||||||
| Arama (önizleme) | ||||||||
| Slack | Görüntü | Evet | Metin | Metin | Evet | Evet | Metin | Metin |
| Telegram | Resim, kısmi | Evet | Metin | Evet | Evet | Evet | Evet | Evet |
| Twilio (SMS) | Görsel | Metin | Hayır | Metin | Metin | Metin | Metin | Hayır |
| Web Sohbeti | Evet | Evet | Evet | Evet | Evet | Evet | Evet | Evet |
Dekont
- Direct Line kanalı teknik olarak tüm kartları destekler, ancak bunları uygulamak istemcinin görevidir.
- *Azure İletişim Hizmetleri Sohbet için Uyarlamalı kartlar yalnızca Azure İletişim Hizmetleri kullanım örnekleri içinde desteklenir, Teams kullanım örneklerine Azure İletişim Hizmetleri için desteklenmez.
Kanala göre kart eylemi desteği
Aşağıdaki tabloda, belirli bir kanalın desteklediği önerilen eylem ve kart eylemi sayısı üst sınırı gösterilmektedir. "Hiçbiri" değeri, eylem türünün kanalda desteklenmediğini gösterir.
| Kanal | Önerilen eylemler | Kart eylemleri |
|---|---|---|
| Alexa | Hiçbiri | Hiçbiri |
| Azure Communication Services Chat | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| E-posta | Hiçbiri | Hiçbiri |
| 11 | 3 | |
| GroupMe | Hiçbiri | Hiçbiri |
| LINE | 13 | 99 |
| Microsoft Teams | Hiçbiri | 3 |
| Çok yönlü kanal | ||
| Outlook (önizleme) | ||
| Arama (önizleme) | ||
| Slack | Hiçbiri | 100 |
| Telegram | 100 | 100 |
| Twilio (SMS) | Hiçbiri | Hiçbiri |
| Web Sohbeti | 100 | 100 |
- Kart eylemleri hakkında daha fazla bilgi için İletilere medya ekleme makalesindeki Zengin kartlardaki olayları işleme bölümüne bakın.
- Önerilen eylemler hakkında daha fazla bilgi için bkz. Giriş için düğmeleri kullanma.
Etkinlik kategorileri
Etkinlikler ayrı kategorilere ayrılabilir. Her etkinlik türünün ayrıntılı açıklaması ve her etkinlik türünün içerdiği bilgiler için bkz . Bot Framework etkinlik şeması.
Hoş geldiniz
Bu kategori ve contactRelationUpdate etkinliklerini conversationUpdate içerir.
- Birçok kanal konuşma güncelleştirme etkinlikleri gönderir.
- Bot karşılama davranışı genellikle konuşma güncelleştirme etkinliği tarafından tetikler. Ancak, güvenilir karşılama davranışı üretmek için konuşma veya kullanıcı durumunun kullanılması gerekebilir.
- Bazı kanallar kişi ilişkisi güncelleştirme etkinlikleri gönderir.
- Botunuz bu kanalları kullanıyorsa, botunuzun hoş geldiniz davranışına bu etkinlik için mantık eklemeniz gerekebilir.
Konuşma
Bu kategori , messageReactionve endOfConversation etkinliklerini içerirmessage.
- Tüm kanallar ileti etkinlikleri gönderebilir ve alabilir.
- İletişim kutularını kullanan botlar için ileti etkinlikleri genellikle iletişim kutusuna geçirilmelidir.
- Bazı kanallar ileti tepkisi etkinlikleri gönderebilir ve alabilir.
- Botunuzun tasarımına bağlı olarak ileti tepkisi etkinliklerini bir iletişim kutusuna geçirebilirsiniz.
- İleti tepkisi etkinlikleri, kimliklerine göre önceki iletilere başvurur.
- Konuşma sonu etkinlikleri, gönderenin bakış açısından bir konuşmanın sonunu gösterir.
- Konuşma sonu etkinlikleri, beceriler için bot-bot iletişiminde kullanılır.
Bahşiş
İleti tepkisi , önceki bir açıklamada başparmak yukarı gibi şeyleri içerir. Bunlar sıra dışı olabilir, bu nedenle düğmelere benzer olarak düşünülebilirler. Bu etkinlik türü Teams kanalı tarafından gönderilebilir.
İleti güncelleştirme ve silme
Bu kategori ve messageDelete etkinliklerini messageUpdate içerir.
- Teams, ileti güncelleştirme ve silme etkinliklerini destekler.
Uygulama genişletilebilirliği
Bu kategori ve invoke etkinliklerini event içerir.
Etkinliğin anlamı, kanal kapsamında anlamlı olan alanıyla name tanımlanır.
- hem istemciye hem de sunucuya sahip olan bir uygulama, istemci ve sunucu arasında programlı bilgileri iletmek için olay etkinliklerini kullanabilir.
- Etkinlik türlerinin çoğu gibi olay etkinlikleri zaman uyumsuz olur.
- Direct Line ve Web Sohbeti olay etkinliklerini genişletilebilirlik mekanizması olarak kullanır.
- Çağırma etkinlikleri bir uygulamaya özeldir ve istemcinin tanımlayacağı bir şey değildir.
- Diğer etkinlik türlerinden farklı olarak çağırma etkinlikleri zaman uyumlu olur. (Invoke şu anda botta istek-yanıt davranışını tetikleyen tek etkinlik türüdür.)
- Microsoft Teams, çağırma etkinliklerini kullanır ve Teams'e özgü birkaç çağırma etkinliğini tanımlar.
Kimlik Doğrulaması
OAuth isteminin iletişim kutularıyla çalışması için çağırma etkinliğinin TeamsVerification iletişim kutusuna iletilmesi gerekir.
Kategorilere ayrılmamış
installationUpdate, typingve handoff etkinlikleri diğer kategorilere anlamlı bir şekilde sığmaz.
- Yükleme güncelleştirme etkinlikleri, kanalın kuruluş birimi içindeki bir botun yüklenmesini veya kaldırılmasını temsil eder.
- Yazma etkinlikleri, bir kullanıcı veya bottan gelen devam eden girişleri temsil eder.
- İletim etkinlikleri bot içindeki öğeler arasındaki odak değişikliğini ister veya sinyal gönderir. İletim etkinliği, "handoff " adlı bir olay etkinliğinden farklıdır.
Kullanım dışı (ödemeye özgü çağrıyı içerir)
Bu etkinlik türleri artık kullanımda değildir:
deleteUserDatahandoffpingAddressÇağırmakPaymentRequestÇağırmak
Ek bilgi
Tüm kanallar etkinlik gönderebilir ve alabilir message .
Bahşiş
Botunuza bir kanal için destek eklerken kanalın geliştirici belgeleri hakkında bilgi edinin. Her kanalın konuşmanın çeşitli yönleriyle ilgili farklı sınırlamaları vardır. Farklılıklardan bazıları şunlardır:
- Botların her HTTP isteğini işlemek için ne kadar zamanı olduğunu.
- Botların belirli bir kullanıcı etkinliğine yanıt olarak olmayan bir etkinlik gönderip gönderemeyeceği.
- Botların belirli bir zaman dilimi içinde gönderebileceği ileti sayısı.
- Bir kartın nasıl işlendiği ve hangi kartların desteklendiği.