Descarga archivos adjuntos desde un bot de Azure

En este artículo se describe cómo descargar datos adjuntos de archivos desde un bot de Azure que se usa con mensajería en Dynamics 365 Customer Service.

Para descargar datos adjuntos desde un bot de Azure, complete los pasos siguientes:

  1. Obtenga el token para su bot mediante el ID de la aplicación de Microsoft y el secreto del cliente de su bot.

  2. Obtenga el attachmentId de la matriz amsReferences en los datos del canal de la actividad.

    Por ejemplo, si el amsReferences contiene ["0-eus-d1-5360689c55c308cb4e3b51722e46b801"], entonces el attachmentId es 0-eus-d1-5360689c55c308cb4e3b51722e46b801.

  3. Inserte el attachmentId en una variable RequestUri y luego use RequestUri en una solicitud GET, así:

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>);
httpRequest.Headers.Authorization = authorization;
httpRequest.Headers.Add("BotAcsId", activity.Recipient.Id);

HttpResponseMessage response = await client.SendAsync(httpRequest);

Administrar archivos adjuntos

Note

La información de esta sección se aplica solo a Government Community Cloud (GCC).

En esta sección se describe cómo administrar los archivos adjuntos en el canal de mensajería.

En primer lugar, revise los formatos de archivos adjuntos en el canal de mensajería.

Formatos de archivos adjuntos

Cuando los datos adjuntos de archivos se envían desde Dynamics 365 Contact Center al agente de Azure en el canal de mensajería, la información necesaria para descargar los archivos se pasa en los campos amsReferences y amsMetadata de la propiedad Activity.ChannelData.

Canal de mensajería

{
   "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"
   }
}

Cómo administrar archivos adjuntos en el código del agente de Azure

La información de datos adjuntos se pasa en el canal de servicio del agente Omnichannel y se puede acceder a ella en el código del agente, como se muestra en el ejemplo siguiente.

// 1. Retrieve Attachment ID from ChannelData["amsReferences"]
if (activity.ChannelData != null &&
    activity.ChannelData is Dictionary<string, JsonElement> channelData &&
    channelData.TryGetValue("amsReferences", out var amsReferencesElement))
{
    var amsReferencesString = amsReferencesElement.GetString() ?? amsReferencesElement.ToString();
    string attachmentId = JsonConvert.DeserializeObject<string[]>(amsReferencesString).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
    // Option A: Using IConnections (recommended)
    var connection = connections.GetConnection("ServiceConnection");
    var token = await connection.GetAccessTokenAsync(
        "https://api.botframework.com",
        new[] { "https://api.botframework.com/.default" },
        forceRefresh: false);

    // Option B: Using OAuth client credentials flow
    // var tokenRequest = new HttpRequestMessage(HttpMethod.Post, $"https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token")
    // {
    //     Content = new FormUrlEncodedContent(new Dictionary<string, string>
    //     {
    //         { "grant_type", "client_credentials" },
    //         { "client_id", botAppId },
    //         { "client_secret", botAppSecret },
    //         { "scope", "https://api.botframework.com/.default" }
    //     })
    // };
    // var tokenResponse = await client.SendAsync(tokenRequest);
    // var tokenContent = await tokenResponse.Content.ReadAsStringAsync();
    // var token = JsonConvert.DeserializeObject<dynamic>(tokenContent).access_token;

    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", 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))
    {
        await responseContentStream.CopyToAsync(fileCreateStream);
    }
}

Soporte de tarjeta por canal
Soporte para chat en vivo y canales asincrónicos

  • Last updated on