43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# 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](https://matrix.to/#/#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](https://gitlab.com/pztrn/opensaps/tags) to grab a precompiled binary!
|
|
|
|
# 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.
|