Erweiterte Domänen und Service Cloud Voice – Spring '23

Treffen Sie Vorbereitungen für die Version Winter '24, für die erweiterte Domänen in allen Organisationen aktiviert sein müssen.

• Service Cloud Voice mit Amazon Connect. Wenn Salesforce einen neuen AWS-Account erstellt und Ihnen eine neue Amazon Connect-Instanz zur Verfügung gestellt hat, müssen Sie nichts unternehmen. Wenn erweiterte Domänen aktiviert sind, kümmern wir uns im Hintergrund automatisch um alles.
• Service Cloud mit Partnertelefonie von Amazon Connect (bereitgestellt)
  • Wenn Salesforce zur Bereitstellung einer neuen Amazon Connect-Instanz einen bestehenden AWS-Account verwendet hat, müssen Sie nichts unternehmen. Wenn erweiterte Domänen aktiviert sind, kümmern wir uns im Hintergrund automatisch um alles.
• Service Cloud Voice mit Partnertelefonie von Amazon Connect (Import-XML)
  • Wenn Sie eine Amazon Connect-Instanz manuell über XML-Importdateien bereitgestellt und dafür einen bestehenden AWS-Account verwendet haben, müssen Sie einmalige Schritte ausführen, damit Benutzer sich anmelden und Service Cloud Voice nutzen können.
• Service Cloud Voice mit Partnertelefonie. Wenn Ihr Telefonieanbieter nicht Amazon Connect ist, müssen Sie im Abschnitt "Service Cloud Voice mit Partnertelefonie" einmalige Schritte ausführen.

Service Cloud Voice mit Amazon Connect

Wenn Salesforce einen neuen AWS-Account erstellt und Ihnen eine neue Amazon Connect-Instanz zur Verfügung gestellt hat, müssen Sie nichts unternehmen. Wenn erweiterte Domänen aktiviert sind, kümmern wir uns im Hintergrund automatisch um alles.

Wenn Sie Ihre benutzerdefinierten AWS Lambda-Funktionen beibehalten möchten, können Sie die Aktualisierung der Lambda-Funktionen zurücksetzen. Die nötigen Schritte dazu sind unter Zurücksetzen einer AWS Lambda-Funktionsaktualisierung, nachdem erweiterte Domänen aktiviert wurden beschrieben.

Service Cloud mit Partnertelefonie von Amazon Connect (bereitgestellt)

Wenn Sie die Ersteinrichtung von Service Cloud Voice ursprünglich vorgenommen haben, indem Sie eine Amazon Connect-Instanz über Salesforce bereitgestellt haben, müssen Sie nichts unternehmen. Wenn erweiterte Domänen aktiviert sind, kümmern wir uns im Hintergrund automatisch um alles.

Wenn Sie Ihre benutzerdefinierten AWS Lambda-Funktionen beibehalten möchten, können Sie die Aktualisierung der Lambda-Funktionen zurücksetzen. Die nötigen Schritte dazu sind unter Zurücksetzen einer AWS Lambda-Funktionsaktualisierung, nachdem erweiterte Domänen aktiviert wurden beschrieben.

Service Cloud Voice mit Partnertelefonie von Amazon Connect (Import-XML)

Wenn Sie eine Amazon Connect-Instanz manuell über XML-Importdateien bereitgestellt und dafür einen bestehenden AWS-Account verwendet haben, müssen Sie die folgenden einmaligen Schritte ausführen, damit Benutzer sich anmelden und Service Cloud Voice nutzen können.

Wenn Sie Ihre bisherigen benutzerdefinierten Funktionen in AWS Lambda beibehalten möchten, nachdem Sie die beschriebenen Schritte ausgeführt haben, können Sie die Aktualisierung der Lambda-Funktionen zurücksetzen. Die nötigen Schritte dazu sind unter Zurücksetzen einer AWS Lambda-Funktionsaktualisierung, nachdem erweiterte Domänen aktiviert wurden beschrieben.

1. Wenn Single Sign-On nicht funktioniert, aktualisieren Sie die Metadaten für den Salesforce-Identitätsanbieter.
   1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text "Meine Domäne" ein und wählen Sie dann Identitätsanbieter aus.
   2. Klicken Sie auf Metadaten herunterladen und speichern Sie die Metadaten-XML-Datei dann auf Ihrem Computer.
   3. Wechseln Sie in der AWS-Verwaltungskonsole zum IAM-Dashboard.
   4. Gehen Sie zu Zugriffsverwaltung > Identitätsanbieter.

5. Klicken Sie auf den AmazonConnectSFDC-Identitätsanbieter oder den Identitätsanbieter, den Sie zuvor konfiguriert haben. Klicken Sie dann auf Metadaten ersetzen und ersetzen Sie die Metadaten-XML-Datei durch die lokale Datei, die Sie auf Ihrem Computer gespeichert haben.
6. Speichern Sie Ihre Änderungen.

