[cvs] [Wiki] changed: Project/Astral

[Wiki Guest]

guest [62.3.238.34]  Wed, 25 Feb 2009 15:03:48 -0500

Modified page: http://wiki.horde.org/Project/Astral
New Revision:  1.2
Change log:  Added API description and number-with-extension bug

@@ -5,9 +5,9 @@
  Astral is a telephone dialler module for use with the  
[http://www.asterisk.org Asterisk] PBX. Astral provides the  
telephony/dial service, making it possible to dial directly from phone  
numbers listed in your Turba address book, or anywhere else where  
Horde Form elements of the type 'phone' or 'cellphone' are used.

  ++ Bugs

-Astral is so new we haven't had time to find any yet!
+Astral can not cope with being passed numbers which include an  
extension number, eg "01234 56789 ext 654"

  ++ People

  Astral is being developed by Chris Hastie: chris at raggedstaff dot net
@@ -18,8 +18,19 @@

  Astral is primarily useful in a corporate context where telephony is  
provided by Asterisk and all Horde users have access to the same  
Asterisk server.

  Astral has no displayable pages. It attempts to set up the call,  
pushes a message about the response to the $notification object then  
redirects to the calling page.
+
++++ API
+
+Astral provides a single api call, dial, through the function  
_astral_dial. This is intended to provide the telephony/dial service.
+
+_astral_dial expects a phone number as argument. It returns a URL.  
The URL can be used to form a click-to-dial link.
+
+The phone number is cleaned before incorporating in the URL  
(QUESTION: should we include the raw number in the URL and clean it in  
the page called?). The following transformations are performed on the  
number:
+
+* A leading '+' is replaced with the configured international  
dialling prefix (a configuration parameter of Astral).
+* All remaining characters other than 0-9,#,* are removed.

  ++ Resources

  [http://www.voip-info.org/wiki-Asterisk+manager+API Asterisk Manager API]