Telegram Sync Amvera R

Telegram Sync Amvera R

An Obsidian plugin that syncs messages from your personal Telegram bot into your vault.

Messages first go to your sync server on Amvera, where they are stored until you sync them into Obsidian. After a successful sync they are removed from the server and not kept in any form. The plugin pulls them into notes when you run Fetch new messages. Optionally, voice and audio can be transcribed via ProxyAPI.

Desktop only (Obsidian 1.13.0+).

Links

• Default Telegram bot: @obsidian_sync_amvera_r_bot
• Sync server source code: github.com/vicstu/server_obsidian_telegram_sync_amvera_r

---

What you need beforehand

1. Install the plugin in Obsidian.
2. Either use the default shared bot and server, or create your own Telegram bot and deploy the sync server on Amvera.
3. Configure the plugin and verify the connection.

Step-by-step below.

Quick start (default server and bot)

If you do not want to deploy your own server yet:

1. Install and enable the plugin (section 1).
2. Open @obsidian_sync_amvera_r_bot in Telegram and press Start (/start). Copy your User ID from the bot’s reply.
3. In Settings → Telegram Sync Amvera R, leave Use default server and Telegram bot selected, paste User ID, and press Check under Telegram (send the bot a test message first).
4. Run Fetch new messages in Obsidian.

For your own bot and server, follow sections 2–4. Server code: server_obsidian_telegram_sync_amvera_r.

---

1. Install the plugin

Via Community plugins

1. Open Settings → Community plugins.
2. Turn off Safe mode if it is enabled.
3. Find Telegram Sync Amvera R, install it, and enable it.

Manual install

1. Download main.js, manifest.json, and styles.css from the plugin repository releases.
2. Create the folder:

<your-vault>/.obsidian/plugins/telegram-sync-amvera-r/

3. Copy all three files into that folder.
4. Under Community plugins, enable Telegram Sync Amvera R.

At this point the plugin is in Obsidian, but sync will not work without a bot and server.

---

2. Create a Telegram bot (custom server only)

Skip this section if you use the default bot.

1. In Telegram, open @BotFather.
2. Send /newbot.
3. Set the bot name (what people see), for example: My Obsidian Sync.
4. Set the bot username (must end with bot), for example: my_obsidian_sync_bot.
5. BotFather will send a token like:

1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Save the token — you will need it on the server (TELEGRAM_OBSIDIAN_BOT_TOKEN). Do not share it with anyone.

6. Find your Telegram user ID (a number, not a username):
   • open @userinfobot or @getmyid_bot;
   • send any message and copy your Id / user id.

This ID is used as MY_TELEGRAM_USER_ID: the bot accepts messages only from you.

7. Open your new bot in Telegram and press Start (/start) so the chat is active.

---

3. Deploy the sync server on Amvera (custom server only)

Skip this section if you use the default shared server in the plugin.

The plugin needs a backend: it receives messages from the bot, queues them, and serves them to Obsidian via API.

Server source: server_obsidian_telegram_sync_amvera_r on GitHub

3.1. Registration and project

1. Sign up at Amvera.
2. Create a new project (application).
3. Connect the server repository or upload the project files to Amvera (whichever your plan/UI supports).

The project root should include, among other things:

• amvera.yml — build and run config;
• main.py, requirements.txt;
• API and Telegram bot code for Obsidian sync.

3.2. Environment variables

In the Amvera project settings, set:

Without these variables, sync on the server is not considered configured.

Optionally you can also set TELEGRAM_MEDIA_FOLDER (default /data/telegram_media) and LOG_LEVEL.

Make sure the app has persistent storage (in amvera.yml usually persistenceMount: /data) — that is where the message database is written.

3.3. Launch

1. Deploy / start the application on Amvera.
2. Wait for a successful deploy status.
3. Copy the app public URL, for example:

https://your-project-xxx.amvera.tech

No trailing slash — you will paste it into the plugin settings later.

