Loading

Domini ottimizzati e Service Cloud Voice - Spring '23

Data pubblicazione: Apr 14, 2026
Descrizione

I domini ottimizzati sono la versione attuale del Dominio personale che soddisfa gli standard di sicurezza più recenti. Alcuni URL utilizzati per le funzioni di Service Cloud Voice, come l'URL connettore, l'API di telefonia (URL SCRT2) e l'URL dell'API Connect, contengono il valore del dominio.

Questa configurazione si applica al seguente modello di telefonia:

  • Service Cloud Voice con Amazon Connect
  • Service Cloud Voice con partner di telefonia di Amazon Connect
  • Service Cloud Voice con partner di telefonia
 

A partire dal rilascio Spring '23, i domini ottimizzati sono stati distribuiti in organizzazioni Sandbox, non di produzione e di produzione. I clienti avevano la possibilità di posticipare (disattivare) i domini avanzati nelle organizzazioni Sandbox e non di produzione prima che tali organizzazioni venissero aggiornate al rilascio Spring '23. Per maggiori informazioni, vedere l'articolo relativo ai domini ottimizzati e all'impatto degli stessi su Service Cloud Voice (Winter ’23).

 

Nei rilasci successivi, i domini ottimizzati interesseranno tutte le organizzazioni, comprese le organizzazioni Sandbox, non di produzione e di produzione:

  • Spring '23: i domini ottimizzati sono stati distribuiti in tutte le organizzazioni. Se i domini ottimizzati sono stati disabilitati in alcune organizzazioni, rimarranno disabilitati in tali organizzazioni. Saranno abilitati in tutte le altre organizzazioni.
  • Summer '23: i domini ottimizzati verranno distribuiti e abilitati in tutte le organizzazioni, inclusi quelli disabilitati dall'utente. Sarà comunque possibile disabilitare manualmente i domini ottimizzati.
  • Winter '24: i domini ottimizzati verranno ridistribuiti, abilitati e applicati in tutte le organizzazioni. L'utente non può disabilitare i domini ottimizzati.

Vedere la pagina Domini ottimizzati per ulteriori informazioni sui domini ottimizzati e le tempistiche generali.

Se il proprio operatore telefonico è Amazon Connect, quando i domini ottimizzati sono abilitati in un'organizzazione, Salesforce aggiorna automaticamente tutti i call center dell'organizzazione impostandoli sulla versione di call center più recente disponibile. Perché aggiorniamo automaticamente i call center? Perché quando i domini ottimizzati sono abilitati, il valore Dominio personale e l'URL SCRT2 dell'organizzazione cambiano sul lato Salesforce. Per far sì che le cose funzionino senza problemi con Amazon Connect, dobbiamo aggiungere questi valori aggiornati alle funzioni AWS Lambda e il modo migliore per farlo è aggiornare i call center. Si noti che anche se si modifica manualmente il valore Dominio personale dell'organizzazione nella pagina Dominio personale di Salesforce, i call center verranno comunque aggiornati automaticamente.

Risoluzione

Prepararsi per il rilascio Winter '24 quando i domini ottimizzati devono essere abilitati in tutte le organizzazioni.

  • Service Cloud Voice con Amazon Connect. Se Salesforce ha creato un nuovo account AWS e ha eseguito il provisioning di una nuova istanza di Amazon Connect, non è richiesta alcuna azione. Quando i domini ottimizzati sono abilitati, Salesforce si occupa automaticamente di tutto dietro le quinte.
  • Service Cloud Voice con partner di telefonia di Amazon Connect (con provisioning)
    • Se Salesforce ha utilizzato un account AWS esistente per eseguire il provisioning di una nuova istanza di Amazon Connect, non è richiesta alcuna azione. Quando i domini ottimizzati sono abilitati, Salesforce si occupa automaticamente di tutto dietro le quinte.
  • Service Cloud Voice con partner di telefonia di Amazon Connect (XML di importazione)
    • Se è stato utilizzato un account AWS esistente per eseguire manualmente il provisioning di un'istanza di Amazon Connect utilizzando i file XML di importazione, è necessario eseguire operazioni una tantum per garantire che gli utenti possano accedere e utilizzare Service Cloud Voice.
  • Service Cloud Voice con partner di telefonia. Se il partner di telefonia non è Amazon Connect, eseguire le operazioni una tantum della sezione Service Cloud Voice con partner di telefonia.

Service Cloud Voice con Amazon Connect

Se Salesforce ha creato un nuovo account AWS e ha eseguito il provisioning di una nuova istanza di Amazon Connect, non è richiesta alcuna azione. Quando i domini ottimizzati sono abilitati, Salesforce si occupa automaticamente di tutto dietro le quinte.

Se si desidera mantenere le funzioni AWS Lambda personalizzate, è possibile annullare gli aggiornamenti delle funzioni Lambda. Per le operazioni da eseguire, vedere Annullamento di un aggiornamento delle funzioni AWS Lambda dopo l'abilitazione dei domini ottimizzati.

