Если сообщение Slack появилось не в том канале, сначала остановите повтор именно этой задачи и сохраните её request ID. Не отправляйте ещё одно «проверочное» уведомление по имени канала: ошибка обычно находится в выборе workspace или conversation ID, а новый запуск лишь создаст второй пост.
Надёжная адресация выглядит как пара workspace_id + channel_id. Видимое имя удобно человеку, но канал могут переименовать, а одинаковые названия встречаются в разных рабочих пространствах. Slack прямо рекомендует использовать channel-like ID для точного назначения.
Три поля сразу показывают место подмены
| Что сравнить | Ожидаемое значение | Что означает расхождение |
|---|---|---|
| workspace/team ID токена | Рабочее пространство окружения | Выбран другой installation или секрет |
| channel в исходящем payload | Сохранённый conversation ID | Ошибка роутинга произошла до Slack API |
| channel в ответе API | Тот же conversation ID | Нужно изучить фактически отправленный запрос |
| имя из conversations.info | Понятная оператору подпись | Канал переименован или конфигурация устарела |
| thread_ts | Родитель внутри целевого канала | Перепутана ветка, но не адрес канала |
Для диагностики достаточно технических идентификаторов, времени и результата API. Текст сообщения, профили участников и OAuth token в журнал не записывают. Если интеграция обслуживает несколько workspace, одинаковый channel ID нельзя трактовать без связи с конкретной установкой.
Маршрут хранит ID, а имя остаётся подсказкой
const route = routes[`${environment}:${event.kind}`];
if (!route) throw new Error("Slack route is not configured");
const info = await slack.conversations.info({ channel: route.channelId });
if (!info.ok || info.channel.id !== route.channelId) {
throw new Error("Slack target cannot be verified");
}
const sent = await slack.chat.postMessage({
channel: route.channelId,
text: payload.text
});
if (sent.channel !== route.channelId) throw new Error("Slack target mismatch");route может содержать expected_name для экрана настроек, но не должен искать канал по этой строке при каждой отправке. Любое изменение маршрута оформляется отдельной ревизией конфигурации: кто изменил, какой ID был до и после, в каком окружении изменение включено.
conversations.info — проверка, а не способ угадать канал
Метод conversations.info возвращает объект указанной conversation. Перед первой отправкой после изменения конфигурации проверьте ID и понятные свойства: имя, archived, тип разговора и доступ приложения. Если канал архивирован или приложение его не видит, задачу лучше перевести в blocked, а не искать похожее имя.
- Для приватного канала аутентифицированный пользователь или приложение должно иметь нужный доступ и состоять в разговоре по правилам Slack.
- channel_not_found не исправляют подстановкой первого совпадения из списка каналов.
- Переименование обновляет подпись в панели, но не должно менять сохранённый ID маршрута.
- Отдельные production и test installations не используют общую таблицу маршрутов без workspace ID.
- Кеш маршрута сбрасывается по номеру ревизии, а не только по времени жизни.
thread_ts не выбирает другой канал
thread_ts у chat.postMessage делает сообщение ответом в ветке родительского сообщения. Сам канал всё равно задаётся параметром channel. Поэтому при неверном канале сначала исследуют channel и установку приложения; thread_ts проверяют, когда сообщение оказалось в правильном разговоре, но не в той ветке.
Храните связь parent_ts с conversation ID. Если взять timestamp из другого канала, запрос может завершиться ошибкой или повести себя не так, как ожидает прикладной код. Пара значений должна проверяться вместе до формирования payload.
Один канареечный пост безопаснее массовой проверки
После исправления выберите специально созданный тестовый канал в том же workspace и отправьте одно нейтральное сообщение с correlation ID. Сравните route, запрос и ответ. Только затем включайте рабочий маршрут и разблокируйте одну отложенную задачу; массовый retry старой очереди оставьте до подтверждения.
- Проверить, какой installation и workspace выбрала задача.
- Прочитать route revision и целевой conversation ID.
- Вызвать conversations.info без публикации сообщения.
- Отправить канареечный payload в специально разрешённый канал.
- Сверить channel и ts в ответе chat.postMessage.
- Разблокировать одну рабочую задачу и только потом остальную очередь.
Защита ставится перед необратимым вызовом
Последний guard выполняется непосредственно перед chat.postMessage: проверяет окружение, workspace ID, allowlist conversation ID и revision маршрута. Молчаливое исправление по имени запрещено. Так устаревшая задача не сможет уйти по конфигурации, которая уже была заменена.
Минимальный журнал помогает без лишних данных
Запишите correlation ID, installation reference, route revision, ожидаемый и фактический conversation ID, API method, HTTP/Slack error и message ts. Токен, полный payload и пользовательские сообщения маскируются. Этого набора достаточно, чтобы отличить ошибку выбора канала от проблем доступа или ветки.