WinHTTP on kenji.blog

如何使用 Slack App + OAuth2 發送訊息到 Slack

Wed, 16 Jul 2025 23:36:27 +0900

✅ 使用存取權杖的發文方法（Slack Web API）

Slack 的「OAuth Token（例如 xoxb-… 等）」是用來透過 Slack 的 Web API 發文的密鑰。在這種情況下，與 Webhook 不同，你需要向 Slack API 端點 進行帶有 Authorization: Bearer 標頭的 POST 請求。

🔑 必要前提

你必須在 Slack 應用程式的 OAuth 範圍內包含 chat:write ：

設定步驟

前往 https://api.slack.com/apps
建立應用程式或選擇現有應用程式
在「OAuth & Permissions」 > Scopes 中 → 新增 chat:write
點擊「Install to Workspace」或「Reinstall」以獲取 Access Token（例如：xoxb-xxxxxxxxxx）

💻 C++ 程式碼（使用 WinHTTP 向 Slack API 發送請求）

 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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72


#include <windows.h>
#include <winhttp.h>
#include <iostream>

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

bool PostSlackMessage(const std::wstring& accessToken, const std::string& channel, const std::string& text) {
 const wchar_t* host = L"slack.com";
 const wchar_t* path = L"/api/chat.postMessage";

 HINTERNET hSession = WinHttpOpen(L"SlackPoster/1.0",
 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
 WINHTTP_NO_PROXY_NAME,
 WINHTTP_NO_PROXY_BYPASS, 0);
 if (!hSession) return false;

 HINTERNET hConnect = WinHttpConnect(hSession, host, INTERNET_DEFAULT_HTTPS_PORT, 0);
 if (!hConnect) return false;

 HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", path,
 NULL, WINHTTP_NO_REFERER,
 WINHTTP_DEFAULT_ACCEPT_TYPES,
 WINHTTP_FLAG_SECURE);

 // Authorization 標頭與 Content-Type
 std::wstring headers = L"Content-Type: application/json\r\n";
 headers += L"Authorization: Bearer " + accessToken + L"\r\n";

 // JSON 內容
 std::string body = R"({"channel":")" + channel + R"(","text":")" + text + R"("})";

 BOOL result = WinHttpSendRequest(hRequest,
 headers.c_str(),
 (DWORD)-1,
 (LPVOID)body.c_str(),
 body.length(),
 body.length(),
 0);

 if (!result || !WinHttpReceiveResponse(hRequest, NULL)) {
 std::cerr << "發送錯誤\n";
 return false;
 }

 // 確認狀態碼
 DWORD statusCode = 0;
 DWORD size = sizeof(statusCode);
 WinHttpQueryHeaders(hRequest,
 WINHTTP_QUERY_STATUS_CODE | WINHTTP_QUERY_FLAG_NUMBER,
 WINHTTP_HEADER_NAME_BY_INDEX,
 &statusCode, &size, WINHTTP_NO_HEADER_INDEX);

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

 return (statusCode == 200);
}

int main() {
 std::wstring token = L"xoxb-你的存取權杖"; // 存取權杖
 std::string channel = "頻道ID或者#general"; // 範例: "#general" 或 "C0123456789"
 std::string message = "嘗試從 C++ 發送訊息到 Slack！";

 if (PostSlackMessage(token, channel, message)) {
 std::cout << "發文成功！\n";
 } else {
 std::cerr << "發文失敗。\n";
 }

 return 0;
}

📌 如何獲取頻道 ID

僅使用頻道名稱（例如：#general）可能會導致錯誤。最可靠的方法是使用 Slack 頻道頁面 URL 中的 ID。

1
2


https://app.slack.com/client/Txxxxx/C0123456789
 ↑這部分就是頻道 ID

✅ 關於權杖類型（補充）

權杖格式	用途	範例
`xoxb-...`	Bot Token（推薦）	發文、編輯、刪除
`xoxp-...`	User Token（不推薦）	非 Bot 相關操作
Refresh Token	用於長期權杖更新	通常不使用

📝 總結

要從 C++ 發文到 Slack，使用 Slack Web API + Bearer Token 方式最為可靠
使用 HTTPS POST 發送至 chat.postMessage 端點
必須透過 Bearer 標頭發送權杖
確保 指定頻道 ID 以確保準確性

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

Wed, 16 Jul 2025 19:42:56 +0900

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

想要從 C++ 發送訊息到 Slack。在 Node.js 或 Python 中這很常見，但使用「C++ × Win32 API × WinHTTP」來做的情況應該很少見吧。

