Skip to content

Fix Errors and Common Problems

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

Section titled “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

Section titled “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.

For a UDP line behind NAT, Use Registration Address for Audio may help. See Technical options for requirements and setup.

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.

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

Section titled “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.

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

Section titled “Notifications or callback alerts do not appear”

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

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

Section titled “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.

End active calls first and disable Synchronize Phone Books under Settings › iCloud. 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.

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.

The FRITZ!Box or elunos.ai badge is missing

Section titled “The FRITZ!Box or elunos.ai badge is missing”

Both integrations require active TelefonX Pro and a separate setup for the line currently selected for calling. Check that the integration is enabled and credentials are saved. FRITZ!Box also needs a selected rule. Elunos.ai needs a selected agent. The line selected in integration settings can differ from the outgoing line. See FRITZ!Box Integration and elunos.ai Integration for setup.

Test saved credentials under Settings › FRITZ!Box. Check application access, the FRITZ!Box user’s phone permissions, and the selected rule. An unconfirmed status does not mean call forwarding is off. The guide explains FRITZ!Box status displays and test calls.

Does disabling the FRITZ!Box integration stop call forwarding?

Section titled “Does disabling the FRITZ!Box integration stop call forwarding?”

The selected rule on your FRITZ!Box stays unchanged. Turn the rule off while its status is confirmed, or change it directly on your FRITZ!Box. See Disable the integration and Pro expiration for details.

The elunos.ai status is unavailable or publication is pending

Section titled “The elunos.ai status is unavailable or publication is pending”

Test the saved key under Settings › elunos.ai. Check the workspace, API permissions, and the selected agent’s publication state. Review and reselect any path that is missing after an external change. An unconfirmed status does not mean the AI assistant is off. The guide explains elunos.ai status displays and test calls.

Does disabling the elunos.ai integration change the call path?

Section titled “Does disabling the elunos.ai integration change the call path?”

The last published route stays unchanged. To forward calls to your phone, switch to Phone mode and wait for confirmation before disabling the integration, or change the call path directly in elunos.ai. See Disable the integration and Pro expiration for details.

Under Settings › MCP, check that Enable MCP is on and the server is shown as active. TelefonX must be running on the same Mac. Use the displayed address with Streamable HTTP and the header Authorization: Bearer <access key>. If the port is in use, choose another one and update the address in the assistant. The local address cannot be reached by cloud-only connections.

The MCP assistant cannot perform an action

Section titled “The MCP assistant cannot perform an action”

Check Read and Write permissions under Authorized Clients › Edit …. Pro features also require an active subscription through MCP. Recording consent requires a client that supports MCP form elicitation. To replace a lost access key, remove the client and create it again.

Call history, settings, callbacks, and recordings are stored on this Mac. Credentials are stored in the macOS Keychain. Your own phone books and private favorites sync through iCloud when enabled. Shared contacts are available to invited participants. Recordings are sent to OpenAI only after you authorize manual or automatic processing. When MCP is enabled, authorized assistants can read shared data, including saved transcripts and summaries. Their providers may process this data. See Local Data, Backups, and Diagnostics for storage and exports.

With Pro, you can record connected calls and local conferences. Inform every participant and obtain consent, including anyone who joins later. Manual recording requires confirmation before starting. Automatic recording is off by default and requires separate activation. See Record Calls and Manage Recordings for playback, summaries, and exports.

Phone books organize your contacts into independent collections. Existing contact groups are migrated automatically. Your own books and private favorites sync between Macs using the same Apple Account. Synchronization is enabled by default and does not require Pro. You can disable it under Settings › iCloud.

Sharing your own books and inviting other Apple Accounts requires Pro. Accepting invitations and participating in received books does not. Read Only and Can Edit determine what participants can change. See Manage and Share Phone Books for invitations and permissions.

Under Settings › iCloud, check the signed-in account, Synchronize Phone Books, and any error message. Use Synchronize Now after restoring the connection. For conflicting changes, open Review Changes … and select the values to keep.

For a recording, check Pro access, a connected call, and available storage. For a summary, test the saved API key under Settings › Recordings and review the error message. Check that you authorized the transfer. A new processing request can incur additional OpenAI charges. Saved audio can be exported separately.

Unavailable list sections are hidden while the local data store cannot be opened. Use the diagnostics offered in the error view and keep the exported file for support. Restart TelefonX and report the error if it persists.

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.