Contents

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

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

## Installation

install with gem or fluent-gem command as:

`````
### system installed gem
gem install fluent-plugin-twilio

### td-agent bundled 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

  # Set account Sid and Token from twilio.com/user/account
  account_sid     TWILIO_ACCOUNT_SID           # Required
  auth_token      TWILIO_AUTH_TOKEN            # Required

  # Set caller ID with country code
  from_number     [phone]                 # Required

  # Set defaults of making outbound call.
  # To call multiple phone at the same time, list them with comma like below.
  default_number  [phone],[phone]  # Optional

  # Set log level to prevent info error for Fluentd v0.10.43 or later.
  log_level       warn
</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/

## Blog Articles

* http://y-ken.hatenablog.com/entry/fluent-plugin-twilio-has-released

## 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

2 entries across 2 versions & 1 rubygems

Version	Path
fluent-plugin-twilio-0.0.3	README.md
fluent-plugin-twilio-0.0.2	README.md