Contents

fluent-plugin-twilio
=====================

## Overview
Fluentd Output plugin to make a call with twilio.

## Installation

### native gem
`````
gem install fluent-plugin-twilio
`````

### td-agent gem
`````
/usr/lib64/fluent/ruby/bin/fluent-gem install fluent-plugin-twilio
`````

## Configuration

### Message Format
`````
fluent_logger.post('notify.call', {
  :message  => 'Hello World!',   # Required
  :number   => '[phone]'  # Required
})
`````

### Sample
`````
<source>
  type http
  port 8888
</source>

<match notify.call>
  type twilio
  account_sid     TWILIO_ACCOUNT_SID  # Required
  auth_token      TWILIO_AUTH_TOKEN   # Required
  from_number     [phone]        # Required with country code
  default_number  090-1234-5678       # Optional
</match>
`````

### Quick Test
`````
# test call to [phone] and say "Help! System ABC has down." with woman voice.
$ curl http://localhost:8888/notify.call -F 'json={"number":"[phone]","voice":"woman","message":"Help! System ABC has down."}'

# check twilio activity log
$ tail -f /var/log/td-agent/td-agent.log
`````

## Backend Service

* Twilio https://www.twilio.com/
* Twilio Japan http://twilio.kddi-web.com/

## TODO
Pull requests are very welcome!!

## Copyright
Copyright © 2013- Kentaro Yoshida ([@yoshi_ken](https://twitter.com/yoshi_ken))

## License
Apache License, Version 2.0

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
fluent-plugin-twilio-0.0.1	README.md