Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tulip/twiliogo
Go helper library for the Twilio API
https://github.com/tulip/twiliogo
Last synced: 17 days ago
JSON representation
Go helper library for the Twilio API
- Host: GitHub
- URL: https://github.com/tulip/twiliogo
- Owner: tulip
- License: mit
- Fork: true (carlosdp/twiliogo)
- Created: 2016-04-21T19:22:52.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-10-09T17:39:09.000Z (over 5 years ago)
- Last Synced: 2024-01-14T21:08:44.799Z (6 months ago)
- Language: Go
- Size: 57.6 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-twilio-golang - tulip/twiliogo
README
[](https://travis-ci.org/carlosdp/twiliogo)
# twilio-go
The unofficial Go helper library for [Twilio](http://twilio.com).
# Installation
``` bash
go get github.com/carlosdp/twiliogo
```
# Documentation
[GoDoc](http://godoc.org/github.com/carlosdp/twiliogo)
# Usage
## Send a Text
``` go
package main
import (
"fmt"
twilio "github.com/carlosdp/twiliogo"
)
func main() {
client := twilio.NewClient("", "")
message, err := twilio.NewMessage(client, "3334445555", "2223334444", twilio.Body("Hello World!"))
if err != nil {
fmt.Println(err)
} else {
fmt.Println(message.Status)
}
}
```
## Make a Call
``` go
package main
import (
"fmt"
twilio "github.com/carlosdp/twiliogo"
)
func main() {
client := twilio.NewClient("", "")
call, err := twilio.NewCall(client, "8883332222", "3334443333", nil)
if err != nil {
fmt.Println(err)
} else {
fmt.Println("Call Queued!")
}
}
```
## Implemented Resources
- Calls
- Messages
- IncomingPhoneNumbers (partial)
## Run Tests
Tests can be run using `go test`, as with most golang projects. This project also contains integration tests (where they can be done non-destructively using the API or the working Test Credential endpoints).
These integration tests can be run by providing the necessary environment variables to access the API, as in this Makefile:
```makefile
test:
@export API_KEY="";\
export API_TOKEN="";\
export TEST_KEY="";\
export TEST_TOKEN="";\
export TEST_FROM_NUMBER="";\
export FROM_NUMBER="";\
export TO_NUMBER="";\
go test -v
```
## Contributing
This is a side project meant to allow for quick adoption of the Twilio API for those programming web applications with it in Go. Feel free to submit pull requests so that we can cover all of the features the Twilio API has to offer!
## To Do
Here are a few things that the project needs in order to reach v1.0:
1. Complete test coverage. Right now, tests cover the bare minimum of usage for each feature implemented.
2. Complete IncomingPhoneNumber functionality.
3. Implement the following resources:
- AvailablePhoneNumbers
- OutgoingCallerIds
- Applications
- ConnectApps
- AuthorizedConnectApps
- Conferences
- Queues
- Short Codes
- Recordings
- Transcriptions
- Notifications
- SIP Domains
- IpAccessControlLists
- CredentialLists
- Usage Records
- Usage Triggers
## License
This project is licensed under the [MIT License](http://opensource.org/licenses/MIT)