---
sourceDocument: Xanadu-Konversations-Schnittstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Konversations-Schnittstellen

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Erstellen und konfigurieren Sie eine geskriptete REST API für Ihre anwenderdefinierte Chatintegration

# Erstellen und konfigurieren Sie eine geskriptete REST API für Ihre anwenderdefinierte Chatintegration {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Erstellen Sie eine geskriptete REST-API, fügen Sie eine geskriptete REST-Ressource hinzu, legen Sie Sicherheits- und Inhaltsverhandlungen fest, und legen Sie REST-API-Quotengrenzen fest.

## Vorbereitungen

[Ordnen Sie dem Kanal in Ihrer anwenderdefinierten Chatintegration Rich Controls zu](https://servicenow-prod.fluidtopics.net/DDm_ZA49kLQCVKC75zH1NQ "Erstellen Sie Datensätze für Rich Controls in der Tabelle „Anwenderdefinierte Adapterkonfigurationen“ [sys_cs_custom_adapter_config]. Wenn bei einem Rich Control eine Implementierung eines ausgehenden Umwandlers fehlt, wird dem Endanwender keine Antwort zugestellt, und dieser Benutzer kann über die Chat-Experience verfügen.").

Erforderliche Rolle: admin

## Prozedur

1. Erstellen Sie die REST API.
   1. Navigieren zu AlleSystem-WebservicesScripted Web ServicesScripted REST APIs.
   2. Klicken Sie auf Neu.
   3. Füllen Sie die Felder des Formulars aus.  
      {#configure-rest-api-va-cccif__table_syk_xhl_1mb__entry__2}

      | Feld | Beschreibung |
      |-|-|
      | Name | Name Ihrer API. Beispiel: <kbd class="ph userinput">Chat-Adapter für ACME-Mobile-Apps</kbd>. |
      | API-ID | API-Bezeichner. Beispiel: <kbd class="ph userinput">acme_chat</kbd>. |
      | Schutzrichtlinie | Die Schutzrichtlinie für das Skript. * Schreibgeschützt: Das Skript ist nur sichtbar. * Geschützt: Benutzer mit Passwortberechtigungen können das Skript bearbeiten. {#configure-rest-api-va-cccif__ul_jmv_hgx_ktb} |
      | Anwendung | Die Anwendung, die den Skriptdatensatz enthält. Standardmäßig istGlobal ausgewählt. |
      | API-Namespace | Der Namespace, zu dem die API gehört. Der Wert hängt vom aktuellen Anwendungsbereich ab. |
      [ ]

      {#configure-rest-api-va-cccif__table_syk_xhl_1mb}
   4. Klicken Sie auf Absenden.
   5. **Wahlweise:** Öffnen Sie den neuen Datensatz, navigieren Sie zu Zugehörige Links, und klicken Sie auf Versionsverwaltung aktivierenund klicken Sie dann auf OK.  
      Klicken Sie auf Aktualisieren, um die Änderungen zu speichern.
   {#configure-rest-api-va-cccif__substeps_bfp_gc5_wlb}
2. Fügen Sie Ihrer neuen REST API eine geskriptete REST-Ressource hinzu.  
   Die geskriptete REST-Ressource definiert die von Ihnen erstellte geskriptete REST-API-Definition.
   1. Öffnen Sie den von Ihnen erstellten REST-API-Datensatz, und navigieren Sie dann zur Registerkarte Ressourcen unter Zugehörige Links.
   2. Klicken Sie auf Neu.  
      Rufen Sie die Nutzlast aus der Anforderung ab, und schreiben Sie sie dann in eine Hybridwarteschlange.
   3. Füllen Sie die Felder des Formulars aus.  
      {#configure-rest-api-va-cccif__table_dyh_d3l_1mb__entry__2}

      | Feld | Beschreibung |
      |-|-|
      | API-Definition | Name der übergeordneten API. |
      | Anwendung | Die Anwendung, die den Skriptdatensatz enthält. |
      | Name | Name Ihrer API-REST-Ressource. Beispiel: ACME-Chat. |
      | API-Version | API-Version Beispiel: v1. Dieses Feld wird nur angezeigt, wenn Sie die Versionsverwaltung für die REST API aktiviert haben. |
      | Aktiv | Option zum Aktivieren der REST-Ressource. |
      | HTTP-Methode | HTTP-Methode wie POST, GET usw. |
      | Relativer Pfad | Relativer Pfad zur Ressource. |
      | Skript | Skript für die REST-Ressource. |
      | Schutzrichtlinie | Die Schutzrichtlinie für das Skript. * Schreibgeschützt: Das Skript ist nur sichtbar. * Geschützt: Benutzer mit Passwortberechtigungen können das Skript bearbeiten. {#configure-rest-api-va-cccif__ul_kh4_13x_ktb} |
      [ ]

      {#configure-rest-api-va-cccif__table_dyh_d3l_1mb}  
      Beispiel für eine geskriptete REST-Ressource:

          (function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
              var body = request.body;
              var queryParams = request.queryParams; // incoming content is application/x-www-form-urlencoded in this example    
              // get the provider application sys id. this can be done via a glide query using incoming data such as where the original message is being sent to. or it can be hard-coded such as this example.
              var providerAppId = "a5f8b75b7377001042281188caf6a73a";    
              // the time of receipt is recorded for analytics purposes
              var d = new Date();
              var logTime = d.getTime();    
              // add this message to the VA Server queue for processing
              var queued = sn_cs.VASystemObject.enqueueCustomAdapterMessage(providerAppId, JSON.stringify(queryParams), JSON.stringify(request.headers), logTime);
              if (queued == false) {
          	response.setError(new sn_ws_err.BadRequestError('Failed to process the request.'));
              }
          })(request, response);
          ​

   {#configure-rest-api-va-cccif__substeps_mp5_xkp_xlb}
3. Legen Sie die Sicherheits- und Inhaltsaushandlung für Ihre geskriptete REST-Ressource fest.  
   Wählen Sie diese Option, um Authentifizierungs- und Anforderungsformate festzulegen. Wenn Ihre anwenderdefinierte Integration nicht auf Authentifizierung basiert, können Sie sie wie folgt entfernen.
   1. Navigieren Sie im neuen Datensatz für die Scripted REST Resource (Skriptbasierte REST-Ressource) zur Registerkarte Security (Sicherheit).
   2. Löschen Sie Erfordert Authentifizierung.
   3. Klicken Sie auf die Registerkarte Inhaltsverhandlung, und wählen Sie Unterstützte Anforderungsformate überschreiben aus.
   4. Klicken Sie auf Absenden.
   {#configure-rest-api-va-cccif__substeps_es1_v2h_zlb}
4. Legen Sie REST-API-Quotengrenzen fest, um die Rate eingehender Anforderungen zu definieren.
   1. Navigieren zu AlleSystem-WebservicesRESTQuotenbegrenzungsregeln.
   2. Klicken Sie auf Neu.
   3. Füllen Sie die Felder des Formulars aus.  
      {#configure-rest-api-va-cccif__table_jk5_vdy_ktb__entry__2}

      | Feld | Beschreibung |
      |-|-|
      | Name | Eindeutiger Name für die Quotengrenzregel. |
      | REST-API | REST API, die Sie in einem früheren Schritt erstellt haben. |
      | Version | Version der REST-API. Die aufgeführten Werte hängen von der ausgewählten REST API ab. |
      | Ressource | Ressource für die angegebene Version. Die aufgeführten Werte hängen von der ausgewählten Version ab. |
      | Aktiv | Aktivieren Sie die Checkbox, um anzugeben, dass die Quotengrenzregel aktiv ist. Quotengrenzregeln werden standardmäßig aktiviert, sobald Sie sie erstellen. Sie können Quotengrenzregeln deaktivieren, um die Durchsetzung einer Quotengrenze zu beenden, oder Quotengrenzregeln aktivieren, um die Quotengrenze wieder zu erzwingen. |
      | Anforderungsbegrenzung pro Stunde | Die maximal zulässige Anzahl von Anforderungen pro Stunde. Hinweis: Wenn Sie den Wert dieses Felds aktualisieren, setzt die Now Platform die Anzahl der Anforderungen auf 0 zurück und löscht alle Verstöße für die aktuelle Stunde. |
      | Anwenden auf | Durch diese Regel eingeschränkte Anwender. Wählen Sie Alle Anwender aus. |
      [ ]

      {#configure-rest-api-va-cccif__table_jk5_vdy_ktb}
   4. Klicken Sie auf Absenden.
   {#configure-rest-api-va-cccif__substeps_q3r_cyx_ktb}

## Nächste Maßnahme

[Erstellen Sie die Aktionsskripts für Ihre anwenderdefinierte Chatintegration](https://servicenow-prod.fluidtopics.net/ZpPeZk4tl0huDTudlE_tww "Richten Sie die Transformationen ein, die Ihre anwenderdefinierte Chatintegration benötigt, um über den Chatprozess zu kommunizieren.")