3.4. Verify that the server works

1. In a browser, open your app’s health endpoint (often /health), for example:

https://your-project-xxx.amvera.tech/health

You should get a successful response (not a hosting 502/404).

2. Send the bot a text or voice message in Telegram — it should be queued on the server.
3. Amvera logs should not show errors like “token not set” or a bot crash on startup.

When the server responds and the bot accepts your messages, you can configure the plugin.

---

4. Configure the plugin

Open Settings → Telegram Sync Amvera R.

Settings language follows Obsidian’s interface language: Russian UI → Russian settings, otherwise English.

Default vs custom server

Sync server (custom mode)

If Check says sync is not ready: verify TELEGRAM_OBSIDIAN_BOT_TOKEN and MY_TELEGRAM_USER_ID on Amvera, then restart the app.

Telegram

Obsidian links

Files and folders are created on the first sync if they do not exist yet (the template gets default content).

ProxyAPI (optional)

Only needed if you want to transcribe voice/audio during sync.

1. Sign up at ProxyAPI.
2. Create an API key. You must enable the Balance request permission — without it the plugin cannot check the balance or work with the key properly.
3. Enable Transcribe audio.
4. Paste the API key.
5. Optionally enable Post-process transcription, choose a model, and set a prompt.

Pricing: proxyapi.ru/pricing/list.
Limit: audio file size for transcription must be no more than 25 MB.

---

5. How to use

1. Send messages to the bot in Telegram (text, photos, voice, files).
2. In Obsidian, open the Command Palette (Ctrl / Cmd + P) and run Fetch new messages.
3. New entries appear in the target file; media go to the attachments folder.

Useful commands:

For manual transcription, place the cursor on ![[file.ogg]] (or select the link), set a ProxyAPI key, and run the command. If post-process is enabled, it applies here too. You can bind this command to a Buttons plugin button.

---

Message template

Variables in the template file:

Example:

**{{sender}}** · {{date}} {{time}}
{{tags}}
{{text}}
![[{{attachment}}]]
{{transcription}}

To embed a file: ![[{{attachment}}]]; to link: [[{{attachment}}]].

---

Quick checklist

• Plugin installed and enabled
• Bot created in BotFather, token saved
• Your Telegram user ID is known
• Chat with the bot started (/start)
• Amvera project created, server files uploaded
• TELEGRAM_OBSIDIAN_BOT_TOKEN and MY_TELEGRAM_USER_ID set
• App running, URL copied
• Health / logs OK, bot accepts messages
• Server URL set in the plugin, Connection check succeeded
• Fetch new messages command run

---

Build and GitHub release

Requirements: Node.js 18+ and npm.

cd obsidian-telegram-plugin
npm install
npm run build

npm run build type-checks TypeScript and writes a minified main.js in the plugin root.

Before a release, bump version in both manifest.json and package.json (keep them equal).

Files for a GitHub Release

Attach these three files as release assets (same set users download for manual install):

Do not put node_modules, source maps, or the whole repo zip as the only install path — users need the three files above in .obsidian/plugins/telegram-sync-amvera-r/.

versions.json is only needed if you publish to the Obsidian Community plugins catalog; it is optional for a plain GitHub Release.

---

License

MIT

---

---

Telegram Sync Amvera R

Плагин Obsidian для синхронизации сообщений из личного Telegram-бота в vault.

Сообщения сначала попадают на ваш sync-сервер на Amvera, где хранятся, пока вы не синхронизируете их в Obsidian. После успешной синхронизации они удаляются с сервера и нигде больше не хранятся. Плагин забирает их в заметки по команде Fetch new messages. Опционально голосовые и аудио можно транскрибировать через ProxyAPI.

Только desktop (Obsidian 1.13.0+).

Ссылки

• Бот по умолчанию: @obsidian_sync_amvera_r_bot
• Код sync-сервера: github.com/vicstu/server_obsidian_telegram_sync_amvera_r

---

Что нужно заранее

