Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Для тех, кто уже знаком с ОПИ, данный раздел можно пропустить.
Открытый Пакет Интеграций (ОПИ) - это 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
Другие статьи про Открытый пакет интеграций на Инфостарт:
Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter
Открытый пакет интеграций для OneScript
Мой GitHub: https://gitub.com/Bayselonarrend OpenYellow: https://openyellow.notion.site Лицензия MIT: https://mit-license.org