Service Cloud Voice con partner di telefonia di Amazon Connect (con provisioning)

Se in origine si è impostato Service Cloud Voice eseguendo il provisioning dell'istanza di Amazon Connect tramite Salesforce, non è richiesta alcuna azione. Quando i domini ottimizzati sono abilitati, Salesforce si occupa automaticamente di tutto dietro le quinte.

Se si desidera mantenere le funzioni AWS Lambda personalizzate, è possibile annullare gli aggiornamenti delle funzioni Lambda. Per le operazioni da eseguire, vedere la procedura di annullamento di un aggiornamento delle funzioni AWS Lambda dopo l'abilitazione dei domini ottimizzati.

 

Service Cloud Voice con partner di telefonia di Amazon Connect (XML di importazione)

Se è stato utilizzato un account AWS esistente per eseguire manualmente il provisioning di un'istanza di Amazon Connect utilizzando i file XML di importazione, eseguire le seguenti operazioni una tantum per garantire che gli utenti possano accedere e utilizzare Service Cloud Voice.

Completata la procedura, se si desidera mantenere le funzioni AWS Lambda personalizzate, è possibile annullare gli aggiornamenti delle funzioni Lambda. Per le operazioni da eseguire, vedere Annullamento di un aggiornamento delle funzioni AWS Lambda dopo l'abilitazione dei domini ottimizzati.

 
  1. Se il Single Sign-On non funziona, aggiornare i metadati del provider di Salesforce Identity.
    1. In Imposta, nella casella Ricerca veloce, digitare Dominio personale, quindi selezionare Provider di identità.
    2. Fare clic su Scarica metadati, quindi salvare il file XML dei metadati sul computer.
    3. Dalla console di gestione di AWS, accedere al cruscotto digitale IAM.
    4. Passare a Gestione degli accessi > Provider di identità.

  1. Fare clic sul provider di identità AmazonConnectSFDC o sul provider di identità configurato in precedenza, fare clic su Sostituisci metadati e sostituire il file XML dei metadati con la copia salvata sul proprio computer.
  2. Salvare le modifiche.
 
  1. Se le funzioni Lambda non funzionano, aggiornare l'URL dell'endpoint SCRT (ScrtEndpointUrl) in tutte le funzioni Lambda interessate con il nuovo URL. Il seguente URL dell'endpoint SCRT cambierà dopo l'abilitazione dei domini ottimizzati.
 

ScrtEndpointUrl:

Tipo: Stringa

Predefinito: salesforce-scrt-endpoint-url

Descrizione: URL dell'endpoint server Salesforce in tempo reale

 

È possibile aggiornare gli URL dell'endpoint SCRT tramite CloudFormation o aggiornando manualmente l'URL in ciascuna delle funzioni Lambda interessate.

Per aggiornare gli URL dell'endpoint SCRT con CloudFormation:

  1. In Imposta, nella casella Ricerca veloce, digitare Dominio personale, quindi selezionare Dominio personale.
  2. Copiare l'URL Dominio personale attuale. L'URL dovrebbe essere "con domini ottimizzati" per indicare che i domini ottimizzati sono abilitati.
  3. Dalla console di gestione di AWS, andare a CloudFormation > Stacks > ServerlessApplicationStack.
  4. Fare clic sul nome dello stack da cambiare.
  5. Fare clic sulla scheda Parametri .
  6. Modificare il valore della chiave ScrtEndpointUrl impostandola sull'URL Dominio personale copiato. Ad esempio, se l'URL Dominio personale è MyDomainName.my.salesforce.com, il valore ScrtEndpointUrl è https://MyDomainName.my.salesforce-scrt.com.

Per aggiornare l'URL dell'endpoint SCRT in ciascuna delle funzioni Lambda interessate:

  1. In Imposta, nella casella Ricerca veloce, digitare Dominio personale, quindi selezionare Dominio personale.
  2. Copiare l'URL Dominio personale attuale. L'URL dovrebbe essere "con domini ottimizzati" per indicare che i domini ottimizzati sono abilitati.
  3. Dalla console di gestione di AWS, accedere al servizio AWS Lambda e selezionare Funzioni.
  4. Fare clic sul nome della funzione nell'elenco dei nomi di funzione.
  5. Fare clic sulla scheda Configurazione, selezionare Variabili di ambiente, quindi fare clic su Modifica.
  6. Modificare il valore della chiave ScrtEndpointUrl impostandola sull'URL Dominio personale copiato. Ad esempio, se l'URL Dominio personale è MyDomainName.my.salesforce.com, il valore ScrtEndpointUrl è https://MyDomainName.my.salesforce-scrt.com.
  7. Fare clic su Salva.
 
  1. Se si utilizzano funzioni Lambda che richiamano l'endpoint dell'API REST Salesforce, aggiornare le variabili di ambiente per quelle funzioni Lambda.
    1. Dalla console di gestione di AWS, accedere al servizio AWS Lambda e selezionare Funzioni.
    2. Fare clic sul nome della funzione nell'elenco dei nomi di funzione.
    3. Fare clic sulla scheda Configurazione, selezionare Variabili di ambiente e fare clic su Modifica.
    4. Modificare il valore del Dominio personale SALESFORCE_AUTH_ENDPOINT impostandolo sull'URL copiato. Ad esempio, https://MyDomainName.my.salesforce.com/services/oauth2/token.
 

