Bot BağlayıcıSı API'siyle ileti oluşturma
Botunuz, kullanıcılara bilgi iletmek için ileti türünde Etkinlik nesneleri gönderir ve benzer şekilde kullanıcılardan ileti etkinlikleri de alır. Bazı iletiler düz metinden, bazıları ise konuşulacak metin, önerilen eylemler, medya ekleri, zengin kartlar ve kanala özgü veriler gibi daha zengin içerikler içerebilir. Bu makalede yaygın olarak kullanılan ileti özelliklerinden bazıları açıklanmaktadır.
İleti metni ve biçimlendirme
İleti metni düz, markdown veya xml kullanılarak biçimlendirilebilir. Özelliğin textFormat varsayılan biçimi markdown'dır ve Markdown biçimlendirme standartlarını kullanarak metni yorumlar. Metin biçimi desteğinin düzeyi kanallar arasında farklılık gösterir.
İpucu
Her kanalda hangi özelliklerin desteklendiği hakkında bilgi için kanallar başvuru makalesine bakın.
textFormat
Activity nesnesinin özelliği, metnin biçimini belirtmek için kullanılabilir. Örneğin, yalnızca düz metin içeren temel bir ileti oluşturmak için, nesnenin Activity özelliğini düz olarak ayarlayıntextFormat, özelliği iletinin içeriğine ayarlayın text ve özelliği gönderenin yerel ayarına ayarlayınlocale.
Ekler
attachments
Activity nesnesinin özelliği, basit medya ekleri (görüntü, ses, video, dosya) ve zengin kartlar göndermek için kullanılabilir. Ayrıntılar için bkz. İletilere medya ekleri ekleme ve İletilere zengin kartlar ekleme.
Varlıklar
entities
Activity nesnesinin özelliği, kanal ve bot arasında ortak bağlamsal meta verilerin değişimine izin veren açık uçlu schema.org nesneleri dizisidir.
Varlıklardan bahsetme
Birçok kanal, botun veya kullanıcının konuşma bağlamında birinden "bahsetmesini" destekler. İletideki bir kullanıcıdan bahsetmek için iletinin entitiesözelliğini bahsetme nesnesiyle doldurun.
Varlıkları yerleştirme
Konumla ilgili bilgileri ileti içinde iletmek için iletinin entities özelliğini Nesneleri yerleştir ile doldurun.
Kanal verileri
channelData
Activity nesnesinin özelliği kanala özgü işlevleri uygulamak için kullanılabilir. Ayrıntılar için bkz. Kanala özgü işlevselliği uygulama.
Metin okuma
speak
Konuşma özellikli bir kanalda botunuz tarafından konuşulacak metni belirtmek için Activity nesnesinin özelliği ve inputHint istemcinin Activity mikrofonunun durumunu etkilemek için nesnenin özelliği kullanılabilir. Ayrıntılar için bkz. İletilere konuşma ekleme ve İletilere giriş ipuçları ekleme.
Önerilen eylemler
suggestedActions
Activity nesnesinin özelliği, kullanıcının giriş sağlamak için dokunabileceği düğmeleri sunmak için kullanılabilir. Zengin kartlarda görünen düğmelerin aksine (dokunulduğunda bile görünür ve kullanıcı tarafından erişilebilir durumda kalır), kullanıcı seçim yaptıktan sonra önerilen eylemler bölmesinde görünen düğmeler kaybolur. Ayrıntılar için bkz. İletilere önerilen eylemleri ekleme.