Konfigurieren Sie Anwendungen für mehrere Anbieter

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer
  • Sie können Anwendungen von mehreren Anbietern konfigurieren, um Anwendungsfälle zu unterstützen, in denen mehrere primäre Bots Virtual Agent-API verwenden, und Sie müssen zwischen ihnen unterscheiden.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Vergewissern Sie sich, dass Sie sich im Anwendungsbereich Virtual Agent-API befinden.

    Prozedur

    1. Navigieren zu Alle > sys_cs_provider_application.
    2. Klicken Sie auf Neu, um eine neue Anbieteranwendung zu erstellen.
    3. Füllen Sie die Felder des Formulars aus.
      Feld Beschreibung
      Name Name der Anbieteranwendung, z. B. VA API Custom Bot.
      Anbieter Wählen Sie als Anbieter VA-Bot-zu-Bot-Anbieteraus.
      Eingehende ID Eindeutige eingehende ID, die in der Anforderungsnachricht verwendet wird, z. B. custom_1.
      Nachrichtenauthentifizierung Konfigurieren Sie die Nachrichtenauthentifizierung mit einem Token für eingehende Kommunikation. Unter Konfigurieren Sie die Nachrichtenauthentifizierung für eingehende Kommunikation finden Sie weitere Details.
    4. Klicken Sie auf Absenden.
    5. Navigieren zu Alle > System-Webservices > REST-Nachricht.
    6. Klicken Sie auf Neu, um einen neuen REST-Nachrichtendatensatz zu erstellen.
    7. Füllen Sie die Formularfelder im REST-Nachrichtendatensatz aus.
      Feld Beschreibung
      Name Name des REST-Nachrichtendatensatzes. Dies sollte mit der neu erstellten Anbieteranwendung übereinstimmen.
      Endpunkt Der Antwortendpunkt des primären Bots.
    8. Klicken Sie auf Absenden.
    9. Klicken Sie im Abschnitt „HTTP-Methoden“ auf Neu, um eine neue Methode zu erstellen, oder überschreiben Sie die standardmäßige GET-Methode.
      Feld Beschreibung
      Name Name der HTTP-Methode. Geben Sie postMessageein.
      HTTP-Methode Wählen Sie POSTaus.
      Endpunkt Geben Sie den Antwortendpunkt des primären Bots ein.
      Authentifizierungstyp Konfigurieren Sie die Standard- oder OAuth 2.0-Authentifizierung entsprechend Ihren Anforderungen. Weitere Informationen zur Konfiguration der Standardauthentifizierung finden Sie unter REST-Nachricht mit Standardauthentifizierung konfigurieren. Informationen zur Konfiguration von OAuth 2.0 finden Sie unter REST-Nachricht mit OAuth konfigurieren.
    10. Um die neu erstellte Anbieteranwendung zu verwenden, übergeben Sie die eingehende ID der Anbieteranwendung im Parameter appInboundId der Anforderung Virtual Agent-API.
      Sie müssen die eingehende ID der Anbieteranwendung im Parameter appInboundId für jede Virtual Agent-API -Anforderung übergeben. Im Folgenden finden Sie eine Beispielanforderung Virtual Agent-API, die die neu erstellte Anbieteranwendung verwendet.
      
      {
          "userId": "adminuser1",
          "emailId": "admin@example.com",
          "action": "START_CONVERSATION",
          "message": {
              "text": "",
              "typed": true
          },
          "appInboundId": "custom_1",
          "contextVariables": {
              "app_name": "test"
          }
      }
      

      Sie können die Konfiguration testen, indem Sie sich die ausgehenden HTTP-Protokolle ansehen, um sicherzustellen, dass der Antwortendpunkt aufgerufen wurde.