共用方式為

從 Azure Bot 下載檔案附件

請遵循下列步驟，從全通路中的 Azure Bot 下載附件。

  1. 取得 Bot 權杖 使用您的機器人的 Microsoft 應用程式識別碼和用戶端密碼。

  2. 從附件 URL 取得 attachmentId。

    例如，如果URL是 https://us-api.asm.skype.com/v1/objects/0-eus-d1-5360689c55c308cb4e3b51722e46b801/，則 是 attachmentId0-eus-d1-5360689c55c308cb4e3b51722e46b801。

  3. 將attachmentId插入到RequestUri變數中，然後在RequestUri請求中使用GET，如下所示：

    string requestUri = $"https://botapi.skype.com/amer/v3/attachments/{attachmentId}/views/original";
var httpRequest = new HttpRequestMessage(HttpMethod.Get, requestUri);

var authorization = new AuthenticationHeaderValue("bearer", <add the botToken here>);
var requestHeaders = new Dictionary<string, string>()
  {
     { "Authorization", authorization.ToString() }
  };

foreach (var header in requestHeaders)
  {
      httpRequest.Headers.Add(header.Key, header.Value);
  }

HttpResponseMessage response = await client.SendAsync(httpRequest);

管理檔案附件

備註

本節中的資訊僅適用於政府社群雲端 （GCC）。

本節說明如何在全通路機器人服務傳訊平台中管理檔案附件。

首先，讓我們快速回顧一下全通路機器人服務管道中的文件附件格式。

檔案附件格式

當檔案附件從 Dynamics 365 Contact Center 傳送至全通路機器人服務通道上的 Azure 機器人時，下載檔案所需的資訊會在 Activity.ChannelData 屬性的 amsReferences 和 amsMetadata 欄位中傳遞。

全通路機器人服務通道

{
   "recipient":{
      "id":"8:acs:5ecf37b1-11 Oc-414g-ab33-804ffd6b4a33_eooe0010-7c57-1ceb-nec-113aOdOOb272",
      "name":"Omnichannel-test-bot",
      "aadObjectId":null,
      "role":null
   },
   "attachments ":null,
   "channelData":{
      "tags":"Channelld-lcw,FromCustomer",
      "deliveryMode":"bridged",
      "fromUserId":"8:acs:5ecf37b1-110c-4149-ab33-804ffd6b4a33_00000010-61 b9-ab1 d-3dfe-9c3aOd009ea4",
      "amsReferences":[
         "0-wus-d6-20e7797d208fab388cc11b09674d166"
      ],
      "amsMetadata":[
         {
            "contentType":"image/png",
            "fileName":"SurnmerTime.png"
         }
      ],
      "sourceChannelId":"omnichannel"
   }
}

如何管理 Azure Bot 程式碼中的檔案附件

附件資訊會在全通路機器人服務通道中傳遞，並且可以在機器人程式碼中存取，如以下範例所示。

// 1. Retrieve Attachment ID from ChannelData["amsReferences"]
if (turnContext.Activity.ChannelData != null &&
    turnContext.Activity.ChannelData is JObject incomingRequestChannelData &&
    incomingRequestChannelData.TryGetValue("amsReferences", out JToken amsReferencesArray))
{
    string attachmentId = JsonConvert.DeserializeObject<string[]>(amsReferencesArray.ToString()).FirstOrDefault();

    // 2. Build HTTP request for specified attachment ID.
    string requestUri = $"https://botapi.skype.com/amer/v3/attachments/{attachmentId}/views/original";
    var httpRequest = new HttpRequestMessage(HttpMethod.Get, requestUri);

    // 3. Acquire authentication token and add it to request headers
    var token = await new MicrosoftAppCredentials("botAppId", "botAppSecret").GetTokenAsync();
    var authorization = new AuthenticationHeaderValue("bearer", token);
    httpRequest.Headers.Add("Authorization", authorization.ToString());

    // 4. Add Azure Communication Services Bot ID to request header. This is required to achieve good download performance.
    httpRequest.Headers.Add("BotAcsId", turnContext.Activity.Recipient.Id);

    // 5. Use HttpClient to execute the request and download attachment
    var response = await client.SendAsync(httpRequest);
    
    // 6. Save HTTP response stream to the file
    var responseContentStream = await response.Content.ReadAsStreamAsync();
    using (FileStream fileCreateStream = new FileStream("file path", FileMode.Create))
    {
        fileCreateStream.CopyTo(responseContentStream);
    }
}

各渠道的卡片支持
支援即時聊天和非同步管道

  • Last updated on