Cannot connect to Asterisk-based phone system

    Issue: Failed to connect to phone system

    There are two common reasons that an Asterisk connection fails:

    • We cannot reach the AMI on the port listed for the host specified.
    • We can reach the AMI but are not permitted to log in with the username and secret provided.


    Possible solutions

    Some common reasons we cannot reach your PBX AMI:

    • Your hostname or IP address is not entered correctly.
    • Your have a hardware or software firewall rule blocking traffic between our server and the port on your PBX. Be sure to enable inbound traffic to port 5038 on your Asterisk server from the IP addresses listed on your phone setup page.
    • Your system is using a port other than 5038. The AMI service runs on port 5038 by default. If your system is using a non-standard port, be sure to enter this under Advanced Options.
    Image


    Tips for troubleshooting

    If you are still having trouble, try adding an additional host to this list that is outside of your local network and connect to your PBX from that host with:

    telnet <your_PBX_IPAddress_Or_Hostname> 5038

    If this works, contact us. The issue may be on our end. If this does not work, you likely still have a firewall or network issue and our servers will not be able to connect either.To see whether our server is reaching the AMI on your PBX, you can capture traffic using this command and use Wireshark to analyze the data.

    tcpdump -i eth0 -nqtttt -s 0 -A ‘((src port 5038) or (dst port 5038))’


    Login permission not granted

    The instructions on your phone setup page indicate what permissions should be set for the user to be able to login via the AMI on your PBX. It could be that your username or secret is incorrect. After updating your PBX config file with the proper username, secret and permit lines you must reread the config files.

    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.