Fluentd Output plugin to make a call with twilio. This Multilingual speech synthesis system supports these languages for en, en-gb, es, fr, de, it, ja-jp.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/fluent/plugin
test
.gitignore
.travis.yml
Gemfile
LICENSE.txt
README.md
Rakefile
fluent-plugin-twilio.gemspec

README.md

fluent-plugin-twilio

Overview

Fluentd Output plugin to make a call with twilio. Twilio free trial is available to signup at the official website. You can try call to your cellphone for free!

Requirements

fluent-plugin-twilio fluentd ruby
>= 0.1.0 >= v0.14.15 >= 2.1
< 0.1.0 >= v0.12.0 >= 1.9

Installation

install with gem or td-agent-gem command as:

### for local fluentd
$ gem install fluent-plugin-twilio

### for td-agent2 (standard)
$ sudo td-agent-gem install fluent-plugin-twilio

Configuration

Message Format

fluent_logger.post('notify.call', {
  :number   => '+8109012345678',  # Required if default_number is brank
  :message  => 'Hello World!'   # Required if default_message is brank
})

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     +81312345678                 # Required

  # Set defaults of making outbound call.
  # To call multiple phone at the same time, list them with comma like below.
  default_number  +819012345678,+818012345678  # Optional
  default_message "call from fluentd."         # Optional

  # Set log level to prevent info error
  @log_level       warn
</match>

Sample to customize messages

You can customize message using filter_record_transformer.

<source>
  @type http
  port 8888
  @label @NOTIFY
</source>

<label @NOTIFY>
  <filter>
    @type record_transformer
    <record>
      message Hi. ${record["name"]} has made a order of ${record["item"]} just now.
    </record>
  </filter>
  <match>
    @type twilio
    # snip ...
  </match>
</label>

Quick Test

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

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

Backend Service

Blog Articles

TODO

Pull requests are very welcome!!

Copyright

Copyright © 2013- Kentaro Yoshida (@yoshi_ken)

License

Apache License, Version 2.0