Библиотека для работы с 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С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

Онлайн-заказ - это решение для автоматизации процесса оформления заказов на сайте в торговых организациях. Продукт обеспечивает легкое взаимодействие между компанией и клиентами через веб-интерфейс, интегрированный с 1С:Предприятие. Система позволяет снизить операционные расходы, повысить лояльность клиентов и оптимизировать работу отдела продаж.

57600 руб.

26.11.2024    6464    4    3    

7

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    3778    18    2    

20

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    8293    7    5    

9

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

В расширении реализован механизм интеграции между системой поставщика и Личным кабинетом СДТ. Реализован обмен заказами и реализациями (накладными), предусмотрено отслеживание статусов документов. Расширение предназначено для 1С:УТ 11.4.

35856 руб.

27.11.2024    2032    1    0    

1

Оптовая торговля 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    41155    54    39    

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

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

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


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