https://github.com/wearetechnative/slack2zammad
Slack App providing a Message Shortcut to create Zammad ticket from Slack message
https://github.com/wearetechnative/slack2zammad
slack-bot zammad
Last synced: 7 months ago
JSON representation
Slack App providing a Message Shortcut to create Zammad ticket from Slack message
- Host: GitHub
- URL: https://github.com/wearetechnative/slack2zammad
- Owner: wearetechnative
- License: apache-2.0
- Created: 2024-11-12T11:46:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-25T13:14:00.000Z (9 months ago)
- Last Synced: 2025-07-14T05:18:37.559Z (9 months ago)
- Topics: slack-bot, zammad
- Language: Nix
- Homepage:
- Size: 58.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Slack2Zammad
Slack App providing a Message Shortcut to create Zammad ticket from Slack
message
@luca read the rought [TODO](TODO.md)
## Install
### Prepare Slack
Create an app with this manifest...
```yaml
display_information:
name: In2 Zammad
description: Create tickets from messages
background_color: "#ab6d22"
features:
bot_user:
display_name: Zammad
always_online: false
shortcuts:
- name: Create ticket
type: message
callback_id: create_ticket
description: Creates a ticket based on the message
oauth_config:
scopes:
bot:
- commands
settings:
interactivity:
is_enabled: true
org_deploy_enabled: false
socket_mode_enabled: true
token_rotation_enabled: false
```
Currently only the socket mode is working.
### Configure environment vars
Create a .env-file or set environment vars.
```bash
SLACK_APP_TOKEN=xoxb-XXXX....
SLACK_BOT_TOKEN=xapp-XXXX....
ZAMMAD_URL=https://my-zammad-domain.com
ZAMMAD_USER=zammad_user
ZAMMAD_PASSWD=zammad_password
```
### Without Nix
Install requirements with Pip of if you have a working nix with flake enabled.
### With Nix
nix develop
### Start application
python app.py
### Install on nixos
```
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.11";
slack2zammad.url = "github:wearetechnative/slack2zammad"
};
outputs = { nixpkgs, slack2zammad, ... }: {
nixosConfigurations. = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
slack2zammad.packages."${system}".slack2zammad # slack2zammad Package
slack2zammad.nixosModules.${system}.slack2zammad # Slack2zammad Module
];
};
};
}
```
### slack2zammad Module
Create an `slack2zammad.env` file in `/etc`, look at `.env.sample`.
```
{ slack2zammad, ... }:
{
services.slack2zammad = {
enable = true;
envFile = "/etc/slack2zammad.env"; # Default
group = "slack2zammad"; # Default
user = "slack2zammad"; # Default
};
}
```
## CONTRIBUTE
### Issues, Bugs, and Feature Requests
File issue requests [in this repo](https://github.com/wearetechnative/slack2zammad/issues/new)
### Open Source & Contributing
Slack2zammad is open source and we appreciate contributions and positive feedback.
### Docs for Project Maintainers
Read the docs and roadmaps
- [Release runbook](RELEASE-RUNBOOK.md)
- [Roadmap](TODO.md)
- [Changelog](CHANGELOG.md)
## Credits
- [Zammad](https://zammad.com) - a great supportdesk system
- [zammadoo](https://github.com/flashdagger/zammadoo) - a fresh but nice working python client for Zammad
## License and Copyright
Copyright 2025 [TechNative B.V.](https://technative.eu) | Published under the [Apache License](LICENSE).