Sign in

Asterisk Integration Setup Guide

    Updated:
    1 min read

    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.

    • Determine the external IP address or hostname for your Asterisk server.
    • Make sure port 5038 on this server is accessible from the addresses listed below.
    • Copy the permit lines listed on your phone settings page into the manager.conf file on your Asterisk server.
    Image


    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.

    Image

    Image

    Image

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

    You can locate your organization ID here:

    Image

    [tenfold]

    html:
    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.

    Missing Something?

    Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.