這篇文章將以循序漸進的方式，淺顯易懂地解說 如何使用 Webhook URL 從 C++ 發送訊息到 Slack 。

✅ 整體流程

要發布到 Slack，需要遵循以下步驟。

取得 Slack 的 Webhook URL（API 金鑰）
使用 WinHTTP 發送 POST 請求
以 JSON 格式建立訊息主體
檢查結果即可完成！

🔑 Step1：取得 Slack Webhook URL 的方法

在 Slack 中，可以使用 Incoming Webhooks 的功能，輕鬆地從外部服務發送訊息。

取得步驟

進入 https://api.slack.com/apps
點擊 Create New App
選擇 From scratch 並選擇應用程式名稱與發布目標工作區
從左側選單選擇 「Incoming Webhooks」 並啟用
點擊 「Add New Webhook to Workspace」 ，然後選擇頻道
複製發行的 URL（例如: https://hooks.slack.com/services/xxx/yyy/zzz）

這個 URL 將如同 API 金鑰般發揮作用。

💻 Step2：使用 C++ 程式碼發送訊息至 Slack

使用技術

Win32 API
WinHTTP（標準函式庫）
JSON 格式訊息

範例程式碼（發佈至 Slack）

 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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82


#include <windows.h>
#include <winhttp.h>
#include <iostream>

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

bool PostToSlack(const std::wstring& webhookUrl, const std::string& messageJson) {
 // 解析 URL
 URL_COMPONENTS urlComp{};
 wchar_t hostName[256];
 wchar_t urlPath[1024];

 urlComp.dwStructSize = sizeof(urlComp);
 urlComp.lpszHostName = hostName;
 urlComp.dwHostNameLength = _countof(hostName);
 urlComp.lpszUrlPath = urlPath;
 urlComp.dwUrlPathLength = _countof(urlPath);

 if (!WinHttpCrackUrl(webhookUrl.c_str(), 0, 0, &urlComp)) {
 std::wcerr << L"URL 解析失敗\n";
 return false;
 }

 // HTTP 階段與連線
 HINTERNET hSession = WinHttpOpen(L"SlackPoster/1.0",
 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
 WINHTTP_NO_PROXY_NAME,
 WINHTTP_NO_PROXY_BYPASS, 0);
 HINTERNET hConnect = WinHttpConnect(hSession, hostName, urlComp.nPort, 0);
 HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", urlPath,
 NULL, WINHTTP_NO_REFERER,
 WINHTTP_DEFAULT_ACCEPT_TYPES,
 WINHTTP_FLAG_SECURE);

 std::wstring headers = L"Content-Type: application/json\r\n";
 BOOL result = WinHttpSendRequest(hRequest,
 headers.c_str(),
 -1,
 (LPVOID)messageJson.c_str(),
 messageJson.length(),
 messageJson.length(),
 0);

 if (!result) {
 std::cerr << "發送請求失敗\n";
 return false;
 }

 WinHttpReceiveResponse(hRequest, NULL);

 DWORD statusCode = 0;
 DWORD size = sizeof(statusCode);
 WinHttpQueryHeaders(hRequest,
 WINHTTP_QUERY_STATUS_CODE | WINHTTP_QUERY_FLAG_NUMBER,
 WINHTTP_HEADER_NAME_BY_INDEX,
 &statusCode, &size, WINHTTP_NO_HEADER_INDEX);

 // 釋放資源
 WinHttpCloseHandle(hRequest);
 WinHttpCloseHandle(hConnect);
 WinHttpCloseHandle(hSession);

 return (statusCode == 200);
}

int main() {
 std::wstring webhookUrl = L"https://hooks.slack.com/services/xxx/yyy/zzz"; // 請替換成自己的 Webhook

 std::string message = R"({
 "text": "Hello from C++ :rocket:",
 "username": "C++ Bot",
 "icon_emoji": ":robot_face:"
 })";

 if (PostToSlack(webhookUrl, message)) {
 std::cout << "發布成功！\n";
 } else {
 std::cerr << "發布失敗。\n";
 }

 return 0;
}

🧪 自訂 JSON 訊息

在 Slack 的 Webhook 中，可以包含以下參數：

1
2
3
4
5
6


{
 "text": "通知內容",
 "username": "Bot 名稱",
 "icon_emoji": ":rocket:",
 "channel": "#任意頻道名稱"
}

📌 補充事項

Content-Type 必須指定為 "application/json"
Webhook URL 直接以 wstring 傳遞即可（無需 URL 編碼）
因為是 HTTPS 通訊，請別忘了加上 WINHTTP_FLAG_SECURE

🎉 附錄：Slack 中的發布確認範例

在 Slack 中會這樣顯示：

1
2


[C++ Bot]
Hello from C++ :rocket:

✍️ 總結

項目	內容
發布方式	Webhook (Incoming Webhooks)
通訊函式庫	WinHTTP
資料格式	JSON
可用參數	text, username, icon_emoji, channel 等

還在想著怎麼用 C++ 整合 Slack 嗎？你也可以從今天開始加入通知 Bot！

🚀 下集預告？

如果您有興趣，下次我們可以：

檔案附件
帶按鈕的 UI
使用 Slack App + OAuth2 進行靈活的 API 操作

等，為您介紹更進一步的 Slack 整合！

如何從 C++ 向 Microsoft Teams 發佈訊息（WinHTTP + Graph API）

Mon, 14 Jul 2025 23:40:15 +0900

如何從 C++ 向 Microsoft Teams 發佈訊息（WinHTTP + Graph API）

想自動發佈訊息到 Microsoft Teams 聊天室中嗎？
這時候可以使用的就是 Microsoft Graph API 。
在本文中，我們將透過步驟介紹 使用 WinHTTP 的 C++ 程式碼範例 以及 必要的 API 認證步驟 。

🔧 必要的準備（Microsoft Graph API 認證設定）

1. 在 Azure 入口網站註冊應用程式

首先，要使用 Microsoft Graph API，必須在 Azure 註冊應用程式。

前往 Azure Portal
「Microsoft Entra ID」 > 「＋新增」 > 「應用程式註冊」 > 「新增註冊」
輸入任意應用程式名稱後點擊「註冊」

2. 新增 API 權限

前往左側選單的「API 權限」
在 「Microsoft Graph」 > 「新增權限」 中搜尋以下範圍，然後點擊 「更新權限」

Chat.ReadWrite
User.Read

※ 若想要發佈到頻道，則還需要 ChannelMessage.Send

3. 記下用戶端識別碼與租用戶識別碼

記下顯示在「概觀」索引標籤中的以下兩項：

應用程式 (用戶端) 識別碼
目錄 (租用戶) 識別碼

4. 建立用戶端密碼

前往「憑證與密碼」索引標籤
點擊「新增用戶端密碼」 > 設定到期日後，點擊「新增」
顯示的值（密碼）請 務必當下立刻記下

🔐 取得存取權杖（OAuth2）

取得時我們使用 client_credentials 流程。
使用 curl 執行以下命令，以取得存取權杖。

1
2
3
4
5
6
7


curl -X POST ^
 https://login.microsoftonline.com/{租用戶識別碼}/oauth2/v2.0/token ^
 -H "Content-Type: application/x-www-form-urlencoded" ^
 -d "client_id={用戶端識別碼}" ^
 -d "scope=https%3A%2F%2Fgraph.microsoft.com%2F.default" ^
 -d "client_secret={用戶端密碼}" ^
 -d "grant_type=client_credentials"

回應範例

1
2
3
4
5
6


{
 "token_type":"Bearer",
 "expires_in":3599,
 "ext_expires_in":3599,
 "access_token": "eyJ0eXAiOiJKV1QiLCJub...（省略）"
}

使用此 access_token 來呼叫 Microsoft Graph API。

💬 投稿到 Teams 聊天室的 C++ 範例

這裡示範使用 WinHTTP 向聊天室發佈訊息的 C++ 範例。

 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;
}

🔍 取得聊天室識別碼的方法

聊天室識別碼可以透過 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"

回應範例

1
2
3
4
5
6
7
8
9


{
 "value": [
 {
 "id": "19:abc123xyz@thread.v2",
 "topic": null,
 "chatType": "oneOnOne"
 }
 ]
}

📌 注意事項

此範例為最基本實作。在實際運用中：
- 權杖過期處理
- HTTPS 憑證驗證
- 錯誤處理的強化
頻道發佈請使用 teams/{team-id}/channels/{channel-id}/messages 。
傳送附件檔案需要多部分處理 (multipart) 或 Graph Drive API。

總結

📎 總結

功能	概要
Graph API	與 Teams 互動的官方 API
應用程式註冊	Azure 上必要的認證手續
存取權杖	透過 OAuth2 取得，並用於請求中
C++ 實作	使用 WinHTTP 呼叫 Graph API

🚀 下一步

作為更進階的範例，以下也是可行的：

團隊頻道發佈 (/teams/{team-id}/channels/...)
帶有附件檔案的發佈
機器人帳號或使用者帳號的切換
包含取得權杖在內的完整 C++ 實作

如有任何需求，歡迎隨時留言！