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

Al crear una acción personalizada, primero agregue contratos y luego agregue la configuración. La configuración define cómo la acción implementa los contratos. Para más información, ver Crea una acción personalizada y Agregar contratos a acciones personalizadas.

Nota: Puede modificar la configuración después de publicar la acción. Para más información, ver Modificar la configuración en acciones personalizadas.
  1. Haga clic en el Configuración pestaña. 
  2. Seleccione el método HTTP.
  3. Debajo Solicitud, configure la solicitud que la acción envía al servicio web. Genesys recomienda configurar la solicitud utilizando los campos debajo Sencillo.
    Propina: Haga clic en las propiedades debajo de Entradas disponibles para copiarlos y pegarlos rápidamente en la solicitud. Estas propiedades provienen de su contrato de entrada. Para más información, ver Agregar contratos a acciones personalizadas. Puede utilizar macros con las plantillas. Para más información, ver Macros de velocidad para acciones de datos.

    Ingrese información para los campos que aparecen. Los campos que aparecen varían según el método HTTP seleccionado y los contratos agregados.

    Notas:
    • Para las integraciones de acciones de datos de Adobe y AWS Lambda y Google Cloud Functions, consulte la Configuraciones de solicitud especial sección.
    • Los objetos JSON excesivamente anidados pueden afectar al rendimiento del servicio de acción de datos. Para mantener el rendimiento, la profundidad de los objetos JSON se limita a 50 niveles. Para obtener más información, consulte Limits en el Centro de desarrollo de Genesys Cloud.

    4. Configuración de solicitud especial

    La configuración de solicitud para acciones personalizadas que están asociadas con 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 clave-valor que se agregan a las acciones de datos en tiempo de ejecución para el manejo de la autenticación:

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

        Puede agregar un nombre de espacio aislado a las credenciales de integración o como encabezado en una acción. Si el nombre de la zona de pruebas se establece en ambos lugares, la integración utiliza el encabezado configurado en la acción de datos. Para más información, ver Agregar una integración de acciones de datos. 

    • Solicitar plantilla de URL

      Colocar Solicitar plantilla de URL al ARN de su función AWS Lambda. Para más información, ver Cree recursos de IAM para invocar funciones de AWS Lambda. 

    • tipo de solicitud

      Colocar Solicitud Escribe para CORREO. Este método HTTP garantiza que la acción envíe cualquier cuerpo de solicitud con la configuración de la solicitud.

    • Encabezados

      Pares clave-valor que se agregan a un personalizado mapa en el clientContext objeto. los clientContext el objeto es a su vez un valor en la invocación contexto objeto. Si existen los siguientes atributos, se establecen automáticamente en el contexto objeto:

      • ID-organización-ININ
      • ININ-Home-Organization-Id
      • ID de correlación ININ
      • ID de usuario ININ
      • ID de integración ININ

      Para un ejemplo de Java del clientContext objeto, ver Interfaz ClientContext. 

    • Solicitar plantilla

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

    • Solicitar plantilla de URL

      Colocar Solicitar plantilla de URL a la ubicación de Google Cloud Function que desea que ejecute la acción de datos: https://{location-of-function}-{project-owning-function}/{function-name}.

    • tipo de solicitud

      Colocar Solicitud Escribe para CORREO.

    • Solicitar plantilla

      Establezca Plantilla de solicitud a ${input.rawRequest}. 

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

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

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

  4. Debajo Respuesta, agregue la configuración JSON.

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

    Puede utilizar la 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 de velocidad para acciones de datos.

    Propina: Haga clic en las propiedades debajo de Salidas disponibles para copiarlos y pegarlos rápidamente en la respuesta. Estas propiedades provienen de su contrato de salida. Para más información, ver Agregar 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.

Próximo, prueba la acción por errores de validación y ejecución.

Para más información, ver Acerca de las acciones personalizadas para integraciones.

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