Cómo publicar mensajes en Microsoft Teams desde C++ (WinHTTP + Graph API)

¿Quieres publicar mensajes automáticamente en el chat de Microsoft Teams?
Para eso puedes usar la Microsoft Graph API.
En este artículo, presentaremos un ejemplo de código en C++ usando WinHTTP ** y los ** pasos de autenticación de la API necesarios, paso a paso.

🔧 Preparación necesaria (Configuración de autenticación de Microsoft Graph API)

1. Registrar la aplicación en el portal de Azure

Primero, para usar la Microsoft Graph API, debes registrar una aplicación en Azure.

Accede al Azure Portal
Ve a “Microsoft Entra ID ” > “+ Agregar ” > “ Registros de aplicaciones ” > “ Nuevo registro”
Ingresa un nombre para la aplicación y haz clic en “Registrar”

2. Agregar permisos de API

Ve al menú izquierdo “Permisos de API”
En “Microsoft Graph ” > “ Permisos delegados ” (o seleccionar permisos), busca los siguientes ámbitos (scopes) y haz clic en “ Actualizar permisos” (o agregar permisos)

Chat.ReadWrite
User.Read

※ Si deseas publicar en un canal, también necesitarás ChannelMessage.Send

3. Anotar el ID del cliente y el ID del inquilino (tenant)

Anota los siguientes dos valores que se muestran en la pestaña “Información general”:

ID de la aplicación (cliente)
ID del directorio (inquilino)

4. Crear un secreto de cliente

Ve a la pestaña “Certificados y secretos”
Selecciona “Nuevo secreto de cliente” > Establece una fecha de expiración y haz clic en “Agregar”
Asegúrate de copiar el valor mostrado (secreto) en este momento, ya que no podrás verlo después

🔐 Obtener el token de acceso (OAuth2)

Para obtenerlo, usaremos el flujo client_credentials.
Ejecuta el siguiente comando con curl para obtener el token de acceso.

1
2
3
4
5
6
7
curl -X POST ^
  https://login.microsoftonline.com/{ID_del_inquilino}/oauth2/v2.0/token ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "client_id={ID_del_cliente}" ^
  -d "scope=https%3A%2F%2Fgraph.microsoft.com%2F.default" ^
  -d "client_secret={Secreto_de_cliente}" ^
  -d "grant_type=client_credentials"

Ejemplo de respuesta

1
2
3
4
5
6
{
  "token_type":"Bearer",
  "expires_in":3599,
  "ext_expires_in":3599,
  "access_token": "eyJ0eXAiOiJKV1QiLCJub... (omitido)"
}

Usaremos este access_token para llamar a la Microsoft Graph API.

💬 Ejemplo en C++ para publicar en el chat de Teams

Aquí mostramos un ejemplo en C++ que usa WinHTTP para publicar en el chat.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
#include <windows.h>
#include <winhttp.h>
#include <iostream>
#include <string>

#pragma comment(lib, "winhttp.lib")

void PostToTeamsChat(const std::wstring& accessToken, const std::wstring& chatId, const std::wstring& message) {
    HINTERNET hSession = WinHttpOpen(L"TeamsPoster/1.0", WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
                                     WINHTTP_NO_PROXY_NAME, WINHTTP_NO_PROXY_BYPASS, 0);

    HINTERNET hConnect = WinHttpConnect(hSession, L"graph.microsoft.com", INTERNET_DEFAULT_HTTPS_PORT, 0);

    std::wstring endpoint = L"/v1.0/chats/" + chatId + L"/messages";
    HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", endpoint.c_str(), NULL,
                                            WINHTTP_NO_REFERER, WINHTTP_DEFAULT_ACCEPT_TYPES, WINHTTP_FLAG_SECURE);

    std::wstring jsonBody = L"{\"body\": {\"content\": \"" + message + L"\"}}";
    std::wstring headers = L"Authorization: Bearer " + accessToken + L"\r\nContent-Type: application/json\r\n";

    BOOL bResult = WinHttpSendRequest(hRequest,
                                      headers.c_str(), (DWORD)-1L,
                                      (LPVOID)jsonBody.c_str(), (DWORD)(jsonBody.length() * sizeof(wchar_t)),
                                      (DWORD)(jsonBody.length() * sizeof(wchar_t)), 0);

    if (bResult)
        WinHttpReceiveResponse(hRequest, NULL);

    DWORD dwSize = 0;
    WinHttpQueryDataAvailable(hRequest, &dwSize);

    if (dwSize > 0) {
        std::wstring response(dwSize / sizeof(wchar_t), 0);
        DWORD dwDownloaded = 0;
        WinHttpReadData(hRequest, &response[0], dwSize, &dwDownloaded);
        std::wcout << L"Response: " << response << std::endl;
    }

    WinHttpCloseHandle(hRequest);
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);
}

int main() {
    std::wstring access;
    std::wstring chatId = L"19:";
    std::wstring message = L"Hello from C++!";
    std::wcout << L"Enter your access token: ";
    std::getline(std::wcin, access);
    std::wcout << L"Enter chat ID: ";
    std::getline(std::wcin, chatId);
    PostToTeamsChat(access, chatId, message);
    return 0;
}

🔍 Cómo obtener el ID del chat

El ID del chat se puede verificar con GET /v1.0/me/chats.

1
2
3
4
curl -X GET ^
  https://graph.microsoft.com/v1.0/me/chats ^
  -H "Authorization: Bearer {access_token}" ^
  -H "Content-Type: application/json"

Ejemplo de respuesta

1
2
3
4
5
6
7
8
9
{
  "value": [
    {
      "id": "19:abc123xyz@thread.v2",
      "topic": null,
      "chatType": "oneOnOne"
    }
  ]
}

📌 Puntos a tener en cuenta

Este ejemplo es una implementación mínima. En un entorno de producción:
- Manejo de expiración de tokens
- Verificación del certificado HTTPS
- Mejora en el manejo de errores
Para publicaciones en canales se usa teams/{team-id}/channels/{channel-id}/messages.
Para enviar archivos adjuntos, se requiere procesamiento multiparte o la API de Graph Drive.

Resumen

📎 Resumen

Característica	Descripción
Graph API	API oficial para interactuar con Teams
Registro de aplicación	Procedimientos de autenticación necesarios en Azure
Token de acceso	Obtenido a través de OAuth2 y usado para peticiones
Implementación en C++	Llama a la Graph API utilizando WinHTTP

🚀 Próximos pasos

Para ejemplos más avanzados, también es posible lo siguiente:

Publicación en canales de equipos (/teams/{team-id}/channels/...)
Publicación con archivos adjuntos
Cambio entre cuentas de bot o cuentas de usuario
Implementación completa en C++ incluyendo la obtención del token

¡Si tienes alguna pregunta o sugerencia, no dudes en comentar!