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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Границы

Команды не становятся заметками. Всё, что начинается с косой черты, считается управлением. Исключения — команды самого инбокса.

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

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

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

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