Библиотека для работы с VKTeams (open-source)

25.01.25

Интеграция - WEB-интеграция

Новая библиотека в составе Открытого пакета интеграций - VK Teams: текстовые сообщения, отправка файлов, управление чатами и диалогами из 1С и не только

Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Для тех, кто уже знаком с ОПИ, данный раздел можно пропустить.

 
 Что такое Открытый Пакет Интеграций

 

Открытый Пакет Интеграций (ОПИ) - это open-source набор методов для простой и быстрой интеграции с различными популярными API. Он состоит из аналогичных по функционалу 1С-расширения (CFE), OS-пакета и программы для Windows и Linux, которые предоставляют готовые функции для работы с целым набором различных онлайн-сервисов.


  • ОПИ бесплатен и имеет открытый исходный код на GitHub. Вы всегда можете получить последнюю версию библиотеки на странице репозитория, а подписавшись - узнавать о выходе обновлений. Все релизы сопровождаются статьями на Инфостарт и разделами единой документации. На Инфостарт вы можете подписаться уже хоть сейчас, а про документацию я расскажу далее.

 

 

 

  • Удобная единая документация. Она расположена на сайте opi.neocities.org и содержит в себе всю информацию, необходимую для работы: инструкции по предварительным действиям для начала интеграции, описания всех методов с параметрами и возвращаемыми значениями, примеры кода и т.д. Каждый API имеет там свой раздел.

 

 

 

 

  • Простая установка. ОПИ распространяется во множестве вариантах: как XML файлы расширения, как EDT проект расширения, как файл расширения формата .cfe (версия 1С 8.3.9), как файл пакета для OneScript и еще в целом наборе пакетов и файлов для Windows и Linux. Из этого набора вы всегда сможете выбрать тот способ установки, который лучше подойдет для вашей конкретной задачи

 

На момент последнего обновления данной статьи, доступны следующие API:

Наиболее актуальную информацию можно посмотреть в репозитории или на вводной странице документации.

 

VK Teams - отечественный корпоративный мессенджер, являющийся одной из наиболее известных альтернатив на замену ушедшим зарубежным решениям. Входит в набор сервисов VK Workspace.

 

Также, как и в большинстве других мессенджеров, как корпоративных так и общих, в VK Teams есть API для управления ботами, на чем и основано сегодняшнее обновление ОПИ. Были реализованы такие функции как:

  • Получение общей информации о боте
  • Отправка текстовых сообщение
  • Отправка файлов
  • Отправка голосовых сообщений (на основе аудиофайлов)
  • Изменение существующих сообщений
  • Удаление сообщений
  • Получение информации о чатах
  • Добавление, исключение и блокировка пользователей в чатах
  • Изменение описания чата
  • Закрепление и открепление сообщений
  • Обработка событий в чатах

 


Тарификация

Затрону немного тему денег и импортозамещения

Сервис VK Teams не бесплатен - он работает по подписке, которая рассчитывается от количества пользователей: 159 или 199 руб. за человека в зависимости от того, является оплата ежемесячной или ежегодной. Это неплохой вариант, если вы уже пользуетесь другими сервисами VK Workspace или число сотрудников (пользователей) не слишком большое. Если же фирма большая и при этом нет проблем с тем, чтобы своими силами хостить сервис для обмена сообщениями, то я бы рекомендовал лучше смотреть в сторону self-hosted вариантов, вроде Rocket.Chat или Mattermost. У VK Teams есть некая опция под названием "Индивидуальный тариф" на тот случай, если количество необходимых лицензий >500, но что это и насколько оно выгодно я сказать не ручаюсь


 


 

Создание ботов

Схоже с тем, как это происходит в Telegram, за создание ботов отвечает другой, специальный бот - @metabot

 

 

У него можно как создать нового бота, так и отредактировать старых, в том числе и обновить ключи в случае их утраты. С юзабилити есть некоторые проблемы: так, например, очень сложно найти своего бота после создания (необходимо формировать ссылку из полученного ID и переходить по ней, другого способа я не нашел), но в целом, уже сами боты умеют довольно много чего. В начале есть полный список, в целом можно отправлять файлы и сообщения (в том числе и с клавиатурами), а также получать назад ответы в Polling режиме. Вебхук здесь не предусмотрен

 

Еще больше информации о начале работы и доступных методах, вы, как и всегда, сможете найти в документации библиотеки ОПИ

 

Больше сказать про этот сервис особенно и нечего. Качайте и устанавливайте ОПИ в свои проекты: помимо героя сегодняшней статьи, там еще есть целая куча других сервисов для работы, в том числе Bitrix24, Telegram и VK. Ссылка на последнюю версию будет ниже

 

 

 Если вам нравится ОПИ, то не забывайте поддерживать его звездочкой на GitHub и плюсом на Инфостарт!
 

 

