Ведение Блога 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);

 // Заголовок 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 = "Попытка отправки в Slack из C++!";

 if (PostSlackMessage(token, channel, message)) {
 std::cout << "Успешная отправка!\n";
 } else {
 std::cerr << "Ошибка при отправке.\n";
 }

 return 0;
}

📌 Как получить ID канала

Использование только имени канала (например, #general) иногда может привести к ошибке. Более надежный способ — использовать ID из URL страницы канала в Slack.

1
2


https://app.slack.com/client/Txxxxx/C0123456789
 ↑ Эта часть — ID канала

✅ О типах токенов (Дополнительно)

Формат токена	Назначение	Пример
`xoxb-...`	Bot Token (Рекомендуется)	Публикация, редактирование, удаление
`xoxp-...`	User Token (Не рекомендуется)	Операции не связанные с ботом
Refresh Token	Для обновления долгосрочного токена	Обычно не используется

📝 Заключение

Для публикации в Slack из C++ метод Slack Web API + Bearer Token является наиболее надежным
Используйте конечную точку chat.postMessage с HTTPS POST
Токен необходимо передавать в заголовке Bearer
Канал надежнее всего указывать по ID

О знаке обязательного заполнения в формах ввода

Mon, 14 Jul 2025 13:47:51 +0900

Мы обобщили информацию об отметках “обязательно” в зарубежных пользовательских интерфейсах (формах) вместе с материалами руководств по UI.

📌 Основные знаки обязательного заполнения и лучшие практики

Использование звездочки (*)
- Это наиболее распространенный и широко используемый способ, когда обязательные поля помечаются символом “*”.
- Однако в начале формы обязательно должно быть пояснение, например, “ — обязательное поле”* (Nielsen Norman Group, California State University, Northridge).
- Также есть примеры использования цвета для выделения (например, красный текст).
Явное указание “Required” или “(required)” в метке
- Добавление слова “Required” в текстовую метку (label) делает его понятным для программ чтения с экрана, что улучшает доступность (Deque).
Совместное использование атрибутов ARIA и атрибута required в HTML5
- В дополнение к визуальному отображению использование aria-required="true" и <input required> позволяет программно передать обязательность поля (Deque).
Использование “(optional)” для явного указания необязательных полей
- Вместо обязательных полей можно использовать “(optional)” для указания необязательных, что эффективно при их смешивании.
- Однако Nielsen‑Norman отмечает, что “легче принимать решения, когда обязательные поля также четко обозначены” (TPGi).

✅ Краткое изложение руководств по UI

Источник	Содержание
NN/g: Marking Required Fields in Forms	Рекомендуется комбинация звездочки и пояснительного текста; отображение только необязательных полей считается недружелюбным (Nielsen Norman Group).
Deque (Anatomy of Accessible Forms)	・Использование строки “Required” или изображения внутри метки. ・Четко указано, что одной лишь цветовой индикации недостаточно.
W3C Techniques (H90)	Примеры включения звездочки или “(required)” в метку с определением значения в начале формы.
TPGi (Doing what’s required)	С учетом доступности комбинация звездочки, атрибута ARIA и текстовой вставки в метку оценивается как оптимальная.
Contensis Руководство по UX форм	Кратко отмечено, что важна последовательная разметка (например, * или (optional)) .

✅ Рекомендуемый подход к реализации

Добавьте пояснительный текст в начале формы :

Fields marked with * are required. (Или все вместе: “All fields are required”, а если есть необязательные: “unless marked optional”)
Добавление меток (Label) :
- Напишите, например, First Name * или Email (required).

Атрибуты ARIA и HTML5 :

1
2


<label for="email">Email <abbr title="required">*</abbr></label>
<input id="email" required aria-required="true">

Не полагайтесь только на цвет : обеспечьте поддержку как визуально, так и программно.

🔗 Полезные ссылки (материалы руководств по UI)

NN/g: Marking Required Fields in Forms (California State University, Northridge, Nielsen Norman Group, Deque)
Deque: Anatomy of Accessible Forms (Deque)
W3C Techniques: H90 Indicating required form controls (W3C)
TPGi: Indicating mandatory fields accessibly (TPGi)
Contensis: UX Forms Guidelines (Contensis)

При необходимости мы также можем предоставить конкретные примеры кода HTML/CSS, шаблоны дизайна компонентов UI для Sketch или Figma и т. д. Пожалуйста, обращайтесь к нам!