Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.
La API de Microsoft 365 Copilot Chat permite crear y continuar conversaciones de varios turnos con Microsoft 365 Copilot, a la vez que respeta los controles de acceso definidos dentro de la organización. Use chat API para integrar Microsoft 365 Copilot en las soluciones de IA generativas.
En esta documentación se trata la creación de conversaciones de Copilot mediante chat API. Obtenga información sobre cómo continuar conversaciones sincrónicas o conversaciones en secuencias con chat API.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Sites.Read.All, Mail.Read, Personas. Read.All, OnlineMeetingTranscript.Read.All, Chat.Read, ChannelMessage.Read.All, ExternalItem.Read.All* | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | No admitida. | No admitida. |
* Necesita todos estos permisos de Microsoft Graph para llamar correctamente a la API de Microsoft 365 Copilot Chat.
Solicitud HTTP
POST https://graph.microsoft.com/beta/copilot/conversations
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
Authorization |
Bearer {token}. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un cuerpo JSON vacío.
Respuesta
Si se ejecuta correctamente, esta acción devuelve un 201 Created código de respuesta y una copilotConversation en el cuerpo de la respuesta.
Ejemplo
En el ejemplo siguiente se muestra cómo crear una conversación de Copilot a través de la API de Microsoft 365 Copilot Chat. Una vez creada la conversación, id en el cuerpo de la respuesta se usa como parámetro de ruta de acceso para continuar la conversación, ya sea mediante el punto de conexión sincrónico o el punto de conexión transmitido.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/copilot/conversations
Content-Type: application/json
{}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0d110e7e-2b7e-4270-a899-fd2af6fde333",
"createdDateTime": "2025-09-30T15:28:46.1560062Z",
"displayName": "",
"status": "active",
"turnCount": 0
}