1. Установить плагин в Obsidian.
2. Либо использовать общий бот и сервер по умолчанию, либо создать свой Telegram-бот и развернуть sync-сервер на Amvera.
3. Настроить плагин и проверить связь.

Ниже — по шагам.

Быстрый старт (сервер и бот по умолчанию)

Если пока не хотите поднимать свой сервер:

1. Установите и включите плагин (раздел 1).
2. Откройте @obsidian_sync_amvera_r_bot в Telegram и нажмите Start (/start). Скопируйте User ID из ответа бота.
3. В Настройки → Telegram Sync Amvera R оставьте режим По умолчанию, вставьте User ID и нажмите Проверить в блоке Telegram (сначала отправьте боту тестовое сообщение).
4. В Obsidian выполните Fetch new messages.

Для своего бота и сервера — разделы 2–4. Код сервера: server_obsidian_telegram_sync_amvera_r.

---

1. Установите плагин

Через пользовательские (Community) плагины

1. Откройте Настройки → Сторонние плагины (Community plugins).
2. Отключите безопасный режим, если он включён.
3. Найдите Telegram Sync Amvera R, установите и включите.

Ручная установка

1. Скачайте main.js, manifest.json и styles.css из релизов репозитория плагина.
2. Создайте папку:

<ваш-vault>/.obsidian/plugins/telegram-sync-amvera-r/

3. Скопируйте туда все три файла.
4. В Сторонние плагины включите Telegram Sync Amvera R.

На этом этапе плагин уже есть в Obsidian, но без бота и сервера синхронизация работать не будет.

---

2. Создайте Telegram-бота (только для своего сервера)

Пропустите этот раздел, если используете бота по умолчанию.

1. В Telegram откройте @BotFather.
2. Отправьте /newbot.
3. Укажите имя бота (как его будут видеть люди), например: My Obsidian Sync.
4. Укажите username бота (должен заканчиваться на bot), например: my_obsidian_sync_bot.
5. BotFather пришлёт токен вида:

1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Сохраните токен — он понадобится на сервере (TELEGRAM_OBSIDIAN_BOT_TOKEN). Никому его не передавайте.

6. Узнайте свой Telegram user ID (число, не username):
   • откройте @userinfobot или @getmyid_bot;
   • отправьте любое сообщение и скопируйте ваш Id / user id.

Этот ID понадобится как MY_TELEGRAM_USER_ID: бот принимает сообщения только от вас.

7. Откройте своего нового бота в Telegram и нажмите Start (/start), чтобы чат был активен.

---

3. Разверните sync-сервер на Amvera (только для своего сервера)

Пропустите этот раздел, если в плагине используете общий сервер по умолчанию.

Плагину нужен backend: он принимает сообщения от бота, кладёт их в очередь и отдаёт Obsidian по API.

Исходники сервера: server_obsidian_telegram_sync_amvera_r на GitHub

3.1. Регистрация и проект

1. Зарегистрируйтесь на Amvera.
2. Создайте новый проект (приложение).
3. Подключите репозиторий с сервером или загрузите файлы проекта в Amvera (как удобнее в вашем тарифе/интерфейсе).

В корне проекта должны быть, в частности:

• amvera.yml — сборка и запуск;
• main.py, requirements.txt;
• код API и Telegram-бота для Obsidian sync.

3.2. Переменные окружения

В настройках проекта Amvera задайте:

Без этих переменных sync на сервере не считается настроенным.

При необходимости можно задать также TELEGRAM_MEDIA_FOLDER (по умолчанию /data/telegram_media) и LOG_LEVEL.

Убедитесь, что у приложения есть постоянное хранилище (в amvera.yml обычно persistenceMount: /data) — туда пишется база сообщений.

3.3. Запуск

1. Задеплойте / запустите приложение в Amvera.
2. Дождитесь успешного статуса деплоя.
3. Скопируйте публичный URL приложения, например:

https://ваш-проект-xxx.amvera.tech

