apps/opensaps
2
0
Fork 0
Code Issues 6 Pull Requests Packages Projects Releases Wiki Activity
Open Slack API Server.
6 Commits 1 Branch 0 Tags 3.4 MiB
Go 96.8%
Shell 2.4%
Dockerfile 0.8%
f716a87e99
Go to file
Stanislav N. aka pztrn f716a87e99 README update.
2017-09-13 12:30:09 +05:00
config Initial commit with Matrix support. Messages are successfully delivered. 2017-08-28 01:13:45 +05:00
context Templating, improved Matrix formatter, Gitlab parser, improved other parsers. 2017-09-13 11:44:25 +05:00
doc Updated example configuration and added basic configuration docs. 2017-09-13 12:21:40 +05:00
parsers Gitea new commit parsing fix. 2017-09-13 12:27:52 +05:00
pushers Templating, improved Matrix formatter, Gitlab parser, improved other parsers. 2017-09-13 11:44:25 +05:00
slack Templating, improved Matrix formatter, Gitlab parser, improved other parsers. 2017-09-13 11:44:25 +05:00
.gitignore Initial commit with Matrix support. Messages are successfully delivered. 2017-08-28 01:13:45 +05:00
LICENSE Initial commit with Matrix support. Messages are successfully delivered. 2017-08-28 01:13:45 +05:00
opensaps.example.yaml Updated example configuration and added basic configuration docs. 2017-09-13 12:21:40 +05:00
opensaps.go Templating, improved Matrix formatter, Gitlab parser, improved other parsers. 2017-09-13 11:44:25 +05:00
README.md README update. 2017-09-13 12:30:09 +05:00

README.md

OpenSAPS

OpenSAPS stands for "Open Slack APi Server". This is an open-source implementation of Slack API server that can be used to integrate applications into each other using Slack API.

Initially this project was created for integrating Gitlab and Gitea into Matrix, because there was no good incoming webhooks support. But it can be used for anything that provides Slack Webhooks support.

Installation

go get -u -v -d lab.pztrn.name/pztrn/opensaps
go install -v lab.pztrn.name/pztrn/opensaps

Configuration

Take a look at opensaps.example.yaml for configuration example. Right now there is no documentation about configuration file, but it will appear in future.

Usage

The only parameter OpenSAPS binary accepts is a configuration file path. Do it like:

opensaps -config /path/to/opensaps.yaml

There is some documentation available - check out doc directory!

About hooks and parsers

While configuring a webhook in your application, please, set username exactly same as one of parsers in parsers directory! Otherwise parser "default" will be used, which will just concatenate text and attachments into one message!

Also note - that nickname will be ignored while sending message to pushers.

IMPORTANT NOTICE

This project isn't affiliated nor developed by Slack itself.