Welcome!

Linux Authors: Esmeralda Swartz, Trevor Parsons, Sandi Mappic, Lori MacVittie, Marten Terpstra

Related Topics: Linux, Wireless

Linux: Article

Asterisk: Getting Connected

Part 2: A step-by-step guide

In December's column, we installed the Asterisk PBX and configured two IP phones as extensions. This month, we'll connect our PBX to the telephone network for incoming and outgoing calls and set up the Digital Receptionist to route our incoming calls.

Connecting Asterisk to the Telephone Network
Asterisk supports a myriad of ways to connect to the public telephone network. Asterisk provides standard technologies such as IAX (Inter-Asterisk-eXchange), SIP (Session Initiation Protocol), and PRI (with appropriate hardware). We'll be connecting with IAX because it's simple and widely supported by VoIP providers.

Choosing a VoIP Provider
We'll be using VoIP services provided by Blue Networks, Inc., because it offers the best mix of pricing, support, and connectivity. Blue Networks also has online sign-up and a no-nonsense free trial.

Head over to www.sellVoIP.net/ and click on "Free Trial." Blue Networks will send your username and password to the e-mail address you supplied during sign-up.

Your VoIP experience can be affected by many variables. Network latency and reliability issues between your Asterisk server and your provider's gateway are the most critical factors. Luckily, Blue Networks has multiple gateways and finding one with the least latency is simple.

To determine which gateway to use, log into your Asterisk@Home machine either from the console or with a secure shell. Once logged in, issue the following command:

[root@asterisk1 ~]# ping -qc5 miaiax1.sellVoIP.net

After a few seconds, you should see ping results similar to:

PING miaiax1.sellVoIP.net (69.25.180.232) 56(84) bytes of data.

--- miaiax1.sellVoIP.net ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 4004ms
rtt min/avg/max/mdev = 38.139/39.095/40.131/0.744 ms, pipe 2

Make a note of the average ping time. In this case, it's 39.095 milliseconds. Run the same ping for seaiax1.sellVoIP.net and nyiax1.sellVoIP.net, then log out. We'll use the server with the lowest average ping time. In my case, miaiax1.sellVoIP.net was the fastest to respond.

Let's configure Asterisk to connect to the fastest gateway and make a couple of test calls.

In AMP, click on Setup, then Trunks. Click on "Add IAX2 Trunk." We'll use the account number "12345" and the secret "mysecret" in this example. Replace these with the account number and secret you got in the e-mail from Blue Networks.

In the "Outgoing Settings" section, we'll add the following:

In Dial Rules, add:

Replace 919 with your local area code. Asterisk will automatically dial this area code whenever a number dialed doesn't include one.

At the bottom of the page, add the following to the "Registration" section:

Remember to replace "12345" and "mysecret" with the IAX username and secret from your sign-up e-mail. When complete, click on "Submit Changes."

Next, click on "Outbound Routing." Select the default route of "0 9_outside." In the section "Trunk Sequence" select the IAX2 route we added above, then click "Submit Changes" and click on the red warning to make your changes take effect, see below.

You should now be able to make phone calls! Remember, since your trial account has a 10-cent balance, your phone call will be limited to a few minutes. Also, always dial 9 and then the number.

To get a phone number (called a DID for "Direct Inward Dial"), you'll have to sign into the SellVoIP Portal (www.sellVoIP.net/portal/) and add funds to your account. You'll then click on "Add DID" and select the DID from the list. At the time of this writing, there are several dozen toll-free numbers available, as well as numbers in various area codes throughout the country. If your area code isn't available, request it in a support ticket.

Once you have a DID, configuring Asterisk to use it is quite simple.

Click on Trunks then click on the SellVoIP trunk we just added for outbound calls. In the section "Incoming Settings" enter your IAX username. In User Details, add the following:

Let's also set our outbound caller ID to this DID. Do this by putting the 10-digit number in the "Outbound Caller ID" field.

Click "Submit Changes," then click the red banner to make those changes take effect.

Configuring the Digital Receptionist
What use is a fancy PBX without being able to route calls? The Asterisk Management Portal (AMP) lets us route inbound calls to the Digital Receptionist, directly to an extension, to a ring group, or a call queue. It will also let us specify different options for "after hours" calls.

We'll configure the Digital Receptionist to handle our incoming calls. Before we record any prompts or greetings, we should take a few minutes to sketch out our requirements and user experience.

Our example company, Spatula City, has a receptionist who should always be reachable by dialing "0." There are only two extensions, so it isn't necessary to configure a company directory. We want the caller to be able to reach our Sales and Customer Service departments through the menu. Our main menu should sound something like:

"Welcome to Spatula City! If you know your party's extension, please enter it now. For the sales department, press one. For customer service, press two. For the operator, press zero."

In AMP, click on Digital Receptionist. The Receptionist will need to know your extension to record menu items.

