Open Slack API Server.
Go to file
Stanislav Nikitin 46aee4d2ab
Moved to zerolog, linting fixes, update Drone configuration.
2021-11-21 16:16:10 +05:00
config Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
context Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
doc Some documentation fixes, related to #4. 2019-03-12 21:46:29 +05:00
docker CI 2019-09-25 21:20:29 +05:00
parsers Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
pushers Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
slack Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
.drone.yml Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
.gitignore Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
.gitlab-ci.yml CI 2019-09-25 21:20:29 +05:00
.golangci.yml Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
Dockerfile Forgotten Dockerfile :) 2019-09-25 21:23:30 +05:00
LICENSE Initial commit with Matrix support. Messages are successfully delivered. 2017-08-28 01:13:45 +05:00
README.md Some documentation fixes, related to #4. 2019-03-12 21:46:29 +05:00
builder.sh Simple builder that builds OpenSAPS for every known OS. Some might be missing, MRs welcome :). 2019-03-06 05:38:15 +05:00
go.mod Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
go.sum Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +05:00
opensaps.example.yaml Fixed requests router and added possibility to connect to Telegram via HTTP proxy (fixes #2). 2019-03-05 18:32:34 +05:00
opensaps.go Moved to zerolog, linting fixes, update Drone configuration. 2021-11-21 16:16:10 +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.

Join #opensaps:pztrn.name Matrix room for help and chat!

Installation

go get -u -v -d gitlab.com/pztrn/opensaps
go install -v gitlab.com/pztrn/opensaps

Or drop into tags section to grab a precompiled binary!

Configuration

Take a look at opensaps.example.yaml for configuration example and into docs section for configuration file fields description.

Usage

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

opensaps -config /path/to/opensaps.yaml

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. Nickname under which messages will appear depends on your account's configuration.

Known to work good software

There is a list of software that known to work fine with OpenSAPS. Check it out!


IMPORTANT NOTICE

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