seven SMS for Zammad

Two-way SMS messaging for Zammad via the seven gateway.

---

Features

• Outbound SMS — Send SMS notifications directly from Zammad tickets
• Inbound SMS — Receive SMS and automatically create or update tickets
• Custom Sender ID — Configure a sender name or number for outbound messages

How it works

                    ┌────────────────┐
                    │  Zammad Ticket │
                    └───────┬────────┘
                            │
            ┌───────────────┼───────────────┐
            │               │               │
            ▼               ▼               ▼
    ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
    │   Outbound   │ │   Inbound    │ │ Notification │
    │   (Reply)    │ │  (Webhook)   │ │  (Trigger)   │
    └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
           │                │                │
           └────────────────┼────────────────┘
                            │
                            ▼
              ┌───────────────────────┐
              │  seven SMS Gateway    │
              │  gateway.seven.io     │
              └───────────┬───────────┘
                          │
                          ▼
                   ┌──────────────┐
                   │   Customer   │
                   │    Phone     │
                   └──────────────┘

Prerequisites

• Zammad v6.x (self-hosted)
• A seven account with API key (How to get your API key)

Installation

Step 1: Upload the package

Download seven-sms.szpm from the latest release.

In Zammad, navigate to Admin > System > Packages, click Choose File and select the downloaded .szpm file, then click Install Package.

Screenshot: Package Management

Screenshot: Package installed

Step 2: Finalize installation

Important: This step is required! Without it, the plugin will not appear in the SMS provider selection.

Run these commands on your Zammad server as the zammad user:

zammad run rake zammad:package:migrate
zammad run rake assets:precompile
systemctl restart zammad

Step 3: Configure SMS Notification

Navigate to Channels > SMS and click New under SMS Notification. Select seven as the provider, enter your API key and optionally set a sender ID.

Screenshot: SMS Channel overview

Screenshot: Configure SMS Notification

Step 4: Test

Click Test to verify the connection. You should see a "SMS successfully sent" confirmation.

Screenshot: Test SMS provider

Screenshot: Success

Screenshot: Final result

Inbound SMS (Webhook)

To receive incoming SMS as Zammad tickets:

1. Set up a webhook at seven — make sure the format is set to JSON
2. Point the webhook URL to your Zammad instance
3. Incoming SMS will automatically create new tickets or append to existing conversations

Usage

For general SMS usage in Zammad, refer to the official Zammad SMS documentation.

Troubleshooting

Problem	Solution
Plugin not visible after install	Run the post-install commands from Step 2 and restart Zammad
SMS sending fails	Check your API key in the seven dashboard and verify your account balance
Inbound SMS not creating tickets	Ensure the webhook at seven is set to type JSON and the URL is reachable

Support

Need help? Feel free to contact us.