Fix Errors and Common Problems

The line does not connect

Under Settings › Lines, verify the server, SIP username, password, connection type, and Line Enabled. The server must not contain sip:// or a path. Use Reconnect and check the network or VPN. Change technical options only when instructed by the provider.

The line stays offline after a network, VPN, or wake change

TelefonX attempts to restore registration automatically. If it remains offline, choose Phone › Reconnect Lines. If that does not help, open Settings › Data & Diagnostics and select Rebuild SIP Connections.

I cannot hear anything or the other party cannot hear me

Check Settings › Audio: microphone and playback are separate devices. Refresh the device list or apply the selection to the active call. Allow TelefonX under System Settings › Privacy & Security › Microphone. If call quality shows no incoming RTP packets, check firewall, NAT, VPN, and provider settings.

A saved audio device is disconnected

Connect the device or choose System Default or another device. During a call, use Reconnect Audio. The saved device name remains selected and appears as Disconnected (Saved Selection) until it becomes available.

Apple Contacts are missing

Enable Show Apple Contacts under Settings › General. If access was denied, use Open Privacy Settings … and allow contact access. Apple Contacts are read-only; copy one to TelefonX before editing it.

The “Call with TelefonX” macOS service is missing

Open System Settings › Keyboard › Keyboard Shortcuts … › Services and enable the TelefonX service. Not every app exposes Services in its context menu.

TelefonX does not open at login

Enable Open TelefonX at Login. If the app reports pending approval, click Open Login Items … and allow TelefonX under System Settings › General › Login Items.

Notifications or callback alerts do not appear

Check permission under Settings › Lines › Call and Callback Notifications. Callbacks require Pro. Verify that the individual callback’s Notification is not set to No Notification, and check active Focus modes.

A Pro feature is locked

Open TelefonX Pro … and check whether the subscription is shown as active. Use Restore Purchases if needed. Without Pro, only the first line is active; additional lines and Pro data remain saved. See TelefonX Pro for details.

A custom ringtone or hold-music file is missing

Custom audio is local and is not part of the JSON backup. Select the file again on this Mac. TelefonX uses the default ringtone when a custom ringtone is missing. Custom ringtones and hold music require Pro.

A backup cannot be restored

End active calls first. TelefonX accepts only a compatible and valid TelefonX JSON backup up to 100 MB. Restoring replaces the current local data. Passwords and audio files are not imported.

Which diagnostics can I share?

Under Settings › Data & Diagnostics, export anonymized diagnostics. It excludes passwords, phone numbers, contact names, and call content. Use Check Keychain when credential storage fails; the test does not access existing SIP passwords.

How do I get support?

For support with the free version, email [email protected]. If you use TelefonX Pro, you can alternatively contact us through the chat on the Enwikuna website. Have the Apple order number for your purchase or subscription ready.

Copy the following template into your request and provide the details relevant to your problem:

Subject: Support Request for TelefonX

TelefonX version:
macOS version:
Mac model:
Phone provider or phone system:

Description of the problem:
Steps to reproduce:
Expected behavior:
Actual behavior:
Solutions already attempted:

For connection or audio problems, you can also attach the anonymized diagnostics. Never send your SIP password or other credentials.