Merge pull request #26 from NethServer/audio-switch

Add ringtone selection

Author: andrea-marchionni

docs/user-manual/nethcti/other.md

@@ -258,13 +258,25 @@ Customize your NethVoice CTI by accessing Settings:
 
 - **Devices**: Control your phones and their status
 - **Mobile App**: Generate QR code to connect your [smartphone](https://docs.nethvoice.it/it/latest/app_manual.html) (subject to specific permissions)
+- **Incoming calls**: Control how your application behaves when receiving external calls. This includes choosing your ringtone, selecting where the sound plays, and configuring optional automatic URL actions triggered by incoming calls.
 - **Customer Card**: Configure how the customer card behaves (subject to specific permissions)
 - **Queues**: Decide how to automate your queue access (subject to specific permissions)
 - **Profile Picture**: Modify your avatar
 - **Theme**: Choose light or dark theme based on your preferences
 - **Integrations**: Integrate your Phone Island with external tools
 - **Cache**: Clearing browser cache can help resolve some page loading issues
 
+#### Incoming calls {#incoming-calls}
+The Incoming Calls settings allow you to configure how the system handles external calls, including ringtone behavior, audio output, and automated URL actions:
+
+1. Ringtone Settings: Choose the sound that plays when an incoming call is received.
+2. Ringtone Output Device: Select which audio device will play the ringtone.
+3. Parameterized URL: You can configure the system to automatically open a URL whenever an external call comes in. This is useful for CRM lookups, customer information pages, or internal tools.
+4. URL Opened on External Incoming Call: The URL is configured by system administrator.
+5. Pop-Up Permissions: Your browser must allow pop-ups for this feature to work.
+6. URL Opening Trigger: Choose when the configured URL should be opened.
+
+
 ## Supported Browsers {#supported-browsers}
 
 Currently supported browsers are:

docs/user-manual/nethlink/configuration.md

@@ -26,6 +26,15 @@ To ensure optimal call quality:
 3. Run the audio test to verify the configuration
 4. Adjust volume levels as needed
 
+
+## Incoming Calls {#incoming-calls-configuration}
+
+![Nethlinkaudio](/img/nethlink/nethlink_ringtone.png)
+
+1. Choose the sound that plays when an incoming call is received.
+2. Select which audio device will play the ringtone.
+
+
 ## Keyboard Shortcut Configuration {#keyboard-shortcut-configuration}
 
 ![Nethlinkshortcut](/img/nethlink/nethlink_scorciatoia.png)

i18n/it/docusaurus-plugin-content-docs/current/user-manual/nethcti/other.md

@@ -258,16 +258,27 @@ Personalizza il tuo NethVoice CTI accedendo alle Impostazioni:
 
 - **Dispositivi**: Controlla i tuoi telefoni e il loro stato
 - **App Mobile**: Genera il codice QR per collegare il tuo [smartphone](https://docs.nethvoice.it/it/latest/app_manual.html) (soggetto a autorizzazioni specifiche)
+- **Chiamate in entrata**: Controlla come si comporta l'applicazione quando riceve chiamate esterne. Questo include la scelta della suoneria, la selezione del dispositivo di riproduzione audio e la configurazione di azioni URL automatiche opzionali attivate dalle chiamate in entrata.
 - **Scheda Cliente**: Configura il comportamento della scheda cliente (soggetto a autorizzazioni specifiche)
 - **Code**: Decidi come automatizzare l'accesso alle tue code (soggetto a autorizzazioni specifiche)
 - **Immagine Profilo**: Modifica il tuo avatar
 - **Tema**: Scegli il tema chiaro o scuro in base alle tue preferenze
 - **Integrazioni**: Integra la tua Phone Island con strumenti esterni
 - **Cache**: Svuotare la cache del browser può aiutare a risolvere alcuni problemi di caricamento della pagina
 
+#### Chiamate in entrata {#chiamate-in-entrata}
+Le impostazioni delle chiamate in entrata consentono di configurare come il sistema gestisce le chiamate esterne, inclusi il comportamento della suoneria, l'uscita audio e le azioni URL automatizzate:
+
+1. Impostazioni suoneria: Scegli il suono che viene riprodotto quando si riceve una chiamata in entrata.
+2. Dispositivo di uscita suoneria: Seleziona quale dispositivo audio riprodurrà la suoneria.
+3. URL parametrizzato: È possibile configurare il sistema per aprire automaticamente un URL ogni volta che arriva una chiamata esterna. Questo è utile per ricerche nel CRM, pagine di informazioni sui clienti o strumenti interni.
+4. URL aperto su chiamata in entrata esterna: L'URL viene configurato dall'amministratore di sistema.
+5. Permessi per i pop-up: Il browser deve consentire i pop-up affinché questa funzionalità funzioni.
+6. Attivazione apertura URL: Scegli quando deve essere aperto l'URL configurato.
+
 ## Browser Supportati
 
 I browser attualmente supportati sono:
 - Google Chrome - Versione 121.0.6167.189 e successive
 - Mozilla Firefox - Versione 123.0 e successive
-- Microsoft Edge - Versione 122.0.2365.59 e successive
+- Microsoft Edge - Versione 122.0.2365.59 e successive

i18n/it/docusaurus-plugin-content-docs/current/user-manual/nethlink/configuration.md

@@ -26,6 +26,13 @@ Per garantire una qualità ottimale delle chiamate:
 3. Eseguire il test audio per verificare la configurazione
 4. Regolare i livelli del volume secondo necessità
 
+## Chiamate in entrata {#configurazione-chiamate-in-entrata}
+
+![Nethlinkaudio](/img/nethlink/nethlink_ringtone.png)
+
+1. Scegli il suono che verrà riprodotto quando si riceve una chiamata in entrata.  
+2. Seleziona quale dispositivo audio riprodurrà la suoneria.
+
 ## Configurazione delle scorciatoie da tastiera
 
 ![Nethlinkshortcut](/img/nethlink/nethlink_scorciatoia.png)
@@ -66,4 +73,4 @@ Al momento le scorciatoie disponibili sono:
 - Configurazione proxy
 - Verifica del certificato SSL
 - Codec audio personalizzati
-- Logging di debug
+- Logging di debug