WinHTTP on kenji.blog

كيفية نشر رسالة على Slack باستخدام Slack App + OAuth2

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

✅ طريقة النشر باستخدام رمز الوصول (Slack Web API)

يعد “OAuth Token (مثل xoxb- وما إلى ذلك)” من Slack هو المفتاح للنشر باستخدام Web API الخاص بـ Slack. في هذه الحالة، وعلى عكس Webhook، ستقوم بإجراء POST إلى نقطة نهاية API في Slack مع رأس Authorization: Bearer.

🔑 المتطلبات الأساسية

يجب عليك تضمين chat:write في نطاق OAuth في تطبيق Slack الخاص بك:

خطوات الإعداد

قم بزيارة https://api.slack.com/apps
قم بإنشاء تطبيق أو حدد تطبيقًا موجودًا
في “OAuth & Permissions” > Scopes ← أضف chat:write
قم بإجراء “Install to Workspace” أو “Reinstall” للحصول على Access Token (مثال: xoxb-xxxxxxxxxx)

💻 كود C++ (النشر في Slack API باستخدام WinHTTP)

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

 // ترويسة التفويض ونوع المحتوى
 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 = "معرف-القناة-أو-#general"; // مثال: "#general" أو "C0123456789"
 std::string message = "محاولة النشر في Slack من C++!";

 if (PostSlackMessage(token, channel, message)) {
 std::cout << "تم النشر بنجاح!\n";
 } else {
 std::cerr << "فشل في النشر.\n";
 }

 return 0;
}

📌 كيفية الحصول على معرف القناة

قد يؤدي استخدام اسم القناة فقط (مثال: #general) أحيانًا إلى حدوث خطأ. الطريقة الأكثر موثوقية هي استخدام المعرف من عنوان URL لصفحة قناة Slack.

1
2


https://app.slack.com/client/Txxxxx/C0123456789
 ↑ هذا الجزء هو معرف القناة

✅ حول أنواع الرموز (إضافي)

تنسيق الرمز	الغرض	مثال
`xoxb-...`	Bot Token (موصى به)	نشر، تعديل، حذف
`xoxp-...`	User Token (غير موصى به)	عمليات غير خاصة بالبوت
Refresh Token	لتحديث الرمز طويل الأمد	لا يُستخدم عادةً

📝 الخلاصة

للنشر في Slack من C++، تعتبر طريقة Slack Web API + Bearer Token هي الأكثر موثوقية
استخدم نقطة النهاية chat.postMessage مع HTTPS POST
يجب إرسال الرمز في ترويسة Bearer
من الأفضل تحديد القناة باستخدام المعرف

كيفية نشر رسائل إلى Slack باستخدام C++ (Win32 API + WinHTTP) [دعم Webhook]

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

كيفية نشر رسائل إلى Slack باستخدام C++ (Win32 API + WinHTTP) [دعم Webhook]

أرغب في نشر رسائل إلى Slack من C++. هذا شائع جدًا في Node.js و Python، لكن هناك حالات قليلة لاستخدام “C++ × Win32 API × WinHTTP”.

في هذا المقال، سأشرح خطوة بخطوة كيفية إرسال رسائل من C++ إلى Slack باستخدام رابط Webhook بطريقة سهلة الفهم.

✅ التدفق العام

للنشر في Slack، اتبع الخطوات التالية:

احصل على رابط Slack Webhook (مفتاح API)
أرسل طلب POST باستخدام WinHTTP
قم بتكوين نص الرسالة بصيغة JSON
تحقق من النتيجة واكتمل!

🔑 الخطوة 1: كيفية الحصول على رابط Slack Webhook

في Slack، يمكنك بسهولة نشر رسائل من خدمات خارجية باستخدام ميزة تسمى Incoming Webhooks.

خطوات الحصول

انتقل إلى https://api.slack.com/apps
انقر على Create New App
اختر From scratch، وحدد اسم التطبيق ومساحة العمل الوجهة
من القائمة اليسرى، حدد “Incoming Webhooks” وقم بتفعيله
انقر على “Add New Webhook to Workspace” وحدد قناة
انسخ الرابط الصادر (مثال: https://hooks.slack.com/services/xxx/yyy/zzz)

يعمل هذا الرابط مثل مفتاح API.

💻 الخطوة 2: إرسال رسالة إلى Slack بكود C++

التقنيات المستخدمة

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 Webhooks، يمكنك تضمين معلمات مثل هذه:

1
2
3
4
5
6


{
 "text": "محتوى الإشعار",
 "username": "اسم البوت",
 "icon_emoji": ":rocket:",
 "channel": "#اسم_قناة_اختياري"
}

📌 ملاحظات إضافية

يجب تحديد Content-Type كـ "application/json"
يتم تمرير رابط Webhook كـ 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، إلخ.

حتى إذا كنت تعتقد أن التكامل مع Slack باستخدام C++ صعب… يمكنك إضافة بوت إشعارات بدءًا من اليوم!

🚀 ما التالي؟

إذا كنت مهتمًا، ففي المرة القادمة:

إرفاق الملفات
واجهة مستخدم بأزرار
عمليات API مرنة عبر Slack App + OAuth2

يمكننا أيضًا تقديم تكامل متقدم مع Slack بخطوة أبعد مثل هذه!

كيفية نشر رسائل إلى Microsoft Teams من C++ (WinHTTP + Graph API)

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

كيفية نشر رسائل إلى Microsoft Teams من C++ (WinHTTP + Graph API)

هل ترغب في النشر التلقائي في دردشة Microsoft Teams؟ يمكنك استخدام ** Microsoft Graph API ** لذلك. في هذه المقالة، سنقدم ** أمثلة كود C++ باستخدام WinHTTP ** و ** خطوات مصادقة 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.

💬 نموذج C++ للنشر في دردشة Teams

فيما يلي مثال بلغة C++ للنشر في دردشة باستخدام WinHTTP.

 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.
لإرسال المرفقات، ستحتاج إلى معالجة متعددة الأجزاء أو Graph Drive API.

📎 الخلاصة

الميزة	الوصف
Graph API	واجهة برمجة التطبيقات الرسمية للتفاعل مع Teams
تسجيل التطبيق	إجراءات المصادقة المطلوبة على Azure
رمز الوصول	تم الحصول عليه عبر OAuth2 واستخدامه في الطلبات
تنفيذ C++	استدعاء Graph API باستخدام WinHTTP

🚀 الخطوات التالية

كأمثلة أكثر تقدمًا، يمكنك أيضًا:

النشر في قنوات الفريق (/teams/{team-id}/channels/...)
النشر مع المرفقات
التبديل بين حسابات الروبوت وحسابات المستخدمين
تنفيذ C++ كامل يشمل الحصول على الرمز

إذا كان لديك أي طلبات، فلا تتردد في ترك تعليق!