Direct Line API 1.1'de konuşma başlatma
Önemli
Bu makalede, Direct Line API 1.1 kullanarak konuşma başlatma açıklanmaktadır. İstemci uygulamanız ve botunuz arasında yeni bir bağlantı oluşturuyorsanız bunun yerine Direct Line API 3.0 kullanın.
Direct Line konuşmalar istemciler tarafından açıkça açılır ve bot ve istemci katıldığı ve geçerli kimlik bilgilerine sahip olduğu sürece çalıştırılabilir. Konuşma açıkken hem bot hem de istemci ileti gönderebilir. Belirli bir konuşmaya birden fazla istemci bağlanabilir ve her istemci birden çok kullanıcı adına katılabilir.
Yeni bir konuşma açma
Botla yeni bir konuşma açmak için şu isteği sorun:
POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN
Aşağıdaki kod parçacıkları Konuşma Başlatma isteği ve yanıtının bir örneğini sağlar.
İstek
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Yanıt
İstek başarılı olursa, yanıt konuşma için bir kimlik, bir belirteç ve belirtecin süresi dolana kadar geçen saniye sayısını belirten bir değer içerir.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Konuşmayı Başlat ve Belirteç Oluştur karşılaştırması
Konuşma Başlatma işlemi (POST /api/conversations), her iki işlem de tek bir konuşmaya erişmek için kullanılabilecek bir token döndüren Belirteç Oluşturma işlemine (POST /api/tokens/conversation) benzer. Bununla birlikte, Konuşmayı Başlat işlemi de konuşmayı başlatır ve botla iletişim kurarken Belirteç Oluştur işlemi bunların hiçbirini yapmaz.
Konuşmayı hemen başlatmak istiyorsanız Konuşmayı Başlat işlemini kullanın. Belirteci istemcilere dağıtmayı planlıyorsanız ve konuşma başlatmalarını istiyorsanız, bunun yerine Belirteç Oluştur işlemini kullanın.