Crear conversaciónCreate conversation

Espacio de nombres: Microsoft. Graph cree una nueva conversación incluyendo un hilo y una publicación.Namespace: microsoft.graph Create a new conversation by including a thread and a post.

Use responder hilo o responder publicación para agregar publicaciones a la conversación.Use reply thread or reply post to further post to that conversation.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP request

POST /groups/{id}/conversations

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto conversation que contiene un conversationThread y un post.In the request body, supply a JSON representation of conversation object containing a conversationThread and a post.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y el objeto conversation en el cuerpo de la respuesta.If successful, this method returns 201 Created response code and conversation object in the response body.

La respuesta incluye los Id. de la conversación e hilo nuevos, que puede usar en la operación de publicaciones de lista para obtener también la nueva publicación.The response includes the IDs for the new conversation and thread, which you can use in the list posts operation to get the new post as well.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request.

POST https://graph.microsoft.com/v1.0/groups/29981b6a-0e57-42dc-94c9-cd24f5306196/conversations
Content-type: application/json

{
  "topic":"New locations for this quarter",
  "threads":[
    {
      "posts":[
        {
          "body":{
            "contentType":"html",
            "content":"What do we know so far?"
          },
          "newParticipants":[
            {
              "emailAddress":{
                "name":"Adele Vance",
                "address":"AdeleV@contoso.onmicrosoft.com"
              }
            }
          ]
        }
      ]
    }
  ]
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.The following is an example of the response.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations/$entity",
  "id":"AAQkADDVKtMlRp4Txc6k=",
  "threads@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations('AAQkADDVKtMlRp4Txc6k%3D')/threads",
  "threads":[
    {
      "id":"AAQkADQDarUNUq0yVGnhPFzqQ=="
    }
  ]
}