diff --git a/docs/checkpoint-2026-10-26.md b/docs/checkpoint-2026-10-26.md index 3101db2..19ed35b 100644 --- a/docs/checkpoint-2026-10-26.md +++ b/docs/checkpoint-2026-10-26.md @@ -16,13 +16,13 @@ В `action-service` действие стало `SUCCEEDED`. Отдельный GET к Google Calendar API подтвердил событие со статусом `confirmed`. Диагностические встречи удалены. -Временный Cloudflare Quick Tunnel отвечал локально, но Telegram отверг его новый hostname с -`Failed to resolve host`. Для проверки входящие обновления получали официальным Telegram -`getUpdates` после `deleteWebhook` и передавали в локальный -`http://localhost:18086/webhooks/telegram` с тем же секретным заголовком. Сейчас webhook удалён: -бот не обрабатывает новые сообщения автоматически, пока не заработает туннель или локальный -polling mode. Это ограничение тестового транспорта; реальный Google API и остальная цепочка -проверены. +Первый Quick Tunnel отвечал локально, но Telegram отвергал его адрес с `Failed to resolve host`. +Позже контейнер оставался запущенным, хотя в логах повторял `Unauthorized: Tunnel not found`. +После пересоздания через `task telegram:real:up` новый адрес ответил на `/health/ready`, Telegram +принял `setWebhook` и подтвердил адрес через `getWebhookInfo`. На момент повторной проверки webhook +активен, очередь пуста, ошибок доставки нет. Реальный Google API и остальная цепочка ранее были +проверены ручной передачей обновлений. Quick Tunnel временный; при его сбое смотри +[инструкцию восстановления](runbook.md#telegram-не-отвечает). ## Pull requests @@ -39,11 +39,9 @@ polling mode. Это ограничение тестового транспор ## Что делать дальше -1. Сделать официальный локальный polling mode Telegram Adapter или стабильный туннель, - чтобы реальная проверка не требовала ручной передачи обновлений. -2. После выполнения Action отправлять в чат итог «встреча создана» либо понятную ошибку: +1. После выполнения Action отправлять в чат итог «встреча создана» либо понятную ошибку: сейчас `answerCallbackQuery` показывает только краткий ответ на нажатие кнопки. -3. Повторить end-to-end проверку из чистого локального запуска и занести её в test-lab. +2. Повторить end-to-end проверку из чистого локального запуска и занести её в test-lab. Не добавляй OAuth credentials, access/refresh tokens, Telegram bot token или полные HTTP-ответы Google в Git и логи. diff --git a/docs/runbook.md b/docs/runbook.md index f11a24f..8d72823 100644 --- a/docs/runbook.md +++ b/docs/runbook.md @@ -63,6 +63,17 @@ Connection Service пуста; локальное уже созданное по а запрашивает короткоживущий access token у Connection Service. 5. Не включай Google credentials в `.env.example`, Compose или GitHub Actions. +## Telegram не отвечает + +1. Проверь `task status` и логи `cloudflared` в своём Compose-проекте. Контейнер может быть запущен, + хотя туннель уже недействителен: признак — `Unauthorized: Tunnel not found`. +2. Выполни `task telegram:real:up`. Команда пересоздаёт временный туннель, проверяет его HTTP-адрес, + регистрирует webhook у Telegram и сверяет его через `getWebhookInfo`. +3. Если Telegram сообщает `Failed to resolve host`, подожди распространения нового DNS-имени и + повтори команду. Для разработки можно пользоваться fake Telegram через `task service:up + SERVICE=telegram-adapter`. +4. Не публикуй bot token, secret token и полный URL с токеном из вызовов Bot API в тикетах и логах. + ## Preview smoke не запускается 1. Выполни `task doctor`, затем проверь `helm version`, `kubectl version --client` и `k3d version`.