VKEnterprise - простая в использовании open-source библиотека интеграции с ВКонтакте для 1С

19.01.24

Библиотека методов для интеграции ВКонтакте с открытым исходным кодом. Реализованы базовые методы, в частности связанные с управлением сообществами.

VKEnterprise теперь часть Открытого пакета интеграций

Данная библиотека теперь развивается не как отдельный проект, но в составе ОПИ
infostart.ru/1c/articles/2016164/

VKEnterprise

Библиотека интеграции 1С и ВКонтакте

Особенности:

Не нужно ничего устанавливать: создайте 2 пустых модуля в базе и скопируйте код из репозитория туда
Не нужно разбираться в документации VK API: методы уже выполняют конкретные действия, которые подойдут большинству пользователей, вроде СоздатьПост() или СделатьРепост()
Основная разработка с тестированием велись на версии 8.3.15, с большего протестировано на 8.3.6. Возможно, будет работать и на более ранних версиях.

Код можно забрать в репозитории на GitHub:

https://github.com/Bayselonarrend/VKEnterprise

Для начала использования библиотеки достаточно пройти два простых шага:

Установка библиотеки

Получение необходимых данных

Перед началом работы необходимо получить некоторые параметры для VK API. Их перечень содержится в функции ПолучитьСтандартныеПараметры()

Полученные параметры можно будет вставить в структуру внутри ПолучитьСтандартныеПараметры() и все будет работать. Если же вы хотите передавать их каждый раз при вызове (например разный набор для нескольких сообществ или аккаунтов), то это можно сделать через параметр Параметры, который есть у каждого метода. При вызове, параметры заполняются из функции ПолучитьСтандартныеПараметры(), после чего заменяются по ключам значениями, переданными в параметр Параметры, если таковые существуют

_Параметры = Новый Структура;

_Параметры.Вставить("v"	              , "5.131");
_Параметры.Вставить("from_group"      , "1");
_Параметры.Вставить("group_id"        , "123456789");
_Параметры.Вставить("owner_id"        , "-123456789");
_Параметры.Вставить("app_id"          , "87654321");
_Параметры.Вставить("access_token"    , "vk1.a.E-byuFeG1qcN7...");

Рассмотрим получение каждого значения:

1. v

Параметр v означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить

2. from_group

От лица группы. Должен быть 1

3. group_id и owner_id

ID группы. Если у вас стандартный адрес группы, то id можно найти в URL. В противном случае он будет на вкладке "Управление" в группе, под полем Адрес. owner_id - тоже самое, но со знаком '-' впереди

4. app_id

app_id - ID приложения. Для создания приложения необходимо:

Перейти по адресу https://vk.com/apps?act=manage, авторизоваться и нажать "Создать"
Выбрать название и пункт Standalone-приложение
После создания, перейти в редактирование на вкладку Настройки, забрать оттуда ID приложения (и есть app_id), и переключить статус на "Приложение включено и видно всем"
Сохранить изменения

5. access_token

acess_token можно получить при помощи одного из методов модуля Действия:

Выполнить СоздатьСсылкуПолученияТокена(app_id), Передав туда ID приложения из пункта 5
Метод вернет URL, по нему необходимо перейти в браузере
Авторизоваться через ВК и подтвердить
Забрать токен из параметра URL в адресной строке

Дополнительно communitytoken Некоторые методы, например отправка сообщений чат-ботом сообщества, принимают в качестве параметра communitytoken - в этих методах он заменяет access_token. Для его получения необходимо:

Зайти в раздел "Управление" в группе ВК
Найти вкладку "Работа с API"
Нажать "Создать ключ" и забрать его

Пока вам не нужно использовать такие методы, получать communitytoken не обязательно

Реализованные методы:

Все методы возвращают ответ от ВК как структуру

Для управления контентом в группе

Эти методы предназначены для создания/удаления/редактирования контента в сообществе

Создание поста | Метод: СоздатьПост()

Параметр	Тип	Назначение
Текст	Строка	Непосредственно текст поста
МассивКартинок	Массив строк (путей к файлам), Массив Двоичных данных	Массив картинок, которые необходимо прикрепить к посту
Рекламный	Булево (По умолчанию Ложь)	Пометить пост как рекламу
СсылкаПодЗаписью	Строка (По умолчанию "")	Позволяет прикрепить ссылку к посту
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Удаление поста | Метод: УдалитьПост()