AMP gives us the option to record our prompt over the phone or upload it as a WAV file. Let's record the prompt through the telephone by picking it up and dialing *77 and reading the welcome message above. You can dial *99 to listen to the recording and *77 again to re-record.

Once the recording is complete, we need to name and describe it:

After clicking Continue, AMP needs to know how many options there are on the menu we just recorded. Enter "3" here.

Spatula City is a small operation. It has a bookkeeper in the back at extension 200. She's also the operator. There's one person dedicated to sales and customer service at extension 201. Our call routing is simple:

Finally, we have to tell Asterisk to use this Digital Receptionist for incoming calls. In AMP, click on Incoming Calls. Spatula City wants the Digital Receptionist to handle incoming calls all the time, even when the store is closed. The easiest way to do this is to set the Digital Receptionist to "Spatula City Main" for regular hours and force regular hours as shown below.

Testing the Receptionist
Asterisk@Home can simulate an incoming call from any extension by dialing 7777. After dialing, you should hear the main menu presented by the Digital Receptionist.

More Stories By Stephen Misel

Stephen Misel has been developing Linux-based applications for over 10 years. He is the owner of Misel Consulting, LLC, a Voice-Over-IP consultancy.

Comments (1)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


@ThingsExpo Stories
Samsung VP Jacopo Lenzi, who headed the company's recent SmartThings acquisition under the auspices of Samsung's Open Innovaction Center (OIC), answered a few questions we had about the deal. This interview was in conjunction with our interview with SmartThings CEO Alex Hawkinson. IoT Journal: SmartThings was developed in an open, standards-agnostic platform, and will now be part of Samsung's Open Innovation Center. Can you elaborate on your commitment to keep the platform open? Jacopo Lenzi: Samsung recognizes that true, accelerated innovation cannot be driven from one source, but requires a...
SYS-CON Events announced today that Red Hat, the world's leading provider of open source solutions, will exhibit at Internet of @ThingsExpo, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Red Hat is the world's leading provider of open source software solutions, using a community-powered approach to reliable and high-performing cloud, Linux, middleware, storage and virtualization technologies. Red Hat also offers award-winning support, training, and consulting services. As the connective hub in a global network of enterprises, partners, a...
P2P RTC will impact the landscape of communications, shifting from traditional telephony style communications models to OTT (Over-The-Top) cloud assisted & PaaS (Platform as a Service) communication services. The P2P shift will impact many areas of our lives, from mobile communication, human interactive web services, RTC and telephony infrastructure, user federation, security and privacy implications, business costs, and scalability. In his session at Internet of @ThingsExpo, Robin Raymond, Chief Architect at Hookflash Inc., will walk through the shifting landscape of traditional telephone a...
SYS-CON Events announced today that Matrix.org has been named “Silver Sponsor” of Internet of @ThingsExpo, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Matrix is an ambitious new open standard for open, distributed, real-time communication over IP. It defines a new approach for interoperable Instant Messaging and VoIP based on pragmatic HTTP APIs and WebRTC, and provides open source reference implementations to showcase and bootstrap the new standard. Our focus is on simplicity, security, and supporting the fullest feature set.
BSQUARE is a global leader of embedded software solutions. We enable smart connected systems at the device level and beyond that millions use every day and provide actionable data solutions for the growing Internet of Things (IoT) market. We empower our world-class customers with our products, services and solutions to achieve innovation and success. For more information, visit www.bsquare.com.
How do APIs and IoT relate? The answer is not as simple as merely adding an API on top of a dumb device, but rather about understanding the architectural patterns for implementing an IoT fabric. There are typically two or three trends: Exposing the device to a management framework Exposing that management framework to a business centric logic • Exposing that business layer and data to end users. This last trend is the IoT stack, which involves a new shift in the separation of what stuff happens, where data lives and where the interface lies. For instance, it’s a mix of architectural style...
SYS-CON Events announced today that SOA Software, an API management leader, will exhibit at SYS-CON's 15th International Cloud Expo®, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. SOA Software is a leading provider of API Management and SOA Governance products that equip business to deliver APIs and SOA together to drive their company to meet its business strategy quickly and effectively. SOA Software’s technology helps businesses to accelerate their digital channels with APIs, drive partner adoption, monetize their assets, and achieve a...
From a software development perspective IoT is about programming "things," about connecting them with each other or integrating them with existing applications. In his session at @ThingsExpo, Yakov Fain, co-founder of Farata Systems and SuranceBay, will show you how small IoT-enabled devices from multiple manufacturers can be integrated into the workflow of an enterprise application. This is a practical demo of building a framework and components in HTML/Java/Mobile technologies to serve as a platform that can integrate new devices as they become available on the market.
SYS-CON Events announced today that Utimaco will exhibit at SYS-CON's 15th International Cloud Expo®, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Utimaco is a leading manufacturer of hardware based security solutions that provide the root of trust to keep cryptographic keys safe, secure critical digital infrastructures and protect high value data assets. Only Utimaco delivers a general-purpose hardware security module (HSM) as a customizable platform to easily integrate into existing software solutions, embed business logic and build s...
Connected devices are changing the way we go about our everyday life, from wearables to driverless cars, to smart grids and entire industries revolutionizing business opportunities through smart objects, capable of two-way communication. But what happens when objects are given an IP-address, and we rely on that connection, sometimes with our lives? How do we secure those vast data infrastructures and safe-keep the privacy of sensitive information? This session will outline how each and every connected device can uphold a core root of trust via a unique cryptographic signature – a “bir...
Internet of @ThingsExpo Silicon Valley announced on Thursday its first 12 all-star speakers and sessions for its upcoming event, which will take place November 4-6, 2014, at the Santa Clara Convention Center in California. @ThingsExpo, the first and largest IoT event in the world, debuted at the Javits Center in New York City in June 10-12, 2014 with over 6,000 delegates attending the conference. Among the first 12 announced world class speakers, IBM will present two highly popular IoT sessions, which will take place November 4-6, 2014 at the Santa Clara Convention Center in Santa Clara, Calif...
Almost everyone sees the potential of Internet of Things but how can businesses truly unlock that potential. The key will be in the ability to discover business insight in the midst of an ocean of Big Data generated from billions of embedded devices via Systems of Discover. Businesses will also need to ensure that they can sustain that insight by leveraging the cloud for global reach, scale and elasticity.
WebRTC defines no default signaling protocol, causing fragmentation between WebRTC silos. SIP and XMPP provide possibilities, but come with considerable complexity and are not designed for use in a web environment. In his session at Internet of @ThingsExpo, Matthew Hodgson, technical co-founder of the Matrix.org, will discuss how Matrix is a new non-profit Open Source Project that defines both a new HTTP-based standard for VoIP & IM signaling and provides reference implementations.

SUNNYVALE, Calif., Oct. 20, 2014 /PRNewswire/ -- Spansion Inc. (NYSE: CODE), a global leader in embedded systems, today added 96 new products to the Spansion® FM4 Family of flexible microcontrollers (MCUs). Based on the ARM® Cortex®-M4F core, the new MCUs boast a 200 MHz operating frequency and support a diverse set of on-chip peripherals for enhanced human machine interfaces (HMIs) and machine-to-machine (M2M) communications. The rich set of periphera...

SYS-CON Events announced today that Aria Systems, the recurring revenue expert, has been named "Bronze Sponsor" of SYS-CON's 15th International Cloud Expo®, which will take place on November 4-6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Aria Systems helps leading businesses connect their customers with the products and services they love. Industry leaders like Pitney Bowes, Experian, AAA NCNU, VMware, HootSuite and many others choose Aria to power their recurring revenue business and deliver exceptional experiences to their customers.
The Internet of Things (IoT) is going to require a new way of thinking and of developing software for speed, security and innovation. This requires IT leaders to balance business as usual while anticipating for the next market and technology trends. Cloud provides the right IT asset portfolio to help today’s IT leaders manage the old and prepare for the new. Today the cloud conversation is evolving from private and public to hybrid. This session will provide use cases and insights to reinforce the value of the network in helping organizations to maximize their company’s cloud experience.
The Internet of Things (IoT) is making everything it touches smarter – smart devices, smart cars and smart cities. And lucky us, we’re just beginning to reap the benefits as we work toward a networked society. However, this technology-driven innovation is impacting more than just individuals. The IoT has an environmental impact as well, which brings us to the theme of this month’s #IoTuesday Twitter chat. The ability to remove inefficiencies through connected objects is driving change throughout every sector, including waste management. BigBelly Solar, located just outside of Boston, is trans...
SYS-CON Events announced today that Matrix.org has been named “Silver Sponsor” of Internet of @ThingsExpo, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Matrix is an ambitious new open standard for open, distributed, real-time communication over IP. It defines a new approach for interoperable Instant Messaging and VoIP based on pragmatic HTTP APIs and WebRTC, and provides open source reference implementations to showcase and bootstrap the new standard. Our focus is on simplicity, security, and supporting the fullest feature set.
Predicted by Gartner to add $1.9 trillion to the global economy by 2020, the Internet of Everything (IoE) is based on the idea that devices, systems and services will connect in simple, transparent ways, enabling seamless interactions among devices across brands and sectors. As this vision unfolds, it is clear that no single company can accomplish the level of interoperability required to support the horizontal aspects of the IoE. The AllSeen Alliance, announced in December 2013, was formed with the goal to advance IoE adoption and innovation in the connected home, healthcare, education, aut...
SYS-CON Events announced today that Red Hat, the world's leading provider of open source solutions, will exhibit at Internet of @ThingsExpo, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Red Hat is the world's leading provider of open source software solutions, using a community-powered approach to reliable and high-performing cloud, Linux, middleware, storage and virtualization technologies. Red Hat also offers award-winning support, training, and consulting services. As the connective hub in a global network of enterprises, partners, a...