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).