Спасибо за внимание!

 

 

Репозиторий ОПИ: github.com/Bayselonarrend/OpenIntegrations

Последний релиз: github.com/Bayselonarrend/OpenIntegrations/releases/latest

 

Другие статьи про Открытый пакет интеграций на Инфостарт:

 

 

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

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

web API VK Teams интеграция обмен бот боты мессенджер сообщения

См. также

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

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

36000 руб.

03.08.2020    21885    32    24    

25

SALE! 15%

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

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

17280 14688 руб.

20.12.2024    4088    20    2    

21

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

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки. Основные преимущества: 1. Документация API создаётся автоматически. Удобна для программной обработки. 2. Изменить API столь же просто как настроить отчёт. Можно опубликовать существующий вариант отчёта. 3. Отчёты в API поддерживают параметры (Период, ДатаНачала и др.) 4. При создании простых методов не требуется изменять конфигурацию. 5. Поддерживается работа с планами обмена.<br/> 6. Возможно настроить отправку из 1С данных корреспондирующей системе, для случаев когда 1С сама "знает" какие данные нужно отправить. 7. После записи в 1С Ле Мурр может возвращать соответствие полученных идентификаторов созданным в 1С объектам данных.

36000 руб.

27.09.2024    9089    7    5    

10

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

Обмен данными с "Порталом поставщиков" zakupki.mos.ru Москвы и Московской области с целью создания оферт для закупок государственными учреждениями. Модуль устраняет рутину, минимизирует ошибки и помогает выигрывать больше закупок. Работает строго по требованиям 44-ФЗ.

14400 руб.

13.12.2016    41403    54    39    

37

Обмен с ГосИС WEB-интеграция Бухгалтер Пользователь 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

5196 руб.

28.04.2016    98405    111    218    

359
Вознаграждение за ответ
Показать полностью
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. zabaluev 466 26.08.24 10:07 Сейчас в теме
Большое спасибо за разработку. Хоть проект и Open Source, кто то бы хотел и поблагодарить автора не только словом. Предлагаю Вам добавить к своим публикациям что то для скачивания за SM. Чисто для того, что бы была возможность не только скачать но и поощрить автора.
EvgeniyOlxovskiy; +1 Ответить
2. bayselonarrend 2945 26.08.24 10:15 Сейчас в теме +10 $m
(1) Если есть желание, то для этого есть кнопка Добавить вознаграждение над комментариями)
EvgeniyOlxovskiy; +1 Ответить
3. vandalsvq 1682 26.08.24 10:50 Сейчас в теме
Классная тулза +100500 автору.

Как идея для развития - mattermost. Поскольку Slack не любит Россию то MM сейчас многие используют, тем более его можно поставить на свои сервера и бесплатно. Интеграция у него по аналогии со Slack реализована, но кажется несколько проще (на поверхности).

Пы.сы. в issues закинули уже предложение. Значит я просто в очереди )))
Пы.пы.сы. из всех методов, мне кажется, для начала хватило бы вокруг отправить/получить, а всякие операторы вроде /... можно и потом. В большинстве случаев многим надо - отправить в канал / получить из канала. Хотя отправить наверное самое востребованное
4. bayselonarrend 2945 26.08.24 10:53 Сейчас в теме
(3) Спрашивали в Issues про mattermost: главная проблема его реализации - это какое-то невообразимо большое количество методов в API)
6. vandalsvq 1682 26.08.24 10:56 Сейчас в теме
(4) быстро ответил )))) я думал просто в предыдущее допишу, ты потом прочтешь ))))
Я планировал в рамках нашей системы управления задачами сделать банальную отправлялку в каналы. Мне кажется большинству ничего другого и не надо. Я со Slack в свое время чего только не делал, но как жизнь показала просто оповещалка - самое основное.
5. bayselonarrend 2945 26.08.24 10:55 Сейчас в теме
(3)
сейчас многие используют


Действительно популярен? Я лично первый раз про него услышал, когда про API спросили
seperblunt; +1 Ответить
7. vandalsvq 1682 26.08.24 10:58 Сейчас в теме
(5) сложно сказать, я после некоторого изучения рассматривал RocketChat, MM ну и наши всякие отечественные. Но после Slack однозначно ни один из "наших" вообще не подошел, просто какое-то "нууууу такое...". Ну и сам факт, что можно развернуть у себя на сервере и есть приложение для телефонов, да еще и opensource - если кто-то его не использует - то только из-за незнания и отсутствия голосовых сообщений )))
bayselonarrend; +1 Ответить
Для отправки сообщения требуется регистрация/авторизация