Welcome to Adhearsion

You've got a fresh app and you're almost ready to get started. Firstly, you'll need to configure your VoIP platform:

Asterisk

Edit extensions.conf to include the following:

[your_context_name]
exten => _X.,1,AGI(agi:async)

[adhearsion-redirect]
exten => 1,1,AGI(agi:async)

and setup a user in manager.conf with read/write access to all.

FreeSWITCH

<extension name='Adhearsion'>
  <condition field="destination_number" expression="^10$">
    <action application='rayo'/>
  </condition>
</extension>

Voxeo PRISM

Install the rayo-server app into PRISM 11 and follow the configuration guide.

Configure your app

In config/adhearsion.rb you'll need to set the VoIP platform you're using, along with the correct credentials. You'll find example config there, so follow the comments.

Ready, set, go!

Start your new app with “ahn start”. You'll get a lovely console and should be presented with the SimonGame when you call in.

Running your app on heroku

In order to run an adhearsion application on Heroku, you must create the application on the 'cedar' stack (heroku apps:create --stack cedar) and re-scale your processes like so:

heroku ps:scale web=0
heroku ps:scale ahn=1

More detail is available in the deployment documentation.

Check out the Adhearsion website for more details of where to go from here.