Skip to content

Conversation

@gsanchietti
Copy link
Member

@gsanchietti gsanchietti commented Dec 10, 2025

This pull request introduces optional integration with a Matrix server for NethVoice, allowing external authentication via Matrix, and updates several scripts and configuration files to support this feature. It also updates the NethCTI middleware image and service configuration, and improves environment variable handling for service restoration and container startup.

Matrix Integration Support:

  • Added new helper action set-matrix-server (with validation schema) to enable or disable NethVoice authentication endpoint on a Matrix instance, along with detailed documentation in README.md. This includes handling of new environment variables (NETHVOICE_MATRIX_UUID, NETHVOICE_MATRIX_BASE_URL) and instructions for configuration. [1] [2] [3]
  • Added script restore-module/73set_matrix_service to restore Matrix integration state during module restore, ensuring proper environment and configuration handling. [1] [2]

Authorization and Labeling:

  • Updated the container label to include Matrix admin authorization (matrix@any:matrixadm).

TODO before merge:

  • change CTI middleware image from discovery_chat to a correct release

Usage:

Update an existing installation:

api-cli run update-module --data '{"module_url":"ghcr.io/nethesis/nethvoice:matrix_integration","instances":["nethvoice1"], "force": true}'

Execute set-matrix-server:

api-cli run module/nethvoice1/set-matrix-server --data '{"module_uuid": "cf50b191-95d5-435b-bf34-0905bf7dba55"}'

Linked work

PRs for chat implementation:

New repository for chat implementation:

Issues:

@gsanchietti gsanchietti self-assigned this Dec 10, 2025
@github-actions
Copy link

github-actions bot commented Dec 10, 2025

ℹ️ Wizard API content change detected

Preview documentation

No structural change, nothing to display.

Powered by Bump.sh

@gsanchietti gsanchietti force-pushed the matrix_integration branch 6 times, most recently from 630c079 to 6234ccc Compare December 16, 2025 15:02
@gsanchietti gsanchietti changed the title feat(rest): add /testextauth endpoint Matrix integration Dec 16, 2025
@gsanchietti gsanchietti force-pushed the matrix_integration branch 3 times, most recently from 4c2962a to 6576a79 Compare December 16, 2025 16:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant