1. Support
  2. Mobile Application

Mobile App Troubleshooting Guide

How to debug issues with the mango mobile application

Mobile Layers (Bottom Up)

Layer Problems

Media (Tier 2)

Call Actions (XFER, Mute, Hold, Park, DTMF)
Audio Source (Speaker / Bluetooth)

SIP (Tier 2)

Verify Send or Receive Invite
Verify Registration

Network (Tier 2)

Router Configuration (Always TCP)
Cellular or WiFi
Use Diagnostics Screen

Mango Configuration (Tier 1)

Trace Call flow to mobile app
Remove XFER to cell (Start Up)
Disable Outdial Extension

Extension Enabled for Mobile

Application (Tier 1) App DND Disabled
Setup User / Extension
Latest App Version
Operating System (Tier 1)

iOS (Focus Mode in iOS 15)
Latest OS

Device (Tier 1)

Supported Device (iPad, old iPhone)

Problem: I don't see my faxes

Solution: We don't support faxes on the mobile app, but you can see them in the web app by visiting app.mangovoice.com

Problem: I can't login to the mobile app

Solution: Make sure the line extension has the mobile app enabled. Confirm customer can login to the app.

Problem: No Call History, or Call History is not accurate

  • Potential Solution: Are they bypassing the mobile app routing the call to the cellular network with an external transfer?
    • Check the switchboard to determine if the mobile app is being bypassed, make the switchboard changes, do a test call, have them verify that the call history shows the call. 
  • Potential Solution: The call history does NOT represent all of the calls across the PBX, it only shows the calls for the extension they are currently logged in with. They can view their whole call log in the admin portal. 
    • Have the customer make an internal call from the mango app to a different extension. Don't have them do an outbound call to the same cell phone since this will create a confusing experience. Confirm you see a call history entry. 

Outbound calls made from the softphone, yealink, etc won't show up on the mobile app because it wasn't the source or destination of the call. This works the same way as the yealink device, if you make a call from the softphone, you won't see it in your yealink call history. If the user deletes the app, the call history is removed. 

Problem: No Voicemails, not seeing shared voicemails

  • Potential Solution: The voicemail list in the mobile app does NOT include support shared voicemails, it only shows the voicemails for the extension that is currently logged in. The customer can access their shared voicemail by dialing *98, putting in their voicemail extension and password.
    • Have the customer open their mobile app, go to the dialpad, type in *98, make a call, listen to voicemails, hangup call. Ask customer if they would like shared voicemails to be forwarded to an email. 
  • Potential Solution: Make sure the user is logged in to the correct extension. 
    • Review the switchboard to see where voicemails are being left. If they are storing all their voicemails on x101 and the user is logged in on the app as x104, they won't be able to see it. They will need to login into x101 to see the voicemails or setup a shared voicemail and access them via *98
  • Potential Solution: The current extension that is logged in doesn't have a voicemail enabled.
    • Review the customers switchboard, to see if they Have the customer go to settings, ask them the extension name that shows up, go to that extension in the admin, see if voicemail is enabled.

Problem: Outbound Calling (Tier 2)

  1. What device is being used? Confirm OS and Device
  2. What version of the app? Confirm on App Login or Settings screen. View in Registration. Have them send a support email. 
  3. Does the app have the necessary permissions? Confirm by opening the app
  4. Which network is having the issue? Cellular, WiFi or Both?
  5. Can the app REGISTER?
    1. In Admin, open the customers PBX > Diagnostics (+) > Registrations and see if they are able to get a SIP Registration. Make sure you verify the expiration timer
    2. Find their IP address on Registrations and put it into ipinfo.io to see their network details. 
       curl ipinfo.io/
    3. Some carriers or routers will block port 5060. If you can register that likely means that SIP is allowed but might not mean you can send an INVITE through their network.
  6. Can the app send an INVITE?
    1. Look more carefully at the ISP / Network
    2. Switch over to Cellular and try to REGISTER and INVITE, this isolates that the INVITEs are being blocked on WiFi network. 

Problem: Inbound Calls (Tier 2)

  1. What device is being used? Confirm OS and Device.
  2. In iOS 15 and up, users can be in a focus mode. Focus mode will prevent calls from coming in. Make sure the Mango app is allowed during the focus mode.
  3. Does the app have the necessary permissions? Microphone & Push are required.
  4. What version of the app? Confirm on App Login or Settings screen. View in Registration. Have them send a support email. 
  5. Make sure the phone is not in Mango DND mode. Confirm the customer does not see a banner. Confirm with "Contact Support" email. If you toggle this and it fixes the issue submit a bug to development. (This means DND is out of sync)
  6. Trace call flow to mobile app. Example: Confirm phone number goes to switchboard, follows path to extension that customer is logged in as. (Example: user is logged in as 102, and switchboard points to 101). 
    1. Is there an external transfer setup in the switchboard? This will route around the mobile app to the cell phone. This is very common for Startups.
  7. Make a test call to verify registration on Admin > Diagnostics > Registration
    1. If call rings but no registration occurs then push wasn't sent or it's delayed.
      1. If the voice system sends a push notification that is 10+ seconds late, the push will not be delivered and the development team will be alerted.
      2. Work with dev team to monitor the logs to verify pushes are being sent
  8. Registration was successful but no call is being received?
    1. If the call is going into a ring group, there is a chance that someone else is answering the call before the mobile app gets the push. (This would essential create a infinite ringing, but should be cleaned up after 10 seconds if it doesn't find a call)
    2. Involve the voice team if you can't figure out things from here
  9. Call doesn't connect audio
    1. View SIP Capture to review SDP, Codecs, SIP Error Code
    2. What audio source are they using (Airpods, bluetooth, etc.)


Can I use this application on my iPad?

We do not officially support the iPad. Please let us know more about why you would like to use it on the iPad

Can I put it on multiple devices?

You can only have one extension active on one device, identified by its phone number, at a time. If you log in and select the same extension on device 1 and then log in to the app on device 2, the app on device 1 will not be able to receive calls or perform other actions.