Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fabriziomoscon/twiliogo
Go helper library for the Twilio API
https://github.com/fabriziomoscon/twiliogo
Last synced: 3 months ago
JSON representation
Go helper library for the Twilio API
- Host: GitHub
- URL: https://github.com/fabriziomoscon/twiliogo
- Owner: fabriziomoscon
- License: mit
- Fork: true (tulip/twiliogo)
- Created: 2016-05-13T08:45:09.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-13T13:23:57.000Z (over 6 years ago)
- Last Synced: 2024-06-20T23:56:13.139Z (5 months ago)
- Language: Go
- Size: 69.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-twilio-golang - fabriziomoscon/twiliogo
README
[](https://travis-ci.org/carlosdp/twiliogo)
# twilio-go
One of the many unofficial Go helper library for [Twilio](http://twilio.com).
[list of all libraries](https://github.com/hoxfon/awesome-twilio-golang)
# Installation
``` bash
go get github.com/fabriziomoscon/twiliogo
```
# Documentation
[GoDoc](https://godoc.org/github.com/fabriziomoscon/twiliogo)
# Usage
## Send a Text
``` go
package main
import (
"fmt"
twilio "github.com/fabriziomoscon/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/fabriziomoscon/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
- Address
- Application
- Available Phone number
- Incoming phone number
- 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
```
## 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:
- OutgoingCallerIds
- ConnectApps
- AuthorizedConnectApps
- Conferences
- Queues
- Short Codes
- Recordings
- Transcriptions
- Notifications
- SIP Domains
- IpAccessControlLists
- CredentialLists
- Usage Triggers
## License
This project is licensed under the [MIT License](http://opensource.org/licenses/MIT)