Личный инбокс в Telegram: мысль из мессенджера — в ваш экзокортекс

Мысль приходит не за ноутбуком. Личный инбокс убирает разрыв: вы пишете своему боту в личку — и сообщение становится узлом вашего экзокортекса. Голосовое, фотография и документ работают так же.

Инбокс принадлежит одному человеку — владельцу бота. Чужие сообщения в него не попадают никогда, приватность бота выключать не нужно: работает только личка.

Что нужно сделать один раз

Подключить бота. Заведите бота у BotFather в Telegram и возьмите его токен. На платформе откройте настройки эксперта, раздел «Мои Telegram-боты», у строки личного инбокса нажмите «подключить», вставьте токен и нажмите «сохранить». Если получилось — рядом появятся имя бота, последние знаки токена и отметка, что вебхук настроен.

Один бот не может одновременно вести сопровождение когорт и ваш личный инбокс: Telegram отдаёт сообщения бота по одному адресу. Для инбокса нужен отдельный.

Привязать свой аккаунт. В настройках профиля, раздел «Telegram», нажмите «привязать Telegram» и перейдите по появившейся одноразовой ссылке «открыть @бот и подтвердить». Если вместо ссылки показан код вида /start … — отправьте эту команду боту сообщением.

Без привязки бот не знает, что пишете именно вы, и не отвечает вовсе. Это самая частая причина молчания.

Как пользоваться

Просто напишите. Ответ придёт двумя сообщениями: сразу — подтверждение приёма со строкой о том, куда материал ушёл, а через несколько секунд — разбор: заголовок, под которым материал лёг в граф, и теги. Приём не ждёт разбора намеренно. Не пришло второе сообщение — материал всё равно принят.

Поставьте метку адреса в начале или в конце сообщения — например, #fow созвон в четверг. Материал уедет в область или проект с этой меткой, а сама метка в текст заметки не попадёт. Метка читается только по краям: решётка в середине — обычное слово, а не адрес. Незнакомая метка не отвергает материал: адрес заведётся, а карточка предупредит, что он со справочником не сверен.

Включите режим, если материал идёт потоком. Отправьте одну метку отдельным сообщением — и всё дальнейшее пойдёт по этому адресу без повторных меток. Метка в конкретном сообщении перебивает режим: она сказана про это сообщение, а режим — про поток.

Команды инбокса:

• /to — показать действующий режим и сколько ему осталось;
• /to <адрес> — включить;
• /to - — снять;
• /help — короткая справка прямо в чате.

Команда /to без адреса ничего не меняет: это вопрос, а не выключатель.

Вложения принимаются целиком и отвечают своим заголовком: «Голосовое», «Картинка», «Видео», «Кружок», «Аудио», «Файл» с именем. Подпись под фотографией работает как обычный текст — в ней можно поставить метку адреса.

Пересланное подписывается источником: видно, из какого канала или от кого пришла цитата. Хештеги внутри чужого поста адресом не считаются — они принадлежат автору поста. Пересланное адресуется режимом.

Накопленное смотрите на экране «Экзокортекс · обработать идею», блок «Недавние материалы».

Навык ведёт разговор прямо здесь. Отправьте /<слаг навыка> — начнётся разговор по протоколу: бот задаёт шаг, вы отвечаете, он ведёт дальше. Прервать — /stop. Пока разговор идёт, ваши реплики становятся его шагами, а не материалом: иначе каждый ответ навыку оседал бы заметкой. Отложить мысль посреди разговора можно словом-маркером захвата. Разговор гаснет сам через сутки молчания.

Агент может спросить вас сам. Когда он дошёл до развилки и не вправе решать за вас, вопрос придёт обычным сообщением. Пока вопрос открыт, ваша следующая реплика уходит ответом ему, а не в инбокс — единственный случай, когда сообщение не захватывается, и бот об этом говорит. Материал при этом не потерян: отправьте его ещё раз, когда ответ принят. Вопрос живёт сутки; протухший ничего не ломает и возвращает обычный приём. Отвечать командой не нужно — просто напишите; команда вопрос не закрывает.

Бот приносит и сообщения от агента. Кроме вопроса это уведомление о том, что ваша сессия завершилась и выводы готовы. Уведомление выключается в настройках, вопрос — нет: он часть работы, которую вы сами поручили. Адресат всегда вы: другим людям агент не пишет.

Если что-то пошло не так

Бот молчит. Почти всегда не сделана привязка аккаунта. Проверьте раздел «Telegram» в настройках профиля.

«не принят: проверьте токен». Токен неверен или устарел — возьмите новый у BotFather.

«этот бот уже занят другим назначением». Заведите отдельного бота для инбокса.

«адрес не распознан» или «адрес не записан из-за сбоя». Материал принят в любом случае — вы его не потеряли, он просто лежит без адреса.

«файл больше 20 МБ — сохранена только запись». Двадцать мегабайт — потолок вложения. Запись о файле есть, самого файла нет.

«файл не скачался — запись сохранена, дотянем позже». Telegram не отдал файл с первой попытки; материал принят, файл можно прислать заново.

Сообщение не попало в инбокс, а бот ответил «принято, передал агенту». Был открытый вопрос агента, и реплика ушла ответом на него. Материал не потерян — отправьте его повторно.

Сообщение не попало в инбокс, а бот ответил шагом навыка. Идёт разговор по навыку: прервите его /stop либо поставьте слово-маркер захвата, чтобы отложить материал, не прерывая разговора.

Отправили метку, а ответа нет. Проверьте, что она послана отдельным сообщением и без вложения: подпись под фотографией адресует эту фотографию, а не переключает режим.

Границы

Команды не становятся заметками. Всё, что начинается с косой черты, считается управлением: команды самого инбокса (/to, /help), запуск навыка (/<слаг>) и прерывание разговора (/stop).

Голос и картинки пока не расшифровываются. Вложение принимается и хранится, но текста из него платформа не достаёт: карточка честно говорит, что разбор содержимого будет позже. Содержимое появляется, когда вы разбираете материал.

По прямой ссылке платформа читает саму статью. Пришлёте адрес публикации без своего текста — в заметку попадёт её содержимое, а не строка с адресом. Своя мысль рядом со ссылкой остаётся материалом: статьёй её не подменяют.

Ссылки, которыми делится телефон через сервис Google, не читаются. Карточка скажет об этом прямо и попросит прислать прямой адрес. Такие ссылки закрыты для платформы на сетевом уровне — это не чинится с нашей стороны. Заметка заведётся с пометкой «ждёт разбора»: содержимое вы положите сами.

Режим гаснет по молчанию, а не по часам. Шесть часов считаются от последнего материала, а не от включения: пока вы пишете в режиме, он живёт. Ушли на день — погаснет сам.

Повторная доставка не создаёт дубль. Если Telegram пришлёт одно сообщение дважды, второй заметки не появится.

Можно писать не в личку, а в свою группу с темами. Тема группы становится проектом, и материал из неё сразу получает его адрес — статья «Инбокс-группа в Telegram: тема — это проект».