seven SMS for uTask

Plugin for OVH's uTask workflow engine that sends SMS via the seven gateway as a regular workflow step.

---

Features

• Native uTask Plugin - Registered as seven_utask (v0.1)
• Workflow Step - Drop into any uTask YAML workflow as a regular step
• Env or Config Auth - API key via SEVEN_API_KEY env or per-task config

Prerequisites

• Go 1.19+
• A uTask installation (>= v1.29.1)
• A seven account with API key (How to get your API key)

Installation

git clone git@github.com:seven-io/utask.git
cd utask
go build

Drop the resulting binary or built plugin into your uTask plugin path.

Configuration

Option A: Environment variable

export SEVEN_API_KEY=your-seven-api-key

Option B: Per-task config

config:
  apiKey: your-seven-api-key
  smsParams:
    to:   "+1234567890"
    text: "Hello from uTask!"

Usage

Use the plugin as any other workflow step:

steps:
  - name: send-sms
    plugin: seven_utask
    config:
      smsParams:
        to:   "+1234567890"
        text: "Your workflow notification message"

smsParams

smsParams accepts every parameter supported by the seven SMS API:

Field	Description
to	Recipient phone number (required)
text	Message body (required)
from	Sender ID. Up to 11 alphanumeric or 16 numeric characters
delay	Delayed dispatch as Unix timestamp
...	All other seven SMS API parameters

Development

go fmt ./...
go vet ./...
go test ./...
go mod tidy

Support

Need help? Feel free to contact us or open an issue.

License

MIT