{"id":15134101,"url":"https://github.com/truecooler/vkbotframework","last_synced_at":"2025-10-23T09:31:22.774Z","repository":{"id":33232096,"uuid":"152660143","full_name":"truecooler/VkBotFramework","owner":"truecooler","description":"Удобная, маленькая и кроссплатформенная библиотека для создания ботов в соц. сети ВКонтакте","archived":false,"fork":false,"pushed_at":"2023-10-19T18:22:11.000Z","size":64,"stargazers_count":20,"open_issues_count":6,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-30T17:38:27.741Z","etag":null,"topics":["vk","vk-api","vk-bot","vkapi","vkbot","vkontakte","vkontakte-api"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/truecooler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-11T21:50:43.000Z","updated_at":"2023-03-28T01:14:06.000Z","dependencies_parsed_at":"2024-12-02T01:41:00.099Z","dependency_job_id":null,"html_url":"https://github.com/truecooler/VkBotFramework","commit_stats":{"total_commits":38,"total_committers":3,"mean_commits":"12.666666666666666","dds":0.4736842105263158,"last_synced_commit":"deab2007471d568d216d86dcbbfc31b27b820236"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/truecooler%2FVkBotFramework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/truecooler%2FVkBotFramework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/truecooler%2FVkBotFramework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/truecooler%2FVkBotFramework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/truecooler","download_url":"https://codeload.github.com/truecooler/VkBotFramework/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237807468,"owners_count":19369597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["vk","vk-api","vk-bot","vkapi","vkbot","vkontakte","vkontakte-api"],"created_at":"2024-09-26T05:02:41.975Z","updated_at":"2025-10-23T09:31:22.402Z","avatar_url":"https://github.com/truecooler.png","language":"C#","readme":"# VkBotFramework\n![VkBotFramework Logo](https://github.com/truecooler/VkBotFramework/raw/master/vkbotframework.png)\n\nУдобная, маленькая и кроссплатформенная библиотека для создания ботов в соц. сети ВКонтакте\n## Getting Started\nЭти инструкция позволит вам просто и быстро сделать своего бота для вк.\n\n### Install\nУстановите Nuget пакет в ваш проект:\n**Package Manager**\n``` powershell\nPM\u003e Install-Package VkBotFramework\n```\n**.NET CLI**\n``` bash\n\u003e dotnet add package VkBotFramework\n```\n**Visual Studio Nuget Manager**\n```\nПроект -\u003e Свойства -\u003e Управление пакетами Nuget -\u003e Обзор -\u003e Поиск -\u003e VkBotFramework -\u003e Установить\n```\n\n### Prerequisites\nНа данный момент можно создавать только групповых ботов, а значит вам потребуется AccessToken и GroupUrl для взаимодействия с группой, а так же выставить необхдимые права доступа боту.\n\n#### Начальная настройка\n##### AccessToken\n- Вы можете создать его в интерфейсе настроек сообщества. Для этого достаточно открыть раздел «Управление сообществом» («Управление страницей», если у Вас публичная страница), выбрать вкладку «Работа с API» и нажать «Создать ключ доступа». Так же есть и другие способы получить токен, ознакомиться можно [тут](https://vk.com/dev/access_token).\n##### Enable Pong Poll Api\n- Так же необходимо зайти во вкладку Long Poll Api, перевести состояние Long Poll Api во \"включен\",а так же во вкладке \"типы событий\" выбрать нужные события, которые будут приходить боту.\n##### Что такое GroupUrl?\n- Это ссылка на вашу группу, которую можно взять прямо из адресной строки браузера. Библиотека сама определит id группы для своих нужд.\n##### Wiki\n- Более подробно о настройке и использовании бота можно прочесть в [wiki](https://github.com/truecooler/VkBotFramework/wiki).\n## Example\nИспользование библиотеки крайне простое:\n\n```c#\nVkBot bot = new VkBot(settings.AccessToken, settings.GroupUrl);\n/*подписываемся на событие о входящем сообщении, в которое передается экземпляр сообщения*/\nbot.OnMessageReceived += MessageReceivedTest; \n\n/*подписываемся на событие об изменении в группе, в которое передается экземпляр события в группе*/\nbot.OnGroupUpdateReceived += UpdateReceivedTest; \n\n/*регистрируем шаблон {регулярное выражение,ответ бота}*/\nbot.TemplateManager.Register(\"привет\", \"на привет всегда отвечаю кусь\"); \nbot.TemplateManager.Register(\"^[0-9]+$\", \"ого, я определил, что вы прислали мне число!\");\n\n/*регистрируем шаблон {регулярное выражение,случайная фраза из списка}*/\nbot.TemplateManager.Register(\"ты кто\", new List\u003cstring\u003e() {\"меня зовут мишутка\",\"вы о ком\",\"не говори так со мной\",\"а ты кто?\"}); \n\n/*регистрируем шаблон {регулярное выражение, user specified callback}*/\nbot.TemplateManager.Register(\"колобок\", (msg) =\u003e\n{\n\tConsole.WriteLine($\"кто-то написал {msg.Text}, я могу регировать на эту фразу так, как я хочу! system(\\\"reboot\\\")\");\n});\n\n/*запускаем бота синхронно...*/\nbot.Start();\n        \n```\nС наглядными примерами можно ознакомиться [тут](https://github.com/truecooler/VkBotFramework/tree/master/VkBotFramework.Examples)\n\n## TODOs\n- [x] Сделать подписки на события о приходе сообщения/обновления в группе\n- [x] Сделать функционал регистрации шаблона {регулярная фраза,ответ/список ответов/user callback}\n- [x] Сделать асинхронный Start\n- [x] Добавить функционал кнопок\n- [x] Сделать логгирование\n- [ ] Сделать тесты\n- [ ] Сделать библиотеку пригодной для создания бота пользователя(без группы)\n\n## Зависимости\n\n* [VkNet](https://github.com/vknet/vk) - взаимодействие с Api ВКонтакте.\n\n## Built With\n\n* [VisualStudio](http://visualstudio.com)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftruecooler%2Fvkbotframework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftruecooler%2Fvkbotframework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftruecooler%2Fvkbotframework/lists"}