{"id":19404500,"url":"https://github.com/seven-io/zammad","last_synced_at":"2026-02-20T06:03:32.965Z","repository":{"id":106115452,"uuid":"248248570","full_name":"seven-io/zammad","owner":"seven-io","description":"The official Zammad package for seven.io","archived":false,"fork":false,"pushed_at":"2025-03-28T16:37:20.000Z","size":580,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-24T22:29:30.957Z","etag":null,"topics":["sms","zammad"],"latest_commit_sha":null,"homepage":"https://www.seven.io/en/solutions/integrations/zammad/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seven-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-03-18T14:06:47.000Z","updated_at":"2025-03-28T16:34:33.000Z","dependencies_parsed_at":"2025-04-24T09:44:06.175Z","dependency_job_id":null,"html_url":"https://github.com/seven-io/zammad","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/seven-io/zammad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fzammad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fzammad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fzammad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fzammad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seven-io","download_url":"https://codeload.github.com/seven-io/zammad/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seven-io%2Fzammad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29642907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T05:21:04.652Z","status":"ssl_error","status_checked_at":"2026-02-20T05:21:04.238Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sms","zammad"],"created_at":"2024-11-10T11:35:16.383Z","updated_at":"2026-02-20T06:03:32.961Z","avatar_url":"https://github.com/seven-io.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://www.seven.io/wp-content/uploads/Logo.svg\" width=\"250\" alt=\"seven logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eseven SMS for Zammad\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Two-way SMS messaging for Zammad via the seven gateway.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-teal.svg\" alt=\"MIT License\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Zammad-v6.x-blue\" alt=\"Zammad v6.x\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-2.3.0-green\" alt=\"Version 2.3.0\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Features\n\n- **Outbound SMS** \u0026mdash; Send SMS notifications directly from Zammad tickets\n- **Inbound SMS** \u0026mdash; Receive SMS and automatically create or update tickets\n- **Custom Sender ID** \u0026mdash; Configure a sender name or number for outbound messages\n\n## How it works\n\n```\n                    ┌────────────────┐\n                    │  Zammad Ticket │\n                    └───────┬────────┘\n                            │\n            ┌───────────────┼───────────────┐\n            │               │               │\n            ▼               ▼               ▼\n    ┌──────────────┐ ┌──────────────┐ ┌──────────────┐\n    │   Outbound   │ │   Inbound    │ │ Notification │\n    │   (Reply)    │ │  (Webhook)   │ │  (Trigger)   │\n    └──────┬───────┘ └──────┬───────┘ └──────┬───────┘\n           │                │                │\n           └────────────────┼────────────────┘\n                            │\n                            ▼\n              ┌───────────────────────┐\n              │  seven SMS Gateway    │\n              │  gateway.seven.io     │\n              └───────────┬───────────┘\n                          │\n                          ▼\n                   ┌──────────────┐\n                   │   Customer   │\n                   │    Phone     │\n                   └──────────────┘\n```\n\n## Prerequisites\n\n- Zammad v6.x (self-hosted)\n- A [seven account](https://www.seven.io/) with API key ([How to get your API key](https://help.seven.io/en/api-key-access))\n\n## Installation\n\n### Step 1: Upload the package\n\nDownload **seven-sms.szpm** from the [latest release](https://github.com/seven-io/zammad/releases/latest).\n\nIn Zammad, navigate to **Admin \u003e System \u003e Packages**, click **Choose File** and select the downloaded `.szpm` file, then click **Install Package**.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Package Management\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/1_install_pkg_mgmt.png\" alt=\"Package Management\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Package installed\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/2_post_install.png\" alt=\"Package installed\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n### Step 2: Finalize installation\n\n\u003e **Important:** This step is required! Without it, the plugin will not appear in the SMS provider selection.\n\nRun these commands on your Zammad server as the *zammad* user:\n\n```bash\nzammad run rake zammad:package:migrate\nzammad run rake assets:precompile\nsystemctl restart zammad\n```\n\n### Step 3: Configure SMS Notification\n\nNavigate to **Channels \u003e SMS** and click **New** under *SMS Notification*. Select **seven** as the provider, enter your API key and optionally set a sender ID.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: SMS Channel overview\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/3_channels_sms.png\" alt=\"SMS Channels\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Configure SMS Notification\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/4_sms_notification.png\" alt=\"SMS Notification\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n### Step 4: Test\n\nClick **Test** to verify the connection. You should see a \"SMS successfully sent\" confirmation.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Test SMS provider\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/5_test_sms_provider.png\" alt=\"Test SMS\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Success\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/6_post_test_sms_provider.png\" alt=\"SMS sent\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshot: Final result\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"screenshots/7_sms_channels.png\" alt=\"Configured\" width=\"700\" /\u003e\n\u003c/details\u003e\n\n## Inbound SMS (Webhook)\n\nTo receive incoming SMS as Zammad tickets:\n\n1. Set up a [webhook at seven](https://help.seven.io/en/articles/9582203-how-do-i-receive-sms) \u0026mdash; make sure the format is set to **JSON**\n2. Point the webhook URL to your Zammad instance\n3. Incoming SMS will automatically create new tickets or append to existing conversations\n\n## Usage\n\nFor general SMS usage in Zammad, refer to the official [Zammad SMS documentation](https://admin-docs.zammad.org/en/6.1/channels/sms.html).\n\n## Troubleshooting\n\n| Problem | Solution |\n|---|---|\n| Plugin not visible after install | Run the post-install commands from Step 2 and restart Zammad |\n| SMS sending fails | Check your API key in the seven [dashboard](https://app.seven.io/) and verify your account balance |\n| Inbound SMS not creating tickets | Ensure the webhook at seven is set to type **JSON** and the URL is reachable |\n\n## Support\n\nNeed help? Feel free to [contact us](https://www.seven.io/en/company/contact/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseven-io%2Fzammad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseven-io%2Fzammad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseven-io%2Fzammad/lists"}