Everybody has their own favorite way to start the day. If music doesn’t happen to be your thing, then perhaps a hotel-style wakeup call will fit the bill. Once installed, you can dial *68 from any extension on your Asterisk® PBX and schedule a hotel-style wakeup call complete with snooze alarms. You also can designate extensions that can serve as administrators to schedule wakeup calls for any extension on your system. And, no, this won’t interfere with Nerd Vittles Telephone Reminder System when your requirements demand something a bit more flexible and robust.

Prerequisites. The latest module is specifically designed for integration into any current version of FreePBX® (works fine in 2.8, 2.9, and 2.10) so all of the FreePBX-based aggregations should work just fine so long as your favorite includes a fairly recent version of FreePBX. Your server also needs PHP5.

Installation. The installation process couldn’t be simpler. First, download the software from the new POSSA Repository to your Desktop. Our special thanks to Andrew Nagy and Lorne Gaetz for their tireless work on the PBX Open Source Software Alliance. Don’t decompress the archive! Now use a web browser to access FreePBX on your Asterisk PBX. Choose Tools, Module Admin, Upload Module. Now Browse to the hotelwakeup- file on your Desktop and click the Upload button. Now click local module administration, scroll down and click on Wake Up Calls and then the Install radio button. Now click Process, and complete the usual FreePBX install and reload process. It takes longer to explain it than it’ll take you to do it. Make certain that the PHP time zone is set correctly on your system, or the wakeup calls may arrive at unexpected times. HINT: Nothing beats a trial run!

Configuration. When you complete the install process, there will be a new option on your Tools menu bar in FreePBX called Wake Up Calls. Click on this option and decide whether you want to activate Operator mode to enable some extensions to schedule wakeups for every extension on your PBX. Then select the number of digits in your extensions, how long to ring when a wakeup call is placed, how long to wait to retry the call, and how many retry attempts to make. Now set the CallerID for the calls, and you’re finished. Click the Submit button and reload your Asterisk dialplan setup.

Trial Run. To make sure everything is working, you need to place a test call from both a regular extension and also an extension that you designated as an operator station if you chose to implement this. Just dial *68 and follow the prompts using 4-digit numbers for the desired wake up call times. Then wait for your wakeup call. Doesn’t get much easier than that. Enjoy!

Originally published: Wednesday, February 25, 2009.

Updated: Thursday, May 24, 2012.

Need help with Asterisk? Visit the NEW PBX in a Flash Forum.

whos.amung.us If you’re wondering what your fellow man is reading on Nerd Vittles these days, wonder no more. Visit our new whos.amung.us statistical web site and check out what’s happening. It’s a terrific resource both for us and for you.


Special Thanks to Our Generous Sponsors

FULL DISCLOSURE: 3CX, RentPBX, Amazon, Vitelity, DigitalOcean, Vultr and others provide financial support to Nerd Vittles and our open source projects through advertising or referral revenue. We’ve chosen these providers not the other way around. Our decisions were based upon their corporate reputation and the quality of their offerings and their pricing. Our technology recommendations are reached independently of financial considerations except in situations in which comparable products at comparable pricing are available from multiple sources. In this limited case, we support our sponsors because our sponsors support us.

Awesome Vitelity Special. Vitelity has generously offered a terrific discount for Nerd Vittles readers. You now can get an almost half-price DID from our special Vitelity sign-up link. If you’re seeking the best flexibility in choosing an area code and phone number plus the lowest entry level pricing plus high quality calls, then Vitelity is the hands-down winner. Vitelity provides Tier A DID inbound service in over 3,000 rate centers throughout the US and Canada. When you use our special link to sign up, Nerd Vittles gets a few shekels down the road to support our open source development efforts while you get an incredible signup deal as well. The going rate for Vitelity’s DID service is $7.95 a month which includes up to 4,000 incoming minutes on two simultaneous channels with terminations priced at 1.45¢ per minute. Not any more! For our users, here’s a deal you can’t (and shouldn’t) refuse! Sign up now, and you can purchase a Tier A DID with unlimited incoming calls and four simultaneous channels for just $3.99 a month. To check availability of local numbers and tiers of service from Vitelity, click here. NOTE: You can only use the Nerd Vittles sign-up link to order your DIDs, or you won’t get the special pricing! Vitelity’s rate is just 1.44¢ per minute for outbound calls in the U.S. There is a $35 prepay when you sign up. This covers future usage. Any balance is refundable if you decide to discontinue service with Vitelity.

​​3CX is a software PBX that’s easy to install & manage. It includes integrated softphones, WebRTC conferencing and essential add-ons out of the box, at no additional cost. Try the free edition at www.3cx.com. Better yet, download the PIAF5 ISO powered by 3CX. Free version includes support for 8 simultaneous calls with a SIP trunk.

  • Run on Premise or in the Cloud, on Windows and now on Linux
  • Softphones for iOS, Android, Win & Mac
  • Easy install, backup & restore, version upgrades
  • Automatically configures IP Phones, SIP Trunks & Gateways

  • RentPBX, a long-time partner and supporter of PIAF project, is offering generous discounts for Nerd Vittles readers. For all of your Incredible PBX hosting needs, sign up at www.RentPBX.com and use code NOGOTCHAS to get the special pricing. The code will lower the price to $14.99/month, originally $24.99/month. It’s less than 50¢/day.

    Some Recent Nerd Vittles Articles of Interest…

    Be Sociable, Share!


    This article has 5 comments

    1. Ward – Do you know if anymore work has been done on the wake up call project where you have to answer a math question to make sure you’re up? I got it working a while back but since I lost that system I can’t seem to find a working version.

    2. Note: PHP5 is needed. FreePBX works in PHP4 but this module does not, because of its use of class definitions introduced in PHP5.

      [WM: Thanks for the tip. We’ve all gotten spoiled with PBX in a Flash. 🙂 ]

    3. I just thought I would let you know that on our system the Caller ID on the wakeup calls was always showing as unknown/unknown. I believe this is because it wraps the Caller ID name in quotes. On every installation we’ve had, I have found that you cannot wrap a Caller ID name in quotes even when you are explicitly instructed to do so (such as when setting up the Outbound CID for an extension) – I don’t know why that is, but it’s been true for us going all the way back to our first Asterisk@Home installation. Maybe others have had a different experience, but for us things break if we put the Caller ID name in quotes, and work fine if we don’t.

      Anyway, I found that if I open up the /var/www/html/admin/modules/hotelwakeup/functions.inc.php file and edit the line (line 62 in my editor) that reads:

      $sql .= ", `wakeupcallerid`=’\"{$calleridtext}\" ‘";

      and change it to remove the two instances of \" so that it reads:

      $sql .= ", `wakeupcallerid`='{$calleridtext} ‘";

      That fixes the problem. Also I changed /var/www/html/admin/modules/hotelwakeup/page.hotelwakeup.php (line 118 in my editor) from:

      echo """\n";


      echo "\n";

      to remove the two instances of " so that the quotes don’t display on the configuration page, however that’s strictly a cosmetic change that doesn’t affect the operation of the program.

      I just thought I’d pass this along, in case anyone else is getting unknown/unknown for the Caller ID. It took me quite some time to figure out what the problem was, and then how to fix it.

    4. I’m still figuring out what’s the role of the program to my business. I’m just so curious to make use of it.

    5. Nice add on! I have it working in non-operator mode. I enable the operator mode, but I still don’t seem to be able to schedule a wakeup call for any other extension than the one I call on. I’m sure I’m missing something simple…

      Thanks J. for your caller Id fix too!