Eyleme Dönüştürülebilir İletiler için Outlook kanalına bot Bağlan (Önizleme)

Makale
10/24/2023

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Eyleme Dönüştürülebilir İletiler, kullanıcıların Outlook'un içinden hızlı işlemler gerçekleştirmesine olanak sağlar. Bir botu Outlook Eyleme Dönüştürülebilir İletiler kanalına bağladığınızda, botunuz eyleme dönüştürülebilir iletiler oluşturmak ve kullanıcı katılımını geliştirmek için Uyarlamalı Kartlar kullanabilir.

Dekont

Eyleme Dönüştürülebilir İletiler için Outlook kanalı genel önizleme aşamasındadır. Önizlemede yer alan özellikler tamamlanmayabilir ve genel sürümde kullanıma sunulmadan önce değişikliklere tabi tutulabilir. Bunlar yalnızca değerlendirme ve araştırma amacıyla sağlanır.

Uyarı

İstenmeyen veya istenmeyen toplu e-posta gönderen botlar da dahil olmak üzere "istenmeyen posta botları" oluşturmak Bot Framework Davranış Kuralları'nın ihlalidir.

Ön koşullar

Uyarlamalı Kartlar ve Evrensel Eylem Modeli bilgisi.
Outlook ve Office 365 Gruplarında Eyleme Dönüştürülebilir iletiler hakkında bilgi.
Azure'a dağıtılan kanala hazır bir bot.
Botunuzun ileti göndermek ve almak için kullanacağı ayrılmış bir e-posta adresi.

Dekont

Botlar için kendi kişisel e-posta hesaplarınızı kullanmayın çünkü bu e-posta hesabına gönderilen her ileti bota iletilir. Bu, botunun gönderene uygunsuz bir şekilde yanıt göndermesine neden olabilir. Bu nedenle botlar yalnızca ayrılmış O365 e-posta hesaplarını kullanmalıdır.
Microsoft Exchange Server kullanıyorsanız, e-posta kanalını yapılandırmadan önce Otomatik Bulma'yı etkinleştirin.

İletileri tasarlama

Eyleme Dönüştürülebilir İletiler için Outlook kanalı, e-posta üzerinden Uyarlamalı Kartlar gönderir ve alır.

Eyleme dönüştürülebilir ileti kartları tasarlamak ve test etmek için Eyleme Dönüştürülebilir İleti Tasarım Aracı kullanabilirsiniz.

Önemli

Evrensel Bot eylem modeli Uyarlamalı Kartlar şema sürümü 1.4'te sunulmuştur. Bu yeni özellikleri kullanmak için Uyarlamalı Kartınızın sürüm özelliği 1.4 veya üzeri olarak ayarlanmalıdır. Uyarlamalı Kartlar Şema Gezgini'nde Action.Execute bölümüne bakın.

Botu uygulama ve dağıtma

Genel akış, bota kullanıcıya eyleme dönüştürülebilir bir ileti göndermesi ve ardından kullanıcının eylemini işlemesi içindir.

Kullanıcı kartı e-postayla yanıtladığında, Outlook bota bir çağırma etkinliği gönderir. Etkinliğin value özelliği , verbve data özelliklerine sahip typebir eylem nesnesi içerir. Örneğin, etkinlik aşağıdaki bilgileri içerir. Burada fiil ve veriler bot tarafından başlangıçta gönderilen kart üzerindeki bilgilere karşılık gelir.
```
"type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}
```
Nesne şemasının tamamı için Uyarlamalı Kartlar Şema Gezgini'nde Action.Execute bölümüne bakın.
Bot, gelen çağırma etkinliğini işler ve özgün Uyarlamalı Kartın yerini alacak yeni bir Uyarlamalı Kart içeren bir sonuç döndürür. Çağırma yanıtı şöyle görünebilir:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

Erişim isteğinde bulunma

Bot kaynağınızı Azure portalında açın.
Kanallar bölmesini açın.
Outlook kanalını seçin.
Outlook'u Yapılandır sayfasında lütfen buradan kaydolun'u seçin.
Erişim istemek için kayıt formunu doldurun. Daha fazla bilgi için bkz . Hizmetinizi eyleme dönüştürülebilir e-posta geliştirici panosuna kaydetme.

Sonraki adımlar

Outlook ve Office 365 Gruplarında Eyleme Dönüştürülebilir iletiler hakkında daha fazla bilgi edinin.
Outlook Eyleme Dönüştürülebilir İleti Geliştiricileri için Uyarlamalı Kartlar hakkında daha fazla bilgi edinin

Aracılığıyla paylaş