Skip to content

NethVoice: Fanvil/NethPhone "Headset not connected" warning on phones without a headset since Auto Headset is enabled by default #8307

New issue
New issue
Closed
Bug
Closed
NethVoice: Fanvil/NethPhone "Headset not connected" warning on phones without a headset since Auto Headset is enabled by default#8307
Bug
Labels
nethvoiceBug or features releted to the NethVoice project
Milestone
NethVoice 1.8

Description

@andrea-marchionni
andrea-marchionni
opened on Nov 11, 2026

Description

nethesis/tancredi#400 hardcoded P1 Auto Headset :1 in the fanvil-X5, fanvil-V67 and nethesis templates, so every Fanvil and NethPhone model using those templates now answers incoming calls through the headset.

On phones with no headset connected, answering a call shows a "Headset not connected!" warning popup on the display. Most desks have no headset, so most users now see this warning on every answered call.

Steps to reproduce

  1. Provision a NethPhone (e.g. NP-X5) or a Fanvil X5/V67 with a Tancredi version that includes #400.
  2. Leave no headset connected.
  3. Answer an incoming call.

Expected: the call is answered normally, with no warning.
Actual: the ""Headset not connected!" popup appears.

Proposed solution

Make the parameter configurable and keep it off unless a headset is present:

  • Tancredi: replace the hardcoded value with an auto_headset scope variable, defaulting to 0. Missing or invalid values also fall back to 0, so existing installations return to the behavior from before #400 without a migration.
  • NethVoice UI (nethvoice-wizard-ui): add an "Answer with the headset when connected" setting in the Preferences section of model and phone settings. Show it only for Fanvil and NethPhone models whose template supports it (fanvil-X5, fanvil-V67, nethesis), so administrators can enable it per model or per phone only where a headset is actually used.

Activity

  1. andrea-marchionni
    added the
    Bug
    issue type on Nov 11, 2026
  2. andrea-marchionni
    added
    nethvoiceBug or features releted to the NethVoice project
    on Nov 11, 2026
  3. github-project-automation
    added this to NethVoiceon Nov 11, 2026
  4. github-project-automation
    moved this to Todo in NethVoiceon Nov 11, 2026
  5. andrea-marchionni
    added this to the NethVoice 1.8 milestone on Nov 11, 2026
  6. edospadoni
    assigned
    andrea-marchionni
    on Nov 11, 2026
  7. edospadoni
    moved this from Todo to In Progress in NethVoiceon Nov 11, 2026
  8. edospadoni
    added a commit that references this issue on Nov 11, 2026

    feat(templates): Make Fanvil Auto Headset configurable (#404)

    f3786f6

  9. edospadoni commented on Nov 11, 2026

    @edospadoni
    edospadoni
    on Nov 11, 2026
    Member

    Test

    PRs: nethesis/tancredi#404 (released in Tancredi 1.11.3), nethesis/ns8-nethvoice#1195

    Setup: a NethPhone (e.g. NP-X5) or a Fanvil X5/V67-family phone provisioned by NethVoice, with no headset connected; a second phone, or the same one, with a headset for the enabled case. After each change, reprovision the phone (or reboot it) and check P1 Auto Headset in the configuration the phone downloads (or the "Auto Headset" option of line 1 in the phone web UI).

    Test Case 1 - Default after the update (bug fix)

    • On an installation upgraded from a build with Tancredi 1.11.2, reprovision a NethPhone/Fanvil without a headset: P1 Auto Headset is 0
    • Answering an incoming call shows no "Headset not connected!" warning and the call is answered normally
    • A phone added after the update also gets P1 Auto Headset :0

    Test Case 2 - Enable per model and per phone

    • In Models, open a Fanvil X5/V67-family or NethPhone model: Preferences shows "Answer with the headset when connected"
    • Set it to Enabled on the model and reprovision: the model's phones get P1 Auto Headset :1, and with a headset connected an incoming call is answered through the headset
    • Override it to Disabled on a single phone (Configurations > phone settings): only that phone gets 0
    • Set the selector back to "-" on the phone and on the model: the phone inherits again and returns to 0

    Test Case 3 - Regression on other models

    • The setting is not shown for Fanvil X3/X4/H2/H5/X3SG-PRO (legacy fanvil-X3 template), Yealink, Snom, Gigaset, Akuvox, Sangoma, nor in the global defaults
    • Other Preferences settings (NTP, provisioning schedule, line keys transfer mode, etc.) still save and provision as before

    Testing image: PR build of nethesis/ns8-nethvoice#1195 (Tancredi 1.11.3)

    ghcr.io/nethesis/nethvoice:pr-1195.1686-1.a69e693

    Update command (replace nethvoiceX with the NethVoice instance):

    api-cli run update-module --data '{"module_url":"ghcr.io/nethesis/nethvoice:pr-1195.1686-1.a69e693","instances":["nethvoiceX"],"force":true}'
  10. edospadoni
    added
    testingPackages are available from testing repositories
    on Nov 11, 2026
  11. nethbot
    moved this from In Progress to Testing in NethVoiceon Nov 11, 2026
  12. andrea-marchionni
    removed their assignment
    on Nov 11, 2026
  13. andrea-marchionni
    added
    verifiedAll test cases were verified successfully
    on Nov 11, 2026
  14. github-actions
    removed
    testingPackages are available from testing repositories
    on Nov 11, 2026
  15. nethbot
    moved this from Testing to Verified in NethVoiceon Nov 11, 2026
  16. edospadoni
    added a commit that references this issue on Nov 11, 2026

    fix(provisioning): Make Fanvil/NethPhone Auto Headset configurable (#…

    2304e24

  17. edospadoni commented on Nov 11, 2026

    @edospadoni
    edospadoni
    on Nov 11, 2026
    Member

    Testing release: 1.8.2-testing.3 (nethesis/ns8-nethvoice#1195, nethesis/tancredi#404 via Tancredi 1.11.3)

    ghcr.io/nethesis/nethvoice:1.8.2-testing.3

    Update command (replace nethvoiceX with the NethVoice instance):

    api-cli run update-module --data '{"module_url":"ghcr.io/nethesis/nethvoice:1.8.2-testing.3","instances":["nethvoiceX"],"force":true}'
  18. edospadoni
    added
    testingPackages are available from testing repositories
    on Nov 11, 2026
  19. github-actions
    removed
    verifiedAll test cases were verified successfully
    on Nov 11, 2026
  20. nethbot
    moved this from Verified to Testing in NethVoiceon Nov 11, 2026
  21. edospadoni
    assigned
    andrea-marchionni
    on Nov 12, 2026
  22. andrea-marchionni
    added
    verifiedAll test cases were verified successfully
    on Nov 12, 2026
  23. andrea-marchionni
    removed their assignment
    on Nov 12, 2026
  24. github-actions
    removed
    testingPackages are available from testing repositories
    on Nov 12, 2026
  25. nethbot
    moved this from Testing to Verified in NethVoiceon Nov 12, 2026

  26. Stell0 commented on Nov 12, 2026

    @Stell0
    Stell0
    on Nov 12, 2026

    Release nethesis/ns8-nethvoice 1.8.2

  27. Stell0
    closed this as completedon Nov 12, 2026
  28. Stell0
    removed
    verifiedAll test cases were verified successfully
    on Nov 12, 2026
  29. github-project-automation
    moved this from Verified to Done in NethVoiceon Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    nethvoiceBug or features releted to the NethVoice project

    Type

    Bug

    Projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions