Skip to main content

Asterisk Integration Setup Guide

Overview: This article covers the supported versions of Asterisk, as well as Quick setup instructions, Tenfold Integration details, access requirements, and authentication instructions.

Supported versions

Asterisk 11 or older

Quick instructions (scroll down for detailed instructions)

Check the setup wizard and dashboard for the most up-to-date instructions. Or open a new support ticket.

  1. Determine the external IP address or hostname for your Asterisk server.

  2. Make sure port 5038 on this server is accessible from the addresses listed below.

  3. Copy the permit lines listed on your phone settings page into the manager.conf file on your Asterisk server.

    asterisk-tenfold-1-1024x632.png

Asterisk + Tenfold integration details

Tenfold gathers Asterisk phone events through the Asterisk Management Interface (AMI). This integration requires that you allow Tenfold to access and authenticate through this interface.

Access

The standard AMI port is 5038, though yours may vary.

If your server is behind a firewall, you will need to open this port to the following addresses: 54.235.107.161, 54.221.236.255, & 54.197.230.20.

Authentication

To receive event notifications, needs to authenticate with Asterisk through the AMI port. After providing access as described above, make sure to allow for this login.

Screenshots below are for PBXinaFlash. Each Asterisk distro varies slightly where the Config Edit Menu option is, but the process is essentially the same. When in doubt, Google “Asterisk Management Interface” + your distro name.

asterisk-tenfold-2.png
asterisk-tenfold-3.png
asterisk-tenfold-4.png

Your permit lines should look like the below where you replace xxxxxxxxxxxxxxxxxxxxx with your organization ID.

You can locate your organization ID here:

123456789.png

[tenfold]

secret=xxxxxxxxxxxxxxxxxxxxxxxx
deny=0.0.0.0/0.0.0.0
permit=54.235.107.161/255.255.255.255
permit=54.221.236.255/255.255.255.255
permit=54.197.230.20/255.255.255.255
read=all
write=originate,system,call

Additional notes

  • You can set your secret to anything that you would like. Be sure to specify this both in the permit lines added to your Asterisk manager.conf file as well as in the Tenfold Admin Phone System Config Tab.

  • It is preferable that you use Queues rather than Ring Groups in Asterisk.

  • If you need help with a multi-tenant Asterisk server, read this article.

Confused? Need additional Support? Click HERE

In this section: