Skip to content
This repository has been archived by the owner on Jan 17, 2021. It is now read-only.
/ adhearsion-twilio Public archive

An Adheasion Plugin that provides an easy way to use Adhearsion with your existing apps built for Twilio

License

Notifications You must be signed in to change notification settings

somleng/adhearsion-twilio

Repository files navigation

adhearsion-twilio

Provides a simple way to use Adhearsion with your existing apps built for Twilio

CircleCI codecov

Installation

Add this line to your application's Gemfile:

gem 'adhearsion-twilio', :github => somleng/adhearsion-twilio.git

And then execute:

$ bundle

Configuration

Configure your voice_request_url and status_callback_url in config/adhearsion.rb or use the environment variables. These should be the same endpoints that you point to in your Twilio configuration and should return valid TwiML.

Adhearsion.config do |config|
  # Retrieve and execute the TwiML at this URL when a phone call is received [AHN_TWILIO_VOICE_REQUEST_URL]
  config.twilio.voice_request_url      = "http://localhost:3000/"

  # Retrieve and execute the TwiML using this http method [AHN_TWILIO_VOICE_REQUEST_METHOD]
  config.twilio.voice_request_method   = "post"

  # Make a request to this URL when a call to this phone number is completed. [AHN_TWILIO_STATUS_CALLBACK_URL]
  config.twilio.status_callback_url    = nil

  # Make a request to the status_callback_url using this method when a call to this phone number is completed. [AHN_TWILIO_STATUS_CALLBACK_METHOD]
  config.twilio.status_callback_method = nil

  # The default voice to use for a male speaker (see 'config.punchblock.default_voice' for allowed values) [AHN_TWILIO_DEFAULT_MALE_VOICE]
  config.twilio.default_male_voice     = nil

  # The default voice to use for a female speaker (see 'config.punchblock.default_voice' for allowed values) [AHN_TWILIO_DEFAULT_FEMALE_VOICE]
  config.twilio.default_female_voice   = nil
end

Usage

In your controller include Adhearsion::Twilio::ControllerMethods, answer the call and notify your voice app like this:

class CallController < Adhearsion::CallController
  include Adhearsion::Twilio::ControllerMethods

  def run
    notify_voice_request_url
  end
end

notify_voice_request_url will send a Twilio Request using the url you configured in voice_request_url then execute any TwiML you respond back with.

Documentation

Read through the specs. Each spec contains TwiML examples for each Verb Attribute and Noun along with the relevant documentation from Twilio.

Already Implemented

The following verbs have been already implemented:

Todo

The following verbs are not yet fully implemented:

  • SMS
  • Enqueue
  • Leave
  • Pause

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

The software is available as open source under the terms of the MIT License.

About

An Adheasion Plugin that provides an easy way to use Adhearsion with your existing apps built for Twilio

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages