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

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.

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.
• Modèle d'URL de demande

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

• 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.

• 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.

• 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).

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.

• AWS Lambda
• Fonctions Google Cloud
• 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

  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.

Utilisateurs avancés (JSON)

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}"
}

4. 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.

prochain tester l’action pour 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.