Skip to content

wearetechnative/slack2zammad

Repository files navigation

Slack2Zammad

Slack App providing a Message Shortcut to create Zammad ticket from Slack message

@luca read the rought TODO

Install

Prepare Slack

Create an app with this manifest...

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.

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.<name> = 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

Open Source & Contributing

Slack2zammad is open source and we appreciate contributions and positive feedback.

Docs for Project Maintainers

Read the docs and roadmaps

Credits

  • Zammad - a great supportdesk system
  • zammadoo - a fresh but nice working python client for Zammad

License and Copyright

Copyright 2025 TechNative B.V. | Published under the Apache License.

About

Slack App providing a Message Shortcut to create Zammad ticket from Slack message

Topics

Resources

License

Stars

Watchers

Forks

Contributors