modSlack. Компонент интеграции со slack.com

На днях спрашивал, нужен ли компонент интеграции со слэком, но однозначной реакции не последовало. Хотя сказали, что надо просто отдельный топик написать, чтобы больше народу увидело и высказалось. ОК, публикую.

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

Краткая инструкция подключения.

1. Создаем в слэке свою команду slack.com/create

2. Идем на страницу приложений api.slack.com/apps и создаем новое.


3. Переходим в «OAuth & Permissions» и указываем Redirect URL вида your.site/assets/components/modslack/connectors/connector.php?pub_action=access


На этом настройка на стороне слэка закончилась. Теперь на стороне самого сайта надо настроить доступы и получить токен.

1. Заходим в системные настройки и указываем client-id и client-secret.


Эти данные находятся в базовой информации вашего слэк-приложения


2. Запрашиваем токен для главного пользователя. Для этого переходим по ссылке вида ваша-команда.slack.com/oauth/authorize?scope=identify,client,admin&client_id=ID-вашего-приложения(client-id). В ответ вы должны получить подобное окно:


Важно! Вы должны быть авторизованы на своем сайте, так как после авторизации в слэке вы будете переброшены на ваш сайт и там должен привязаться токен к вашему аккаунту.

Если все хорошо прошло, то к вашему MODX-пользователю будет привязан токен доступа в слэк. Чтобы проверить его, можно воспользоваться компонентом Console. При установке modSlack сразу создает для него специальный скрипт с несколькими базовыми командами.


Загрузив и выполнив его, вы должны увидеть информацию об успешной авторизации


Если авторизация успешна, то можно выполнять прочие команды. К примеру, можно получить список каналов


Или пригласить нового пользователя в слэк.


Вот здесь очень важный момент: с приглашениями не все так просто. К сожалению, нельзя просто так взять и создать пользователя в слэке. Это все происходит в два этапа:

1. Приглашаем пользователя (выше вызов процессора написал).
Пользователь получает на почту приглашение в слэк (не на ваш сайт, а именно в слэк). Там он регистриуется и получает личный слэк-аккаунт. В этот момент сайт еще ничего не знает об этом пользователей (спойлер: скоро научится)).

2. После этого пользователь должен авторизоваться на вашем сайте так же, как системный пользователь, только без прав admin, то есть ссылка вида ваша-команда.slack.com/oauth/authorize?scope=identify,client&client_id=ID-вашего-приложения(client-id). Это уже ваша задача сообщить ссылку пользователю. Когда пользователь по ней пройдет и авторизует приложение, его перебросит на сайт и ему будет привязан его токен уже в базе данных сайта. Все, с этим токеном уже можно выполнять так же действия по чтению каналов, публикации комментариев и т.п.

Компонент доступен в https://modstore.pro.
Пока цена на него установлена 2990 рублей (плюс надо закладывать тысячи три на нашу помощь в более гибкой интеграции). Пока не могу сказать повысится стоимость или нет (время покажет), но меньше она не будет, так что лучше брать уже сейчас.

Буду рад комментариям.