2. Wenn die Lambda-Funktionen nicht funktionieren, aktualisieren Sie die SCRT-Endpunkt-URL (ScrtEndpointUrl) in allen betroffenen Lambda-Funktionen auf die neue URL. Die folgende SCRT-Endpunkt-URL ändert sich, nachdem erweiterte Domänen aktiviert wurden.

ScrtEndpointUrl:

Typ: String

Standard: salesforce-scrt-endpoint-url

Beschreibung: Salesforce Echtzeit-Server-Endpunkt-URL

Sie können die Aktualisierung der SCRT-Endpunkt-URLs über CloudFormation durchführen oder die URL für jede betroffene Lambda-Funktion jeweils manuell aktualisieren.

So aktualisieren Sie die SCRT-Endpunkt-URLs über CloudFormation:

1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text "Meine Domäne" ein und wählen Sie dann Meine Domäne aus.
2. Kopieren Sie die aktuelle URL von "Meine Domäne". Die URL sollte in "mit erweiterten Domänen" angegeben sein, was bedeutet, dass erweiterte Domänen aktiviert sind.
3. Wechseln Sie in der AWS-Verwaltungskonsole zu CloudFormation > Stacks > ServerlessApplicationStack.
4. Klicken Sie auf den Namen des Stapels, den Sie ändern möchten.
5. Klicken Sie auf die Registerkarte Parameter.
6. Ändern Sie den Wert des Keys "ScrtEndpointUrl" in die kopierte URL von "Meine Domäne" um. Wenn Ihre "Meine Domäne"-URL zum Beispiel MeineDomäneName.my.Salesforce.com ist, lautet der richtige ScrtEndpointURL-Wert https://MeineDomäneName.mein.salesforce-scrt.com.

So aktualisieren Sie die SCRT-Endpunkt-URL für jede der betroffenen Lambda-Funktionen:

1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text "Meine Domäne" ein und wählen Sie dann Meine Domäne aus.
2. Kopieren Sie die aktuelle URL von "Meine Domäne". Die URL sollte in "mit erweiterten Domänen" angegeben sein, was bedeutet, dass erweiterte Domänen aktiviert sind.
3. Wechseln Sie in der AWS-Verwaltungskonsole zum Dienst AWS Lambda und wählen Sie Funktionen.
4. Klicken Sie in der Liste mit den Funktionsnamen auf den Namen der Funktion.
5. Klicken Sie auf die Registerkarte Konfiguration. Wählen Sie Umgebungsvariablen und klicken Sie anschließend auf Bearbeiten.
6. Ändern Sie den Wert des Keys "ScrtEndpointUrl" in die kopierte URL von "Meine Domäne" um. Wenn Ihre "Meine Domäne"-URL zum Beispiel MeineDomäneName.my.Salesforce.com ist, lautet der richtige ScrtEndpointURL-Wert https://MeineDomäneName.mein.salesforce-scrt.com.
7. Klicken Sie auf Speichern.

3. Wenn Sie Lambda-Funktionen nutzen, die den Salesforce REST-API-Endpunkt aufrufen, aktualisieren Sie die Umgebungsvariablen für diese Lambda-Funktionen.
   1. Wechseln Sie in der AWS-Verwaltungskonsole zum Dienst AWS Lambda und wählen Sie Funktionen.
   2. Klicken Sie in der Liste mit den Funktionsnamen auf den Namen der Funktion.
   3. Klicken Sie auf die Registerkarte "Konfiguration". Wählen Sie Umgebungsvariablen und klicken Sie anschließend auf Bearbeiten.
   4. Ändern Sie den Wert "SALESFORCE_AUTH_ENDPOINT" für "Meine Domäne" in die kopierte URL um. Zum Beispiel: https://MeineDomäneName.my.salesforce.com/services/oauth2/token.

Um Ihren "Meine Domäne"-Namen zu überprüfen, gehen Sie in Salesforce zu Salesforce > Setup > Meine Domäne.

5. Ändern Sie den Wert "SALESFORCE_REST_API_ENDPOINT_BASE" für "Meine Domäne" in die kopierte URL um. Zum Beispiel: https://MeineDomäneName.my.salesforce.com/services/data/v<##.#>.
6. Klicken Sie auf Speichern.

Service Cloud Voice mit Partnertelefonie

Wenn Sie Service Cloud Voice ursprünglich statt mit Amazon Connect mit einer anderen Partnertelefonie eingerichtet haben, müssen Sie nach Aktivierung der erweiterten Domänen die folgenden einmaligen Schritte ausführen. 

