Slack 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 بخطوة أبعد مثل هذه!