Per verificare il nome Dominio personale, da Salesforce, andare a Salesforce > Imposta > Dominio personale.

 
  1. Modificare il valore del Dominio personale SALESFORCE_REST_API_ENDPOINT_BASE impostandolo sull'URL copiato. Ad esempio, https://MyDomainName.my.salesforce.com/services/data/v<##.#>.
  2. Fare clic su Salva.

Service Cloud Voice con partner di telefonia

Se originariamente si è configurato Service Cloud Voice con un partner di telefonia che non è Amazon Connect, eseguire le seguenti operazioni una tantum dopo l'abilitazione dei domini ottimizzati. 

  1. Abilitare i domini ottimizzati se sono disabilitati.
  2. Eseguire il provisioning del nuovo Dominio personale e distribuirlo.
  3. Aggiornare tutti gli URL dell'API Connect codificati, gli endpoint API REST di telefonia e i riferimenti all'URL SCRT2 con i nuovi URL. Assicurarsi di aggiornare l'URL di accesso al Dominio personale per l'ambiente Sandbox, perché cambia con i domini ottimizzati. Se non si aggiorna l'URL, gli utenti non potranno accedere.
  4. Se si desidera, implementare l'interfaccia Apex service_cloud_voice.UpdateOrgDomainProvider per essere informati in caso di future modifiche apportate a Dominio personale nell'organizzazione. L'interfaccia contiene un'API che viene chiamata ogni volta che l'URL Dominio personale cambia e invia le informazioni aggiornate sul dominio al partner di implementazione, che può quindi aggiornare gli URL interessati.

Disabilitazione dei domini ottimizzati

Questa configurazione si applica al seguente modello di telefonia:

  • Service Cloud Voice con Amazon Connect
  • Service Cloud Voice con partner di telefonia di Amazon Connect
  • Service Cloud Voice con partner di telefonia

È possibile disabilitare temporaneamente i domini ottimizzati. Tuttavia, si consiglia vivamente di abilitare i domini ottimizzati con largo anticipo rispetto al rilascio Winter '24, per avere il tempo necessario per testare i propri ambienti con le nuove impostazioni. 

  1. In Imposta, nella casella Ricerca veloce, digitare Dominio personale, quindi selezionare Dominio personale.
  2. Nella sezione Instradamento, fare clic su Modifica.
  3. Deselezionare Domini ottimizzati.
  4. Deselezionare Stabilizza URL di Visualforce, Generatore di esperienze, Site.com Studio e file di contenuto se era deselezionata prima di Spring '23.
  5. Fare clic su Salva.
  6. Fare clic su Distribuisci Nuovo dominio.

Annullamento di un aggiornamento delle funzioni AWS Lambda dopo l'abilitazione dei domini ottimizzati

Questa configurazione si applica al seguente modello di telefonia:

  • Service Cloud Voice con Amazon Connect
  • Service Cloud Voice con partner di telefonia di Amazon Connect
 

Se si dispone di funzioni AWS Lambda personalizzate e non si desidera che vengano sostituite con le versioni più recenti e aggiornate quando si abilitano i domini ottimizzati, è possibile annullare l'aggiornamento di Lambda. A tal fine, dopo aver eseguito l'annullamento, aggiornare manualmente alcuni URL di variabili di ambiente nelle funzioni Lambda per puntare alla nuova versione dell'URL dei domini ottimizzati.

Per annullare l'aggiornamento di una funzione Lambda attivato quando vengono abilitati i domini ottimizzati:

  1. Seguire la procedura descritta nella sezione sull'annullamento di un aggiornamento di Lambda per annullare l'aggiornamento delle funzioni Lambda.
  2. In Imposta, nella casella Ricerca veloce, digitare Dominio personale, quindi selezionare Dominio personale.
  3. Annotare l'URL Dominio personale attuale. L'URL dovrebbe essere "con domini ottimizzati" per indicare che i domini ottimizzati sono abilitati.
  4. Selezionare Funzioni dalla console di AWS Lambda.
  5. Aggiornare le variabili di ambiente delle funzioni Lambda con il nuovo URL dei domini ottimizzati. Ripetere l'operazione per ogni funzione Lambda.
    1. Fare clic sul nome della funzione per aprire la relativa pagina dei dettagli.
    2. Fare clic sulla scheda Configurazione, quindi selezionare Variabili di ambiente e fare clic su Modifica.
    3. Individuare tutte le variabili di ambiente che includono il dominio Salesforce o l'URL SCRT2 e modificare tali URL in base alla versione dei domini ottimizzati annotata.
    4. Salvare le modifiche.

Vedere anche:

Numero articolo Knowledge

000394652

 
Caricamento
Salesforce Help | Article