Hinzufügen von Konfigurationen zu benutzerdefinierten Aktionen für Integrationen

Notiz : Dieser Artikel gilt für die Datenaktionsintegrationen AWS Lambda, Function, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, Web Services und Zendesk.

Wenn Sie eine benutzerdefinierte Aktion erstellen, fügen Sie zunächst Verträge und dann die Konfiguration hinzu. Die Konfiguration legt fest, wie die Aktion die Verträge umsetzt. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten Aktion und Hinzufügen von Verträgen zu benutzerdefinierten Aktionen

Hinweis: Sie können die Konfiguration ändern, nachdem Sie die Aktion veröffentlicht haben. Weitere Informationen finden Sie unter Ändern der Konfiguration in benutzerdefinierten Aktionen.

Klicken Sie auf die Registerkarte Konfiguration
Wählen Sie die HTTP-Methode.
Unter Anfragekonfigurieren Sie die Anfrage, die die Aktion an den Webdienst sendet. Genesys empfiehlt, die Anfrage mit Hilfe der Felder unter Simplezu konfigurieren.
Tipp: Klicken Sie auf die Eigenschaften unter Available Inputs , um sie zu kopieren und schnell in die Anfrage einzufügen Diese Eigenschaften stammen aus Ihrem Eingabevertrag. Weitere Informationen finden Sie unter Verträge zu benutzerdefinierten Aktionen hinzufügen. Sie können Makros mit den Vorlagen verwenden. Weitere Informationen finden Sie unter Velocity macros for data actions.

Geben Sie Informationen für die angezeigten Felder ein. Welche Felder angezeigt werden, hängt von der gewählten HTTP-Methode und den hinzugefügten Verträgen ab.
Notizen:
- Informationen zu den AWS Lambda-Datenaktionsintegrationen und Google Cloud Functions finden Sie im Folgenden Sonderwunschkonfigurationen Abschnitt.
- Übermäßig verschachtelte JSON-Objekte können die Leistung des Datenaktionsdienstes beeinträchtigen. Um die Leistung zu erhalten, ist die Tiefe der JSON-Objekte auf 50 Ebenen begrenzt. Weitere Informationen finden Sie unter Limits im Genesys Cloud Developer Center.
URL-Vorlage anfordern
Setzen Sie Request URL Template auf den entfernten Endpunkt, auf den Ihre HTTP-Anfrage trifft
Kopfzeilen (fakultativ)
Schlüssel-Wert-Paare, die als HTTP-Header der an den entfernten Endpunkt gesendeten Anfrage hinzugefügt werden.
Hinweis: Wenn Sie den Accept-Header setzen, müssen Sie einen JSON-Medientyp als Header-Wert verwenden.
Execution Timeout
Set the execution timeout between 1 and 60 seconds for the data action. The default timeout of 60 seconds is used when you do not set a timeout value. When the HTTP requests run longer than the set time, then the data action returns a timeout response. After the designated time limit, the data action execution is removed from the concurrency limit. For more information, see How many seconds before a data action times out?.
Note: To ensure that a flow’s timeout logic is executed correctly and to prevent unnecessary data action processing, set the data action’s timeout to be one second longer than the flow’s configured timeout. This best practice helps to manage concurrency limit by ensuring that the data action doesn’t continue after the flow has already timed out.
Übertragung Kodierung
Wenn Ihr Webdienst Transfer-Encoding nicht unterstützt und auf chunkedeingestellt ist, fügen Sie Transfer-Encoding hinzu gepuffert unter Header Weitere Informationen finden Sie unter Benutzerdefinierte Aktion schlägt aus unerwartetem Grund fehl.
Autorisierung
Sie können Autorisierungsinformationen in die Anfragekonfiguration aufnehmen. Weitere Informationen finden Sie unter Verwendung des benutzerdefinierten Berechtigungstyps und Verwendung des benutzerdefinierten (OAuth) Berechtigungstyps

Sonderwunsch Konfiguration

