Clockwork

Clockwork is a Go library which allows you to send SMS messages using the Clockwork SMS service.

Installation

Requires Go version 1.7+.

$ go get github.com/umahmood/clockwork

$ cd $GOPATH/src/github.com/umahmood/clockwork

$ go test ./…

Usage

Send an SMS message:

package main
import (
    "fmt"
    "github.com/umahmood/clockwork"
)
func main() {
    cw := clockwork.New("API-KEY")
    msg := clockwork.SMS{
        To:      clockwork.Numbers{"44123456789", "44987654321"},
        From:    "Gopher",
        Content: "Gophers rule!",
    }
    resp, err := cw.Send(msg)
    if err != nil {
        // ...
    }
    // print each valid number an SMS was sent to and its assigned message id
    for num, meta := range resp {
        fmt.Println(num, meta["ID"])
    }
}

Delivery receipts let you know whether a message has been delivered:

package main
import (
    "fmt"
    "github.com/umahmood/clockwork"
)
func OnDeliveryReceipt(r clockwork.Receipt) {
    if r.Err != nil {
        //...
    }
    fmt.Println("ID", r.ID, "Status", r.Status, "To", r.To, "Time", r.Time)
}
func main() {
    clockwork.DeliveryReceiptListen(&clockwork.ReceiptHandler{
        Path:     "/receipts",
        Port:     9090,
        Callback: OnDeliveryReceipt,
    })
}

Output:

ID LA_422342 Status Enroute To 441234567890 Time 2017-03-17 17:21:27.667238018 +0000 UTC

Documentation

http://godoc.org/github.com/umahmood/clockwork

License

See the LICENSE file for license rights and limitations (MIT).