Difference between revisions of "Jaiku By Telephone"
Line 1: | Line 1: | ||
− | + | This an [http://www.asterisk.org Asterisk] AGI script that uses [http://phpagi.sourceforge.net/ PHPAGI] and [[class.jaiku.php]] to allow you to update your [[Jaiku]] presence message from a regular land-line telephone. | |
+ | |||
+ | ==Source Code== | ||
+ | |||
+ | You can [http://websvn.reinvented.net/filedetails.php?repname=Jaiku&path=%2FJaikuPHP%2Fjaiku-agi.php&rev=0&sc=0 browse the source code] from a browser, or grab the latest version of the source code using Subversion at: | ||
+ | |||
+ | You can grab the latest version of the source code using Subversion at: | ||
+ | |||
+ | <code>svn://svn.reinvented.net/Jaiku/JaikuPHP/jaiku-agi.php</code> | ||
+ | |||
+ | or | ||
+ | |||
+ | <code>http://svn.reinvented.net/Jaiku/JaikuPHP/jaiku-agi.php</code> | ||
+ | |||
+ | ==Installation== | ||
+ | |||
+ | You need to having a working [http://www.asterisk.org Asterisk] installation to use this script at all. You also need to have [http://phpagi.sourceforge.net/ PHPAGI] installed in a location that your PHP can find. | ||
+ | |||
+ | Move the '''jaiku-agi.php''' script into your Asterisk AGI scripts directory (often /var/lib/asterisk/agi-bin) and make sure the permissions are set so that it's accessible by your Asterisk and that it's set to be executable. Modify the line: | ||
+ | |||
+ | <pre> | ||
+ | $j = new Jaiku("username","password",'screenname'); | ||
+ | </pre> | ||
+ | |||
+ | and replace with your own Jaiku.com username, password and screen name. | ||
+ | |||
+ | Finally, set up an Asterisk extension that calls the script. | ||
+ | |||
+ | If you're using FreePBX, you can: | ||
+ | |||
+ | # Navigate to Setup | Ring Groups. | ||
+ | # Create a new Ring Group called "Jaiku Presence Update." | ||
+ | # Enter an invalid extension in the "extension list" -- something like "XXX". | ||
+ | # Set the ring time to 1. | ||
+ | # Under Destination, select Custom App, and enter '''custom-jaiku,s,1''' | ||
+ | # In /etc/asterisk/extensions_custom.conf, enter: | ||
+ | |||
+ | <pre> | ||
+ | [custom-jaiku] | ||
+ | exten => s,1,agi(jaiku-agi.php) | ||
+ | </pre> | ||
+ | |||
+ | If all goes according to plan, you should be able to pick up a handset, dial the number for the Ring Group you created, and the script should answer. | ||
+ | |||
+ | ==Text Entry== | ||
+ | |||
+ | When you're prompted to enter a new Jaiku status message, you must use the [http://www.voip-info.org/wiki-Asterisk+cmd+DTMFToText text input method described here]. This is '''not''' the same text input method you'll be used to if you use a mobile phone to compose text messages, but it's similar. The basic idea is that you enter each letter followed by a '''*''' press. Enter '''0*''' for space and '''#''' to finish. | ||
+ | |||
+ | ==Here It In Action== | ||
+ | |||
+ | [http://ruk.ca/article/3993 This weblog post] contains a link to [http://ruk.ca/enclosures/jaiku-by-phone.mp3 this MP3 file] that is a recording of a telephone call illustrating use of the script. | ||
+ | |||
+ | ==Known Issues== | ||
+ | |||
+ | The confirmation menu doesn't allow options to be selected while it's being read. This is an easy thing to change, but I haven't yet. | ||
+ | |||
+ | It's assumed that the Jaiku update worked properly -- no errors are reported. | ||
+ | |||
+ | ==Release Notes== | ||
+ | |||
+ | 2006-12-24 - v0.1 - Initial release. |
Latest revision as of 14:17, 24 December 2006
This an Asterisk AGI script that uses PHPAGI and class.jaiku.php to allow you to update your Jaiku presence message from a regular land-line telephone.
Contents
Source Code
You can browse the source code from a browser, or grab the latest version of the source code using Subversion at:
You can grab the latest version of the source code using Subversion at:
svn://svn.reinvented.net/Jaiku/JaikuPHP/jaiku-agi.php
or
http://svn.reinvented.net/Jaiku/JaikuPHP/jaiku-agi.php
Installation
You need to having a working Asterisk installation to use this script at all. You also need to have PHPAGI installed in a location that your PHP can find.
Move the jaiku-agi.php script into your Asterisk AGI scripts directory (often /var/lib/asterisk/agi-bin) and make sure the permissions are set so that it's accessible by your Asterisk and that it's set to be executable. Modify the line:
$j = new Jaiku("username","password",'screenname');
and replace with your own Jaiku.com username, password and screen name.
Finally, set up an Asterisk extension that calls the script.
If you're using FreePBX, you can:
- Navigate to Setup | Ring Groups.
- Create a new Ring Group called "Jaiku Presence Update."
- Enter an invalid extension in the "extension list" -- something like "XXX".
- Set the ring time to 1.
- Under Destination, select Custom App, and enter custom-jaiku,s,1
- In /etc/asterisk/extensions_custom.conf, enter:
[custom-jaiku] exten => s,1,agi(jaiku-agi.php)
If all goes according to plan, you should be able to pick up a handset, dial the number for the Ring Group you created, and the script should answer.
Text Entry
When you're prompted to enter a new Jaiku status message, you must use the text input method described here. This is not the same text input method you'll be used to if you use a mobile phone to compose text messages, but it's similar. The basic idea is that you enter each letter followed by a * press. Enter 0* for space and # to finish.
Here It In Action
This weblog post contains a link to this MP3 file that is a recording of a telephone call illustrating use of the script.
Known Issues
The confirmation menu doesn't allow options to be selected while it's being read. This is an easy thing to change, but I haven't yet.
It's assumed that the Jaiku update worked properly -- no errors are reported.
Release Notes
2006-12-24 - v0.1 - Initial release.