Параметр	Тип	Назначение
ID	Строка/Число	ID поста (из URL адреса поста или ответа СоздатьПост()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Создание опроса | Метод: СоздатьОпрос()

Параметр	Тип	Назначение
Вопрос	Строка	Вопрос в опросе
МассивОтветов	Массив строк	Набор ответов на вопрос опроса
Картинка	Строка (Путь к файлу)/ДвоичныеДанные (по умолчанию "")	Картинка фона опроса*
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Вероятно, из-за бага ВК картинка в опрос на 09.2023 не добавляется. Разбирали запрос вместе с поддержкой - ошибок не нашли, но и решить ничего не смогли

Создание альбома для картинок | Метод: СоздатьАльбом()

Параметр	Тип	Назначение
Наименование	Строка	Название альбома
Описание	Строка	Описание альбома
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Сохранить картинку в альбом | Метод: СохранитьКартинкуВАльбом()

Параметр	Тип	Назначение
IDАльбома	Строка/Число	ID альбома со стены или из ответа метода СоздатьАльбом()
Картинка	Строка (Путь к файлу)/ДвоичныеДанные	Картинка для сохранения
Описание	Строка (По умолчанию "")	Описание картинки
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Удалить картинку из группы | Метод: УдалитьКартинку()

Параметр	Тип	Назначение
IDКартинки	Строка/Число	ID картинки из URL в браузере или из ответа метода СохранитьКартинкуВАльбом()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Добавить историю (storie) с картинкой в группу | Метод: СоздатьИсторию()

Параметр	Тип	Назначение
Картинка	Строка (Путь к файлу)/ДвоичныеДанные	Картинка истории
URL	Строка (по умолчанию "")	Добавляет кнопку с переходом по ссылке внизу истории, если введено

Для работы с обсуждениями

Эти методы предназначены для работы с обсуждениями в группе

Создать обсуждение | Метод: СоздатьОбсуждение()

Параметр	Тип	Назначение
Наименование	Строка	Название темы
ТекстПервогоСообщения	Строка	Первое сообщение в теме
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Закрыть или удалить обсуждение | Метод: ЗакрытьОбсуждение()

Параметр	Тип	Назначение
IDОбсуждения	Строка/Число	ID обсуждение из URL или ответа метода СоздатьОбсуждение()
УдалитьПолностью	Булево (по умолчанию Ложь)	Истина - удаляет обсуждение, Ложь - закрывает обсуждение для новых сообщений
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Открыть ранее закрытое обсуждение | Метод: ОткрытьОбсуждение()

Параметр	Тип	Назначение
IDОбсуждения	Строка/Число	ID обсуждение из URL или ответа метода СоздатьОбсуждение()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Написать в обсуждение | Метод: НаписатьВОбсуждение()

Параметр	Тип	Назначение
IDОбсуждения	Строка/Число	ID обсуждение из URL или ответа метода СоздатьОбсуждение()
Текст	Строка	Текст сообщения в теме
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Для получения статистики по группе

Параметр	Тип	Назначение
ДатаНачала	Дата	Начало периода
ДатаОкончания	Дата	Конец периода
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Параметр	Тип	Назначение
МассивIDПостов	Массив строк/чисел	Массив номеров постов
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Для работы с рекламным кабинетом

Эти методы предназначены для работы с кампаниями и объявлениями в https://vk.com/ads

Создание новой рекламной кампании | Метод: СоздатьРекламнуюКампанию()

Параметр	Тип	Назначение
IDКабинета	Строка/Число	Номер кабинета из настроек https://vk.com/ads?act=settings
Наименование	Строка	Наименование кампании
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Создание нового рекламного объявления на основе существующего поста | Метод: СоздатьРекламноеОбъявление()

Параметр	Тип	Назначение
НомерКампании	Строка/Число	Номер кампании из кабинета или ответа метода СоздатьРекламнуюКампанию()
ДневнойЛимит	Строка/Число	Дневной лимит затрат записи в рублях
НомерКатегории	Строка/Число	Номер категории тематики ВК
IDПоста	Строка/Число	ID поста, который нужно рекламировать
IDКабинета	Строка/Число	Номер рекламного кабинета из настроек https://vk.com/ads?act=settings
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Приостанавливает выполнение рекламного объявления | Метод: ПриостановитьРекламноеОбъявление()

Параметр	Тип	Назначение
IDКабинета	Строка/Число	Номер кабинета из настроек https://vk.com/ads?act=settings
IDОбъявления	Строка/Число	ID рекламного объявления из кабинета или ответа метода СоздатьРекламноеОбъявление()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Заменяет рекламируемый пост в рекламном объявлении | Метод: ИзменитьЗаписьРекламногоОбъявления()

Параметр	Тип	Назначение
IDПоста	Строка/Число	ID поста, который необходимо рекламировать
IDКабинета	Строка/Число	Номер кабинета из настроек https://vk.com/ads?act=settings
IDОбъявления	Строка/Число	ID рекламного объявления из кабинета или ответа метода СоздатьРекламноеОбъявление()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Интерактивные действия

Эти методы предназначены для выполнения действий с объектами ВК

Лайк | Метод: ПоставитьЛайк()

Параметр	Тип	Назначение
IDПоста	Строка/Число	Номер поста, на который нужно поставить лайк
IDСтены	Строка/Число (по умолчанию группа из стандартных настроек)	Группа или профиль, на котором находится пост (ID стены сообщества пишется со знаком '-' !)
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Репост | Метод: СделатьРепост()

Параметр	Тип	Назначение
IDПоста	Строка/Число	Номер поста, который нужно репостнуть
IDСтены	Строка/Число (по умолчанию группа из стандартных настроек)	Группа или профиль, на котором находится пост (ID стены сообщества пишется со знаком '-' !)
ЦелеваяСтена	Строка/Число	Стена, на которую нужно репостнуть запись. Если пусто - репостит на стену текущего пользователя
Рекламный	Булево	Пометить как рекламу
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Написать комментарий от имени сообщества | Метод: НаписатьКомментарий()

Параметр	Тип	Назначение
IDПоста	Строка/Число	Номер поста, который нужно репостнуть
IDСтены	Строка/Число (по умолчанию группа из стандартных настроек)	Группа или профиль, на котором находится пост (ID стены сообщества пишется со знаком '-' !)
Текст	Строка	Текст сообщения
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Попытка отправить комментарий от недавно созданной или малочисленной группы может привести к ошибке "Access denied: could not access to this community"

Отправить сообщение пользователю от бота | Метод: НаписатьСообщение()

Параметр	Тип	Назначение
Текст	Строка	Текст сообщения
IDПользователя	Строка/Число	ID пользователя, который может быть получен при приеме сообщения от пользователя боту*
communitytoken	Строка	access_token сообщества (см. Получение необходимых данных)
Клавиатура	Строка	Описание кнопок для бота. Может быть получена методом СформироватьКлавиатуру()
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Боты могут отправлять сообщения пользователю только если тот написал первым

Сформировать простейшую клавиатуру из массива кнопок | Метод: СформироватьКлавиатуру()

Параметр	Тип	Назначение
МассивКнопок	Массив строк*	Массив строк, каждый элемент которого обозначает надпись на кнопке в интерфейсе чат-бота
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

Нажатия на клавиатуру можно будет идентифицировать по этим же строкам

Сервисные методы

Параметр	Тип	Назначение
URL	Строка	Адрес для сокращения
Параметры	Структура (по умолчанию нет)	Параметры / перезапись стандартных параметров (см. Получение необходимых данных)

В проекте используется механизм распаковки zip и gzip vbondarevsky/Connector

Copyright 2017-2023 Vladimir Bondarevskiy под Apache License, Version 2.0

https://github.com/vbondarevsky/Connector/

Остальной проект распространяется под лицензией MIT. Модуль Инструменты данной библиотеки совместим с подобными модулями последних версий остальных библиотек в линейке:

ViberEnterprise - библиотека для интеграции с Viber

TelegramEnterprise - библиотека для интеграции с Telegram

 

 Мой GitHub:     https://gitub.com/Bayselonarrend 
 Лицензия MIT:   https://mit-license.org

Вступайте в нашу телеграмм-группу Инфостарт

+38 –

Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».

0% комиссии — оплата напрямую исполнителю;
Исполнители любого масштаба — от отдельных специалистов до команд под проект;
Прямой обмен контактами между заказчиком и исполнителем;
Безопасная сделка — при необходимости;
Рейтинги, кейсы и прозрачная система откликов.

См. также

Интеграция 1С с API Boxberry, СДЭК, Энергия, Почта России, DPD, ПЭК, Grastin, Деловые Линии, КСЕ, Dalli, ЯндексДоставка

WEB-интеграция Рабочее место Оптовая торговля Розничная торговля Логистика, склад и ТМЦ Пользователь 1С:Предприятие 8 1С:Бухгалтерия 2.0 1С:Бухгалтерия 3.0 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 1.6 1С:Управление нашей фирмой 3.0 1С:Управление торговлей 10 1С:Управление торговлей 11 1С:Розница 2 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика Россия Управленческий учет Платные (руб)

Программный продукт "Управление доставками в 1С" позволяет обмениваться с личным кабинетом Boxberry, СДЭК, Энергия, Почта России, DPD, ПЭК, Grastin, Деловые Линии, КСЕ, Dalli, ЯндексДоставка. Упрощает создание заявок и резервирование заказов прямо в интерфейсе 1С

24400 руб.

10.03.2016 76064 321 100

Экспортер — автоматизация выгрузки данных из 1С в Spot2D

WEB-интеграция Разработчик Аналитик 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

17568 руб.

20.12.2024 7738 35 4

Интеграция Альфа Авто 5 и 6 и AUTOCRM + LOGICSTARS

Сайты и интернет-магазины WEB-интеграция Системный администратор Разработчик Пользователь 1С:Предприятие 8 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM / LOGICSTARS. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM / LOGICSTAR разных брендов в одной информационной базе в ручном и автоматическом режиме.

42700 руб.

03.08.2020 25811 42 26

Интеграция Альфа Авто 6 и LSAvto по API (LogicStars) (CHERY, OMODA, JAECOO, EXEED, TENET)

WEB-интеграция Системный администратор Разработчик Пользователь 1С:Предприятие 8 1C:Бухгалтерия 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена по API между конфигурацией 1С:Альфа-Авто 6 и порталом LogicStar. Позволяет работать с несколькими обменами LogicStars разных брендов (CHERY, OMODA, JAECOO, EXEED, TENET) в одной информационной базе в ручном и автоматическом режиме. Поддерживается выгрузка заказ-нарядов, реализаций товаров и товарных остатков.

20740 руб.

13.05.2025 3065 6 0

Интеграция 1С с OpenCart 2.x, 3x модуль обмена данными

WEB-интеграция Оптовая торговля Розничная торговля Разработчик 1С:Предприятие 8 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 Розничная и сетевая торговля (FMCG) Оптовая торговля, дистрибуция, логистика Управленческий учет Платные (руб)

Модуль интеграции 1С с OpenCart 2.x, 3x позволяет обмениваться данными между OpenCart (самая популярная бесплатная cms для интернет-магазинов) и 1С:Предприятие 8.

6914 руб.

17.11.2015 135230 477 143

257

Яндекс.Метрика - загрузка статистики в 1С

WEB-интеграция Разработчик Пользователь 1С:Предприятие 8 1C:Бухгалтерия Управленческий учет Платные (руб)

Хорошая основа вашего решения импорта данных статистики Яндекс.Метрики в информационную базу 1С. Получение счетчиков, запрос статистики, получение данных - все в одной обработке.

5094 руб.

21.06.2022 11400 12 0

Выгрузка товаров в VK маркет из 1С

WEB-интеграция Загрузка и выгрузка в Excel Разработчик Пользователь 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Розница 3.0 Розничная и сетевая торговля (FMCG) Россия Платные (руб)

Расширение освободит вас от необходимости вручную обновлять информацию о товарах в группах ВКонтакте. Достаточно задать правила один раз, и система автоматически формирует файлы yml для дальнейшей загрузки в группы в ВК. Вы сможете легко выбирать, какие товары публиковать, создавая гибкие критерии отбора. Например, можно добавить важные для покупателей параметры: цвет, размер или другие характеристики.

12200 руб.

29.08.2025 3740 7 8