Agregar configuración a acciones personalizadas para integraciones

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.

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 AWS Lambda y Google Cloud Functions, consulte la siguiente sección Configuraciones de solicitudes especiales.
   • 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.
• Solicitar plantilla de URL

  Colocar Solicitar plantilla de URL al punto final remoto al que llega su solicitud HTTP.

• Encabezados (Opcional)

  Pares clave-valor que se agregan como encabezados HTTP en la solicitud que se envía al extremo remoto.

  Nota: Si está configurando el encabezado Aceptar, debe usar un tipo de medio JSON como valor del encabezado.

• Transferencia de codificación

  Si su servicio web no es compatible Codificación de transferencia ajustado a troceado, agregar Codificación de transferencia: amortiguado debajo encabezados. Para más información, ver La acción personalizada falla por un motivo inesperado.

• Autorización

  Puede incluir información de autorización en la configuración de la solicitud. Para más información, ver Cómo utilizar el tipo de credencial definido por el usuario y Cómo utilizar el tipo de credencial definida por el usuario (OAuth).

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.

• AWS Lambda
• Funciones de Google Cloud
• 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.

Usuarios avanzados (JSON)

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.