Agregar configuración a acciones personalizadas para integraciones

Nota: Este artículo se aplica a las integraciones de las acciones de datos de Adobe, AWS Lambda, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, servicios web y Zendesk.

Al crear una acción personalizada, añada primero contratos y luego agregue la configuración. La configuración define cómo la acción implementa los contratos. Para obtener más información, consulte Crear una acción personalizada y Añadir contratos a acciones personalizadas.

Nota: Puede modificar la configuración después de publicar la acción. Para obtener más información, consulte Modificar configuración en acciones personalizadas.
  • Haga clic en el botón Configuración tab. 
  • Seleccione el método HTTP.
  • Bajo Solicitud, configure la solicitud que la acción envía al servicio web. Genesys recomienda configurar la solicitud utilizando los campos de Simple.
    Consejo: Haga clic en las propiedades bajo Entradas disponibles para copiarlos y pegarlos rápidamente en la solicitud. Estas propiedades proceden de su contrato de entrada. Para obtener más información, consulte Añadir contratos a acciones personalizadas. Puede utilizar macros con las plantillas. Para obtener información, consulte Macros Velocity para acciones de datos.

    Introduzca información para los campos que aparecen. Los campos que aparecen varían según el método HTTP seleccionado y los contratos añadidos.

    Importante: Para las integraciones de acciones de datos de Adobe y AWS Lambda y las funciones de Google Cloud, consulte el Configuraciones de solicitudes especiales sección.

    Configuración de solicitud especial

    La configuración de solicitud para acciones personalizadas asociadas a las integraciones de acciones de datos de Adobe o AWS Lambda o que ejecutan las funciones de Google Cloud varían de la configuración de solicitud estándar para servicios web.

    • Encabezados

      Pares de valor clave que se añaden a las acciones de datos en tiempo de ejecución para autenticación manipulación:

      • x-api-clave
      • x-gw-ims-org-id
      • x-sandbox-name (si está configurado)

        Puede agregar un nombre de Sandbox a las credenciales de integración o como encabezado en una acción. Si el nombre de Sandbox se establece en ambos lugares, la integración utiliza el encabezado configurado en el acción de datos. Para obtener más información, consulte Añadir una integración de acciones de datos

    • Plantilla de URL de solicitud

      Establecer Plantilla de URL de solicitud al ARN de su función AWS Lambda. Para obtener más información, consulte Crear recursos IAM para invocar funciones AWS Lambda.

    • Tipo de solicitud

      Establecer Solicitud Tipo a PUBLICACIÓN. Este método HTTP garantiza que la acción envía cualquier cuerpo de solicitud con la configuración de solicitud.

    • Encabezados

      Pares de valor clave que se añaden a un personalizado mapa sobre el clientContexto objeto. El clientContexto el objeto está a su disposición en la invocación contexto objeto. Si existen los siguientes atributos, se establecen automáticamente en el contexto objeto:

      • ININ-Organization-Id
      • ININ-Home-Organization-Id
      • ININ-Correlation-Id
      • ININ-User-Id
      • ININ-Integration-Id

      Para un ejemplo de Java del clientContexto objeto, ver Interfaz ClientContext

    • Plantilla de solicitud

      Cualquier valor que especifique en Plantilla de solicitud estará disponible en el evento parámetro de la función AWS Lambda invocada.

    • Plantilla de URL de solicitud

      Establecer Plantilla de URL de solicitud al ubicación de la función de Google Cloud que desea que ejecute el acción de datos: https://cloudfunctions.googleapis.com/v1/projects/{project-owning-function}/locations/{ubicación-of-function}/functions/{function-name}:call

    • Tipo de solicitud

      Establecer Solicitud Tipo a PUBLICACIÓN.

    • Plantilla de solicitud

      Establecer Plantilla de solicitud a { \"datos\": \"$esc.jsonString(${input.rawRequest})\" }. El método de llamada de Google Cloud Function espera un atributo llamado datos que tiene el JSON de sus parámetros. $esc.jsonString() toma la solicitud sin procesar y la escapa correctamente para la función JSON. 

      Nota: Puede reemplazar ${input.rawRequest} con JSON adecuadamente formateado que se estingará.

    Para obtener una explicación detallada de las partes de la solicitud, consulte Solicitar configuración para acciones de datos.

    Las personas con conocimiento de JSON pueden utilizar la opción de entrada JSON. Utilice solicitudes en otras acciones o el siguiente ejemplo como guía para crear el JSON.

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

  • Bajo Respuesta, añadir la configuración JSON.

    La configuración JSON define cómo se procesa el respuesta del servicio web o la función AWS Lambda.

    Puede utilizar el respuesta en otras acciones o el siguiente ejemplo como guía para crear el JSON. Para obtener más información sobre el uso de macros con la plantilla de éxito, consulte Macros Velocity para acciones de datos.

    Consejo: Haga clic en las propiedades bajo Salidas disponibles para copiarlos y pegarlos rápidamente en el respuesta. Estos hoteles proceden de su contrato de salida. Para obtener más información, consulte Añadir contratos a acciones personalizadas.
    {
          "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      }"
     }

    Para obtener una explicación detallada de las partes de la respuesta, consulte Configuración de respuesta para acciones de datos.

A continuación, probar la acción para errores de validación y ejecución.

Para obtener más información, consulte Acerca de acciones personalizadas para integraciones.

Para obtener más información sobre las integraciones, consulte Acerca de las integraciones de acciones de datos.