Direct Line API 3.0'da konuşma başlatma
Direct Line konuşmaları açıkça istemciler tarafından 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
İstemcinizden yeni bir konuşma açmak için POST'u /v3/directline/conversations uç noktasına gönderin.
POST https://directline.botframework.com/v3/directline/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/v3/directline/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Yanıt
İstek başarılı olursa, yanıt konuşma için bir kimlik, belirteç, belirtecin süresi dolana kadar geçen saniye sayısını gösteren bir değer ve istemcinin WebSocket akışı aracılığıyla etkinlikleri almak için kullanabileceği bir akış URL'si içerir.
HTTP/1.1 201 Created
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800,
"streamUrl": "https://directline.botframework.com/v3/directline/conversations/abc123/stream?t=RCurR_XV9ZA.cwA..."
}
Genellikle, yeni bir konuşmayı açmak için konuşma başlatma isteği kullanılır ve yeni konuşma başarıyla başlatılırsa HTTP 201 durum kodu döndürülür. Ancak, bir istemci, üst bilgide Authorization daha önce konuşma başlatma işlemi kullanılarak konuşma başlatmak için kullanılan bir Direct Line belirteci ile bir konuşma başlatma isteği gönderirse, isteğin kabul edilebilir olduğunu ancak hiçbir konuşma oluşturulmadığını (zaten mevcut olduğu gibi) belirten bir HTTP 200 durum kodu döndürülür.
İpucu
WebSocket akış URL'sine bağlanmak için 60 saniyeniz var. Bu süre boyunca bağlantı kurulamıyorsa, yeni bir akış URL'si oluşturmak için konuşmaya yeniden bağlanabilirsiniz .
Konuşma başlatma ve belirteç oluşturma
Konuşma başlatma işlemi (POST /v3/directline/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 /v3/directline/tokens/generate) benzer. Ancak konuşma başlatma işlemi ayrıca konuşmayı başlatır, botla iletişim kurar ve bir WebSocket akış URL'si oluştururken belirteç oluşturma işlemi bunların hiçbirini yapmaz.
İstemcinizle konuşmayı hemen başlatmak istiyorsanız konuşma başlatma işlemini kullanın. Belirteci istemcilere dağıtmayı planlıyorsanız ve konuşma başlatmalarını istiyorsanız, bunun yerine belirteç oluşturma işlemini kullanın.