Ajouter une configuration aux actions personnalisées pour les intégrations

Remarque :  Cet article s'applique aux intégrations AWS Lambda, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, services web et actions de données Zendesk.

Lors de la création d’une action personnalisée, ajoutez d’abord des contrats, puis ajoutez la configuration. La configuration définit comment l'action met en œuvre les contrats. Pour plus d’informations, voir Testez les actions de données et Ajouter la configuration aux actions personnalisées.

Remarque :  Vous pouvez modifier la configuration après avoir publié l’action. Pour plus d’informations, voir Modifier la configuration dans les actions personnalisées.
  1. Cliquez sur onglet la Configuration. 
  2. Sélectionnez la méthode HTTP.
  3. Sous Demander, configurez la requête que l'action envoie au service Web. Genesysrecommande de configurer la demande en utilisant les champs sous simple.
    Astuce :   Cliquez sur les propriétés sous Entrées disponibles copier et coller rapidement dans la requête. Ces propriétés proviennent de votre contrat d’entrée. Pour plus d’informations, voir Ajouter des contrats à des actions personnalisées. Vous pouvez utiliser des macros avec les modèles. Pour plus d’informations, voir Macros Velocity pour les actions de données.

    Entrez des informations pour les champs qui apparaissent. Les champs qui apparaissent varient en fonction de la méthode HTTP sélectionnée et des contrats ajoutés.

    Remarques:
    • Pour les intégrations d'actions de données AWS Lambda et Google Cloud Functions, voir la section suivante Configurations de demandes spéciales.
    • Des objets JSON trop imbriqués peuvent affecter les performances du service d'action sur les données. Pour maintenir les performances, la profondeur des objets JSON est limitée à 50 niveaux. Pour plus d'informations, voir Limits dans le Genesys Cloud Developer Center.
  4. Modèle d'URL de demande

    mettre Modèle d’URL de demande à distance point de terminaison que votre demande HTTP frappe.

  5. En-têtes (facultatif)

    Paires de valeur clé qui sont ajoutées en tant point de terminaison qu’en-têtes HTTP sur la demande qui est envoyée à la télécommande.

    Remarque : Si vous définissez l'en-tête Accept, vous devez utiliser un type de média JSON comme valeur d'en-tête.

  6. Transfert Encodage

    Si votre service Web ne prend pas en charge Transfert-Encodage mis à en morceaux, ajouter Transfert-Encodage : tamponné sous en-têtes. Pour plus d’informations, voir L’action personnalisée échoue pour une raison inattendue.

  7. Autorisation

    Vous pouvez inclure des informations d’autorisation dans la configuration de la demande. Pour plus d’informations, voir Comment utiliser le type d’identification défini par l’utilisateur et Comment utiliser le type d’identification défini par l’utilisateur (OAuth).

  8. Configuration de demande spéciale

    La configuration de la demande pour les actions personnalisées associées aux intégrations d'actions de données Adobe ou AWS Lambda ou qui exécutent les fonctions Google Cloud diffère de la configuration de demande standard pour les services Web.

    • Modèle d'URL de demande

      mettre Modèle d’URL de demande à l’ARN de votre fonction AWS Lambda. Pour plus d’informations, voir Créer des ressources IAM pour invoquer les fonctions AWS Lambda

    • Type de demande

      Ensemble Demande Type à POSTER. Cette méthode HTTP garantit que l’action envoie n’importe quel organisme de demande avec la configuration de la demande.

    • En-têtes

      Paires clé-valeur ajoutées à un Douane carte sur le clientContext objet. Les clientContext l'objet est à son tour une valeur à l'invocation le contexte objet. Si les attributs suivants existent, ils sont automatiquement définis sur le le contexte objet:

      • ININ-ID-organisation
      • ININ-Home-Organization-Id
      • ID de corrélation ININ
      • ID d'utilisateur ININ
      • ID d'intégration ININ

      Pour un exemple Java du clientContext objet, voir Interface ClientContext

    • Modèle de demande

      Toutes les valeurs que vous spécifiez sous Modèle de demande sera disponible dans le événement paramètre de la fonction AWS Lambda invoquée.

    • Modèle d'URL de demande

      mettre Modèle d’URL de demande à distance point de terminaison que votre demande HTTP frappe.

    • Type de demande

      Ensemble Demande Type à POSTER. Cette méthode HTTP garantit que l’action envoie n’importe quel organisme de demande avec la configuration de la demande.

    • En-têtes

      Paires clé-valeur ajoutées à un Douane carte sur le clientContext objet. Les clientContext l'objet est à son tour une valeur à l'invocation le contexte objet. Si les attributs suivants existent, ils sont automatiquement définis sur le le contexte objet:

      • ININ-ID-organisation
      • ININ-Home-Organization-Id
      • ID de corrélation ININ
      • ID d'utilisateur ININ

      Pour un exemple Java du clientContext objet, voir Interface ClientContext

    • Modèle de demande

      Toutes les valeurs que vous spécifiez sous Request Template seront disponibles dans le paramètre event de la fonction AWS Lambda invoquée. Le site clientContext est limité en longueur et ne peut pas être utilisé pour transmettre les certificats requis pour les actions de données de Genesys Cloud Function. Pour inclure les certificats configurés dans les informations d'identification, utilisez le corps du modèle de demande qui n'a pas de restrictions de taille.

    • Modèle d'URL de demande

      Régler Modèle d'URL de demande à l'emplacement de la fonction Google Cloud que vous souhaitez que l'action de données exécute : https://{location-de-la-fonction}-{fonction-du-propriétaire-du-projet}/{nom-de-la-fonction}.

    • Type de demande

      Ensemble Demande Type à POSTER.

    • Modèle de demande

      Définir le modèle de demande à ${input.rawRequest}

    Pour une explication détaillée des parties de la demande, voir Configuration des demandes pour les actions de données.

    Les personnes bien informées sur JSON peuvent utiliser l’entrée option JSON. Utilisez les demandes dans d’autres actions ou l’exemple suivant comme guide pour créer le JSON.

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

  9. Sous Réponse, ajoutez la configuration JSON.

    La configuration JSON définit réponse la façon dont le service Web ou la fonction AWS Lambda est traité.

    Vous pouvez réponse utiliser l’exemple dans d’autres actions ou comme guide pour créer le JSON. Pour plus d’informations sur l’utilisation des macros avec le modèle de réussite, voir Macros de vitesse pour les actions de données.

    Astuce :   Cliquez sur les propriétés sous Sorties disponibles pour les copier et les réponse coller rapidement dans le. Ces propriétés proviennent de votre contrat de sortie. Pour plus d’informations, voir Ajouter des contrats à des actions personnalisées.
    {
          "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      }"
     }

    Pour une explication détaillée des réponse parties de la , voir Configuration de réponse pour les actions de données.

Ensuite, ajoute la fonction pour Genesys Cloud Function. Pour les autres actions sur les données, teste l'action pour détecter les erreurs de validation et d'exécution.

Pour plus d’informations, voir A propos des actions personnalisées pour les intégrations.

Pour plus d’informations sur l’intégration, voir À propos de l’intégration des actions de données Zendesk.