The request configuration for custom actions that are associated with the AWS Lambda data actions integrations or that execute the Google Cloud Functions vary from the standard request configuration for web services.

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den ARN Ihrer AWS Lambda-Funktion Weitere Informationen finden Sie unter IAM-Ressourcen zum Aufrufen von AWS Lambda-Funktionen erstellen.
Antragsart
Setzen Sie Request Type auf POST Diese HTTP-Methode stellt sicher, dass die Aktion einen beliebigen Anfragekörper mit der Anfragekonfiguration sendet.
Kopfzeilen
Schlüssel-Wert-Paare, die zu einer benutzerdefinierten Map auf dem clientContext Objekt hinzugefügt werden. Das Objekt clientContext ist wiederum ein Wert für das Objekt context des Aufrufs Wenn die folgenden Attribute vorhanden sind, werden sie automatisch auf das Objekt context gesetzt
- ININ-Organisation-Id
- ININ-Home-Organisation-Id
- ININ-Korrelation-Id
- ININ-Benutzer-Id
- ININ-Integration-Id
Ein Java-Beispiel für das Objekt clientContext finden Sie unter Interface ClientContext
Vorlage anfordern
Alle Werte, die Sie unter Request Template angeben, werden im Parameter event der aufgerufenen AWS Lambda-Funktion verfügbar sein.

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den entfernten Endpunkt, auf den Ihre HTTP-Anfrage trifft
Antragsart
Setzen Sie Request Type auf POST Diese HTTP-Methode stellt sicher, dass die Aktion einen beliebigen Anfragekörper mit der Anfragekonfiguration sendet.
Kopfzeilen
Schlüssel-Wert-Paare, die zu einer benutzerdefinierten Map auf dem clientContext Objekt hinzugefügt werden. Das Objekt clientContext ist wiederum ein Wert für das Objekt context des Aufrufs Wenn die folgenden Attribute vorhanden sind, werden sie automatisch auf das Objekt context gesetzt
- ININ-Organisation-Id
- ININ-Home-Organisation-Id
- ININ-Korrelation-Id
- ININ-Benutzer-Id
Ein Java-Beispiel für das Objekt clientContext finden Sie unter Interface ClientContext
Vorlage anfordern
Any values that you specify under Request Template will be available in the event parameter of the invoked AWS Lambda function. The clientContext has length limits and cannot be used to pass certificates required for Genesys Cloud Function data actions. To include the certificates configured in credentials, use the body of the request template, which has no size restrictions.

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den Speicherort der Google Cloud Function, die die Datenaktion ausführen soll https://{Ort der Funktion}-{Projekt-Eigentümerfunktion}/{Funktionsname}.
Antragsart
Setzen Sie Request Type auf POST
Vorlage anfordern
Setzen Sie Request Template auf ${input.rawRequest}.

Eine ausführliche Erläuterung der Teile der Anfrage finden Sie unter Anfragekonfiguration für Datenaktionen.

Erweiterte Benutzer (JSON)

Personen, die sich mit JSON auskennen, können die JSON-Eingabeoption verwenden. Verwenden Sie Anfragen in anderen Aktionen oder das folgende Beispiel als Anleitung für die Erstellung des JSON.

{
  "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}

Fügen Sie unter Responsedie JSON-Konfiguration hinzu.
Die JSON-Konfiguration legt fest, wie die Antwort des Webservice oder der AWS Lambda-Funktion verarbeitet wird.

Sie können die Antwort in anderen Aktionen oder das folgende Beispiel als Anleitung für die Erstellung des JSON verwenden. Weitere Informationen zur Verwendung von Makros mit der Erfolgsvorlage finden Sie unter Velocity-Makros für Datenaktionen.

Tipp: Klicken Sie auf die Eigenschaften unter Available Outputs , um sie zu kopieren und schnell in die Antwort einzufügen Diese Eigenschaften sind in Ihrem Output-Vertrag enthalten. Weitere Informationen finden Sie unter Verträge zu benutzerdefinierten Aktionen hinzufügen.
```
{
      "translationMap": {
          "buildNumber": "$.Build-Version",
          "serviceName": "$.name",
          "status": "$.Status"
      },
      "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
 }
```
Eine ausführliche Erläuterung der Teile der Antwort finden Sie unter Antwortkonfiguration für Datenaktionen.

Nächste, Fügen Sie die Funktion hinzu für die Genesys Cloud-Funktion. Für andere Datenaktionen, Testen Sie die Aktion für Validierungs- und Ausführungsfehler.

Weitere Informationen finden Sie unter Über benutzerdefinierte Aktionen für Integrationen.

Weitere Informationen zu den Integrationen finden Sie unter Über die Integrationen von Datenaktionen.