1. Aktivieren Sie erweiterte Domänen, falls die Option noch deaktiviert ist.
2. Stellen Sie die neue "Meine Domäne" bereit.
3. Aktualisieren Sie alle hartcodierten API-URLs, Telefonie-REST-API-Endpunkte und Verweise auf die SCRT2-URL mit den neuen URLs. Stellen Sie sicher, dass Sie auch die Anmelde-URL von "Meine Domäne" für die Sandbox aktualisieren, da diese sich bei Aktivierung von erweiterten Domänen ändert. Wenn Sie die URL nicht aktualisieren, können die Benutzer sich nicht anmelden.
4. Optional können Sie die Apex-Schnittstelle service_cloud_voice.UpdateOrgDomainProvider implementieren, wenn Sie über künftige Änderungen an "Meine Domäne" in Ihrer Organisation benachrichtigt werden möchten. Die Schnittstelle enthält eine API, die aufgerufen wird, sobald sich die "Meine Domäne"-URL ändert und die aktualisierten Domäneninformationen an den Implementierungspartner sendet, der die betroffenen URLs dann entsprechend aktualisieren kann.

Deaktivieren von erweiterten Domänen

Diese Konfiguration gilt für das folgende Telefoniemodell:

• Service Cloud Voice mit Amazon Connect
• Service Cloud Voice mit Partnertelefonie von Amazon Connect
• Service Cloud Voice mit Partnertelefonie

Sie können erweiterte Domänen vorübergehend deaktivieren. Wir raten Ihnen jedoch, erweiterte Domänen ausreichend frühzeitig vor der Version Winter '24 zu aktivieren, damit Ihnen genug Zeit bleibt, um Ihre Umgebungen mit den neuen Einstellungen zu testen. 

1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text "Meine Domäne" ein und wählen Sie dann Meine Domäne aus.
2. Klicken Sie im Abschnitt "Weiterleitung" auf "Bearbeiten".
3. Heben Sie die Auswahl bei Erweiterte Domänen auf.
4. Heben Sie die Auswahl von URLs für "Visualforce, Erfahrungsgenerator, Site.com Studio und Inhaltsdateien stabilisieren" auf, falls es vor Version Spring '23 abgewählt wurde.
5. Klicken Sie auf Speichern.
6. Klicken Sie auf Neue Domäne bereitstellen.

Zurücksetzen einer AWS Lambda-Funktionsaktualisierung, nachdem erweiterte Domänen aktiviert wurden

Diese Konfiguration gilt für das folgende Telefoniemodell:

• Service Cloud Voice mit Amazon Connect
• Service Cloud Voice mit Partnertelefonie von Amazon Connect

Wenn Sie benutzerdefinierte AWS Lambda-Funktionen nutzen und diese nicht durch die neuesten Upgrade-Versionen ersetzen möchten, wenn erweiterte Domänen aktiviert sind, können Sie das Lambda-Update zurücksetzen. Sollte das der Fall sein, müssen Sie nach dem Zurücksetzen die URLs von bestimmten Umgebungsvariablen in Ihren Lambda-Funktionen manuell aktualisieren, sodass sie auf die neue URL-Version für erweiterte Domänen verweisen.

So setzen Sie die Aktualisierung der Lambda-Funktionen, die durch die Aktivierung von erweiterten Domänen ausgelöst wird, wieder zurück:

1. Gehen Sie wie unter Zurücksetzen einer Lambda-Aktualisierung beschrieben vor, um die Lambda-Funktionen zurückzusetzen.
2. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text "Meine Domäne" ein und wählen Sie dann "Meine Domäne" aus.
3. Notieren Sie sich die aktuelle "Meine Domäne"-URL. Die URL sollte in "mit erweiterten Domänen" angegeben sein, was bedeutet, dass erweiterte Domänen aktiviert sind.
4. Wählen Sie in der AWS Lambda-Konsole den Punkt "Funktionen" aus.
5. Aktualisieren Sie die Umgebungsvariablen für die Lambda-Funktionen auf die neue erweiterte Domänen-URL. Wiederholen Sie diesen Vorgang für jede Lambda-Funktion.
   1. Klicken Sie auf den Namen der Funktion, um ihre Detailseite aufzurufen.
   2. Klicken Sie auf die Registerkarte "Konfiguration", dann auf "Umgebungsvariablen" und anschließend auf "Bearbeiten".
   3. Suchen Sie nach Umgebungsvariablen, die die Salesforce-Domäne oder die SCRT2-URL enthalten, und ersetzen Sie die entsprechenden URLs durch die neue Version für erweiterte Domänen, die Sie vorher notiert haben.
   4. Speichern Sie Ihre Änderungen.

Siehe auch:

• Salesforce-Hilfe: Erweiterte Domänen 
• Knowledge-Artikel: Erweiterte Domänen und ihre Auswirkungen auf Service Cloud Voice
• Entwicklerhandbuch: Service Cloud Voice für Partnertelefonie – Apex-Referenz