Без слэша в конце — его потом вставите в настройки плагина.

3.4. Проверьте, что сервер работает

1. В браузере откройте health-эндпоинт вашего приложения (часто /health), например:

https://ваш-проект-xxx.amvera.tech/health

Должен быть успешный ответ (не ошибка 502/404 от хостинга).

2. Напишите боту в Telegram текст или голосовое — сообщение должно уйти на сервер в очередь.
3. В логах Amvera не должно быть ошибок вроде «токен не задан» или падения при старте бота.

Когда сервер отвечает и бот принимает ваши сообщения — можно настраивать плагин.

---

4. Настройка плагина

Откройте Настройки → Telegram Sync Amvera R.

Язык настроек совпадает с языком интерфейса Obsidian: русский → русские настройки, иначе английские.

По умолчанию или свой сервер

Сервер синхронизации (режим «Настроить»)

Если Check пишет, что sync не готов: проверьте TELEGRAM_OBSIDIAN_BOT_TOKEN и MY_TELEGRAM_USER_ID на Amvera и перезапустите приложение.

Telegram

Obsidian links

Файлы и папки создадутся при первой синхронизации, если их ещё нет (шаблон — с содержимым по умолчанию).

ProxyAPI (необязательно)

Нужно только если хотите транскрибировать голосовые/аудио при sync.

1. Зарегистрируйтесь на ProxyAPI.
2. Создайте API-ключ. Обязательно включите разрешение «Запрос баланса» (Balance request) — без него плагин не сможет проверить баланс и нормально работать с ключом.
3. Включите Transcribe audio.
4. Вставьте API key.
5. При необходимости включите Post-process transcription, выберите модель и задайте prompt.

Тарифы: proxyapi.ru/pricing/list.
Ограничение: размер аудиофайла для транскрибации не больше 25 МБ.

---

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

1. Пишите боту в Telegram (текст, фото, voice, файлы).
2. В Obsidian откройте Command Palette (Ctrl / Cmd + P) и выполните Fetch new messages.
3. Новые записи появятся в target-файле, медиа — в папке вложений.

Полезные команды:

Для ручной транскрибации поставьте курсор на ![[файл.ogg]] (или выделите ссылку), задайте ProxyAPI key и выполните команду. Если включён post-process — он применится и здесь. Команду можно повесить на кнопку плагина Buttons.

---

Шаблон сообщения

Переменные в template-файле:

Пример:

**{{sender}}** · {{date}} {{time}}
{{tags}}
{{text}}
![[{{attachment}}]]
{{transcription}}

Для вставки файла: ![[{{attachment}}]], для ссылки: [[{{attachment}}]].

---

Краткий чеклист

• Плагин установлен и включён
• Бот создан в BotFather, токен сохранён
• Известен ваш Telegram user ID
• С ботом начат диалог (/start)
• Проект на Amvera создан, файлы сервера загружены
• Заданы TELEGRAM_OBSIDIAN_BOT_TOKEN и MY_TELEGRAM_USER_ID
• Приложение запущено, URL скопирован
• Health / логи в порядке, бот принимает сообщения
• В плагине указан Server URL, Connection check успешен
• Выполнена команда Fetch new messages

---

Сборка и релиз на GitHub

Нужны Node.js 18+ и npm.

cd obsidian-telegram-plugin
npm install
npm run build

npm run build проверяет TypeScript и собирает минифицированный main.js в корне плагина.

Перед релизом поднимите version в manifest.json и package.json (значения должны совпадать).

Файлы для GitHub Release

В assets релиза приложите три файла (те же, что качают при ручной установке):

Не выкладывайте как единственный способ установки node_modules, source maps или весь zip репозитория — пользователю нужны три файла выше в .obsidian/plugins/telegram-sync-amvera-r/.

versions.json нужен только при публикации в каталог Community plugins Obsidian; для обычного GitHub Release он необязателен.

---

Лицензия

MIT