|
1 | | -# Что это, и зачем оно нужно |
2 | | -#### Это бот, который: |
3 | | -1. Отправляет вам все ваши входящие сообщения из vk.com. |
4 | | -1. Даёт вам возможность ответить любому пользователю. |
5 | | -1. Позволяет посмотреть список друзей, а так же посмотреть онлайн ли сейчас конкретный человек. |
| 1 | +[](https://stand-with-ukraine.pp.ua) |
6 | 2 |
|
7 | | -Нужно это если вы уже давно выбрали Telegram как свой основной мессенджер, но у вас еще остались пара друзей/знакомых которые пишут вам в VK, или же вы просто с Украины (как я), и у вас нет доступа к Вконтакте без всяких неудобных VPN, а вам нужно что-то написать, или просто ответить. |
| 3 | +# This project has been abandoned and will no longer be updated. |
8 | 4 |
|
9 | | -# Требования |
10 | | -1. Для работы бота, у вас должен быть установлен NodeJS **версии не ниже 10**, скачать который можно по ссылке: https://nodejs.org/en/ |
11 | | -2. На системе в которой запускается бот, должен быть доступ к VK. |
12 | | -Если запускаете с ПК, а VK заблокирован - используйте VPN |
| 5 | +## History |
| 6 | +- VK (vkontakte - ʳussian analogue of Facebook) was the most popular social network in Ukraine. |
| 7 | +- In 2017, the biggest ʳussian websites, including VK, were blocked in Ukraine. |
| 8 | +- Most Ukrainians immediately migrated to other social networks and messaging apps, but some decided to stay on VK. |
| 9 | +- This project was created to maintain contact with them. |
13 | 10 |
|
14 | | -# Установка |
15 | | -Для начала вам нужен сам бот в телеграме, а точнее **\<token\>** бота. Надеюсь вы уже знаете где и как его получить. Если нет - [вам сюда](https://core.telegram.org/bots) |
| 11 | +## About the Project |
16 | 12 |
|
17 | | -Если у вас есть **\<token\>** бота, тогда идите в ВК, и возьмите **access_token** с правами **"offline,messages,video,photos,docs"**. Не знаете как? |
| 13 | +This is a NodeJS application that uses the VK API and the Telegram Bots API to forward messages (including images, voice messages, stickers, and files) from VK to Telegram and vice versa. |
18 | 14 |
|
19 | | -Это очень просто, вам нужно сделать 3 простых шага: |
20 | | -1. Создать **Standalone-приложение**, сделать это можно перейдя [сюда](https://vk.com/editapp?act=create) |
21 | | -1. Скопировать **ID приложения** из настроек приложения |
22 | | -1. Перейти по ссылке ниже, заменив **"\*ID\*"** на ваш ID приложения и скопировать **access_token** из адресной строки после авторизации |
23 | | -``` |
24 | | -https://oauth.vk.com/authorize?client_id=*ID*&display=page&redirect_uri=https://oauth.vk.com/blank.html&response_type=token&v=5.65&scope=offline,messages,video,photos,docs |
25 | | -``` |
| 15 | +The idea behind the project is to host it outside of Ukraine to avoid the need for a VPN (as VK does not work in Ukraine without a VPN), ensuring that messages from those still using VK are not missed. |
26 | 16 |
|
27 | | -У вас есть 2 токена? хорошо, скачивайте бота: |
28 | | -``` |
29 | | -git clone https://github.com/seniv/vk-tg-bot.git |
30 | | -``` |
31 | | -Войдите в папку с ботом: |
32 | | -``` |
33 | | -cd vk-tg-bot |
34 | | -``` |
35 | | -Загрузите модули: |
36 | | -``` |
37 | | -npm install |
38 | | -``` |
39 | | -Почти готово! |
40 | | -Далее откройте файл **config.json**, и измените 3 строчки конфигурации: |
41 | | -``` |
42 | | -"vk_token": "ВАШ ВК ТОКЕН", |
43 | | -"tg_token": "ВАШ ТОКЕН БОТА", |
44 | | -"tg_user": 0, // *TelegramID пользователя*, Измените этот айди на свой |
45 | | -``` |
46 | | -Получить **TelegramID пользователя** можно введя боту команду **"/myid"**, запустив бота перед этим. |
| 17 | +## How to Run It |
47 | 18 |
|
48 | | -И всё, ваш бот готов к использованию. Запускаем: |
49 | | -``` |
50 | | -npm start |
51 | | -``` |
52 | | - |
53 | | -***Прошу заметить, бот не будет реагировать если ему напишет кто-то, у кого ID не такой как указан в конфигурации! (будет работать только команда /myid)*** |
54 | | - |
55 | | -# Запуск при помощи Docker |
56 | | - |
57 | | -docker-cli: |
58 | | - |
59 | | -``` |
60 | | -docker run -e VK_TOKEN='ВАШ ВК ТОКЕН' -e TG_TOKEN='ВАШ ТОКЕН БОТА' -e TG_USER=TelegramID пользователя 421p/vk-tg-bot |
61 | | -``` |
62 | | - |
63 | | -docker-compose: |
64 | | -```yml |
65 | | -version: '3' |
66 | | - |
67 | | -services: |
68 | | - bot: |
69 | | - image: 421p/vk-tg-bot |
70 | | - environment: |
71 | | - VK_TOKEN: 'ВАШ ВК ТОКЕН' |
72 | | - TG_TOKEN: 'ВАШ ТОКЕН БОТА' |
73 | | - TG_USER: 0 // id |
74 | | -``` |
75 | | -
|
76 | | -# Как управлять? |
77 | | -Для начала можете отправить боту команду **"/start"**, чтобы бот создал клавиатуру с основными командами, но это не обязательно. |
78 | | -
|
79 | | -#### Команды, которые понимает бот: |
80 | | -1. Вышеупомянутый **"/start"** |
81 | | -1. **"/friends"** - Посмотреть список друзей. Ответ вы получите в виде **"Имя Фамилия (\*команда для быстрой смены получателя\*) \*онлайн-статус друга\*"** |
82 | | -1. **"/online"** - Посмотреть онлайн-статус текущего получателя |
83 | | -1. **"/friendson"** - Список друзей которые сейчас онлайн |
84 | | -1. **"/history"** - Посмотреть историю сообщений с текущим выбраным пользователем |
85 | | -
|
86 | | -Для того чтобы написать что-то кому-то из ВК, сначала вам нужно выбрать получателя. |
87 | | -Выбрать получателя очень просто - напишите боту слэш(/), а после него - ID получателя (ID пользователя VK). |
88 | | -
|
89 | | -Должно получится что то в этом роде: (в примере использован мой айди) |
90 | | -``` |
91 | | -/98117105 |
92 | | -``` |
93 | | -После чего бот сообщит вам что получатель изменён, и напишет имя и фамилию нового получателя, а вы сможете отправлять сообщения этому человеку просто написав боту. |
94 | | - |
95 | | -# Возможности |
96 | | -Вы можете отправить боту фото, стикер или голосовое сообщение, он загрузит его в ВК и отправит получателю. Стикер из телеграма будет отправлен как картинка. |
97 | | - |
98 | | -Так же бот разбирает основные вложения (фотографии, видео, записи на стене, стикеры, голосовые сообщения, любые документы), остальные вложения бот не будет разбирать, и просто отправит вам тип вложения (gift, audio и т.д.). Стикеры из ВК будут отправлены как картинка |
99 | | - |
100 | | -# Кастомизация |
101 | | -В файле **config.json** вы можете изменить **клавиатуру**, которая будет создана после ввода команды **"/start"**, или после смены получателя. |
102 | | -В ней вы можете добавить несколько людей которым вы часто пишите, или же просто какую-то часто использованную фразу. После добавления команды для смены пользователя должно получится примерно так: |
103 | | -``` |
104 | | -"keyboard": [ |
105 | | - ["/98117105 - Ivan"], |
106 | | - ["/online", "/friends"], |
107 | | - ["/friendson", "/history"] |
108 | | -] |
109 | | -``` |
110 | | - |
111 | | -# От автора |
112 | | -Знаю что бот написан не идеально, но это работает! |
113 | | - |
114 | | -Нашли баги? [пишите сюда](https://github.com/seniv/vk-tg-bot/issues/new) |
115 | | - |
116 | | -# ВАЖНО️ ❗️ |
117 | | -Бота я больше не поддерживаю, т.к. больше не пользуюсь ВК вообще. |
118 | | - |
119 | | -Но если у вас есть навыки програмирования и желание сделать что-то хорошее - можете присылать [Pull-реквесты](https://github.com/seniv/vk-tg-bot/pulls), их я буду просматривать и принимать, если они будут полезными. |
120 | | - |
121 | | -Так-что вы все ещё можете [сообщать о проблемах](https://github.com/seniv/vk-tg-bot/issues/new), возможно кто-то из других разработчиков их исправит. Возможно даже я 😏 |
122 | | - |
123 | | -Если решите что-то исправить/добавить - вот вам нескольно полезных ссылок которые помогут быстро разобратся с кодом и библиотеками которые сдесь используются: |
124 | | -1. VK-IO: либа для VK API: https://github.com/negezor/vk-io |
125 | | -2. Telegraf: Фрэймворк для телеграм ботов: https://telegraf.js.org/#/ |
126 | | -3. Доки Telegram Bots API: https://core.telegram.org/bots/api |
127 | | -4. Доки VK API: https://vk.com/dev |
| 19 | +Since this project is abandoned and most likely no longer functional, there is no reason to provide instructions on how to run it. This repository now serves as a historical artifact. |
0 commit comments