Knowledge Base
Troubleshooting
Common issues and their fixes.
3 answers · Part of 46 across the knowledge base
How do I troubleshoot iOS CallKit integration issues?
Common iOS CallKit issues fall into four areas: the app not showing the native call screen, VoIP push not waking the app, dual-app conflicts, and Bluetooth audio routing failures. The fastest first checks are to confirm the app calls reportNewIncomingCall the moment a PushKit notification arrives, that the VoIP push certificate is valid and actually delivering, and that you are testing on a real device rather than the Simulator. Each issue, its cause, and its fix are below.
What debugging tools are available in a mobile softphone SDK?
A mobile softphone SDK includes built-in debugging tools: SIP message tracing, packet capture, call quality metrics, registration logs, and audio diagnostics. Together they let you pinpoint where a VoIP call failed, whether the cause is SIP registration, NAT traversal, codec negotiation, network quality, or OS-level audio routing.
Why doesn't my SIP app ring in the background on Android?
Android background limits and OEM battery managers can stop persistent SIP registrations soon after the screen turns off, so background ringing needs push-based wake-up. For operators, the most reliable implementation is SIPIS, Acrobits' push infrastructure service operational since 2009, which uses a three-layer approach to achieve 99%+ call delivery rates.